Trailing-Edge
-
PDP-10 Archives
-
bb-d549g-sb
-
crscpy.hlp
There are 5 other files named crscpy.hlp in the archive. Click here to see a list.
Commands to CRSCPY are of the general form:
COMMAND argument
and are of three types, Action, Status setting, and Report or
Disposition 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.
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]
REPORT TTY: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.
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 or disposition selection commands/switches
The report or disposition selection commands are:
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.
MONVER n Process only those crashes which were running
the specified monitor version.
PRIMETIME Process only those crashes which occurred
during prime time (0800-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.
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 or disposition selection commands simply restrict the scope
of which entries in SYS:CRASH.SYS are processed by the REPORT or
DISPOSTION commands. They have no effect on any action command other
than REPORT or DISPOSITION. Any report or disposition selection
command may also be given as a switch on the REPORT or DISPOSITION
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 it's internal workings,
refer to CRSCPY.MEM and CRSCPY.DOC.