Commands to CRSCPY are of the general form: COMMAND argument and are of three types, Action, Status setting, and Report, Disposition or Move selection. 1. Action commands The action commands are: CLEAR filespec Mark the specified file as having been processed so that MONBTS can dump on it without operator intervention. COPY filespec=filespec Copy input filespec to output filespec, make a log entry, and clear the unprocessed dump bit. DISPOSTION filespec Give a one line disposition of the crash(s) specified by filespec after the crash is analyzed. Note that filespec is the one stored in CRASH.SYS by the COPY command. Both the filename and extension may be wildcarded and a device of DSK:, ALL:, or XPN: will match any entry. It is much more efficient to dispose using a command of the form DISPOSITION/SEQUENCE:nn since the sequence number allows CRSCPY to index directly into CRASH.SYS. MOVE filespec=filespec Move the crash specified by the input filespec to the output filespec and update the entry in CRASH.SYS to reflect the new location of the crash file. Note that the input filespec is the one stored in CRASH.SYS by the COPY command. The filename may be wildcarded and a device of DSK:, ALL:, or XPN: will match any entry. It is much more efficient to move crashes using a command of the form MOVE filespec=filespec/SEQUENCE:nn:mm since the sequence number allows CRSCPY to index directly into CRASH.SYS. Note that if none of [NO]UNDISPOSED, [NO]INACTIVE, or [NO]ACTIVE is specified, the default for this command is /NOINACTIVE. CRSCPY preserves the creation date/time, the access date, the data mode, the protection (if no /PROTECTION switch was specified), the version number and the spooled name of the input file when it moves it. PURGE FILE Delete the contents of SYS:CRASH.SYS but retain the header so that the crash sequence numbers do not start at 1. The use of this command is prefered to simply deleting the file for this reason. The argument "FILE" is required to insure that the user does not type the command by accident. REPORT filespec Generate a report on the specified file of the contents of SYS:CRASH.SYS. The action commands cause something to happen as opposed to setting a flag or value for later processing. All action commands except the DISPOSITION command will fully default the arguments if they are omitted. Defaults are as follows: CLEAR SDL:CRASH.EXE[1,4] COPY STR:sssnnn.EXE[10,1]=SDL:CRASH.EXE[1,4] MOVE DSK:inputfilename.EXE[10,1]=DSK:*.EXE[10,1] REPORT TTY:CRASH.LOG[-] or DSK:CRASH.LOG[-] where SDL: is all structures in the system dump list, STR: is the structure with the most free space selected from the STRUCTURE command, sss is the STOPCD name, and nnn is a sequence number obtained from the header of SYS:CRASH.SYS and incremented each time a dump is copied. The default output file for the REPORT command is the terminal only if no part of a file specification is typed (including per-file switches such as /PROTECTION). Otherwise, it will default to DSK:CRASH.LOG. 2. Status setting commands The status setting commands are: INFORM name Select destination of all output. Legal values of name are USER and OPR. USER is the default if CRSCPY is run manually, OPR is the default if CRSCPY is run by the system. STRUCTURE ,,... Select the structures to which CRSCPY will copy crashes if no output structure is specified in the COPY command or if it is run by the system. str is the name of a structure and blk is the number of blocks which must remain on the structure after the copy in order for CRSCPY to copy a crash to that structure. The angle brackets group structures into sets. CRSCPY will copy a crash to the structure in a set which meets the block restrictions and will contain the most space after the copy. If no structures in a set meet the restrictions, CRSCPY goes on to the next set. This command usually appears in SWITCH.INI with a line of the form: CRSCPY/STRUCTURE:(,,...) The status selection commands simply set flags or values for use when one of the action commands is typed. 3. Report, disposition, or move selection commands/switches The report, disposition, or move selection commands are: ACTIVE Process only those crashes which have been disposed, but not deleted. NOACTIVE restricts the command to those crashes which have either not been disposed, or those which have been both disposed and deleted. BEGIN date:time Process only those crashes which were dumped after the specified date and time. CBEGIN date:time Process only those crashes which were copied after the specified date and time. CEND date:time Process only those crashes which were copied before the specified date and time. DELETE Delete the crash file when it is disposed. NODELETE is the complement and the default if no value is specified. DETAIL value Generate reports with more detail than the default report. Legal values are ALL and DISPOSITION. END date:time Process only those crashes which were dumped before the specified date and time. HEADER Give a header line on the REPORT command. NOHEADER is the complement and causes the header to be suppressed. INACTIVE Process only those crash dumps which have been deleted. NOINACTIVE restricts the command to the crashes which haven't been deleted yet. MONVER n Process only those crashes which were running the specified monitor version. PRIMETIME Process only those crashes which occurred during prime time (weekdays between 0800 and 1700). SEQUENCE m:n Process only those crashes with sequence numbers between m and n, inclusive. If only one number is specified it is taken to be both the lower and upper bounds. STOPCD xxx Process only those crashes which occurred because of the specified STOPCD. xxx may contain the wildcard characters "?" or "*". SUMMARY value Produce a summary at the end of the report listing according to the given keyword. keywords are ALL to include both a summary by stopcode name and totals, STOPCODES to include just the stopcode name summary, and TOTALS to include just the total number of undisposed, active, and reload stopcodes. UNDISPOSED Process only those crashes which have not yet been disposed. NOUNDISPOSED restricts the command to those crashes which have already been disposed. The report, disposition, or move selection commands simply restrict the scope of which entries in SYS:CRASH.SYS are processed by the REPORT, DISPOSTION, or MOVE commands. They have no effect on any action command other than REPORT, DISPOSITION, or MOVE. Any report or disposition selection command may also be given as a switch on the REPORT, DISPOSITION, or MOVE commands. If this is done, the switch only applies to this command and any sticky defaults specified will apply to the next command. Any non-action command may be specified in SWITCH.INI with a line of the form: CRSCPY/COMMAND:argument For more information on CRSCPY commands and its internal workings, refer to CRSCPY.MEM and CRSCPY.DOC.