mirror of
https://github.com/PDP-10/stacken.git
synced 2026-03-01 01:19:17 +00:00
202 lines
9.8 KiB
Plaintext
202 lines
9.8 KiB
Plaintext
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 <str:blk,str:blk,...>,<str:blk,str:blk,...>,...
|
|
|
|
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:(<str:blk,str:blk,...>,<str:blk,...>,...)
|
|
|
|
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.
|