Trailing-Edge
-
PDP-10 Archives
-
bb-d549g-sb
-
crscpy.mem
There are 3 other files named crscpy.mem in the archive. Click here to see a list.
CRSCPY
Program For Automatically Copying Crashes
Date: May 1980
File: CRSCPY.RNO
Version: 1
The information in this document is subject to change without notice
and should not be construed as a commitment by Digital Equipment
Corporation. Digital Equipment Corporation assumes no responsibility
for any errors that may appear in this document.
The software described in this document is furnished under a license
and may be used and copied only in accordance with the terms of such
license.
Digital Equipment Corporation assumes no responsibility for the use
and reliability of its software on equipment that is not supplied by
Digital.
Copyright (C) 1979,1980 Digital Equipment Corp., Maynard, Mass.
CRSCPY - Program For Automatically Copying Crashes Page 2
INTRODUCTION
1.0 INTRODUCTION
The 7.01 monitor includes a fast monitor resident bootstrap (MONBTS)
which has the capability of very fast dump/reload, and continuable
STOPCD dump. In addition, the monitor provides a mechanism to
automatically start up a program which will copy the dump(s) just
taken. CRSCPY is an example of a program which can be run to do this.
CRSCPY, as described in this document, is a prototype that an
installation may use to help in understanding the monitor interface
and the tasks that must be performed by such a program. CRSCPY is
being supplied to serve as a basis for the program that an
installation may wish to write to tailor the copy mechanism to local
procedures. Every installation will have varying needs and procedures
with regard to crash copying, and may indeed already have some form of
semi-automatic mechanism to copy crashes. Therefore, it is not
expected that CRSCPY will be used without change. The
Digital-supplied prototype supports automatic crash copy of crashes
when invoked by the monitor, manual copy of crashes when run by an
operator, and a log and report feature of the crashes that it copied.
2.0 RUNNING THE PROGRAM
The monitor automatically runs the crash copy program from device SYS:
when a continuable STOPCD dump is taken or when the monitor is
reloaded. By default the name of the crash copy program is CRSCPY.
This default may be changed by defining the symbol CPYNAM to be the
SIXBIT name of the program to run in the SIXBIT symbol definitions in
the HDWCNF MONGEN dialog.
CRSCPY may also be run manually to copy crashes or to perform one of
its other functions. To perform most functions, CRSCPY must be run
while logged into [1,2].
3.0 COMMAND SYNTAX
Commands to CRSCPY are of the general form:
COMMAND argument
and are of three types, Action, Status setting, and Report or
Disposition selection. Action commands cause something to happen
immediately as opposed to storing a value or setting a flag for later
processing. Action commands include CLEAR, COPY, DISPOSITION, PURGE,
CRSCPY - Program For Automatically Copying Crashes Page 3
COMMAND SYNTAX
and REPORT. Status setting commands set flags or store values
directing the action of one of the action commands. Status setting
commands include INFORM and STRUCTURE. Report or disposition
selection commands restrict the entries processed by the REPORT or
DISPOSITION commands to the subset of the crashes that meet all
criteria and restrictions. The report or disposition selection
commands only have effect on the REPORT and DISPOSITION commands and
include BEGIN, CBEGIN, CEND, DELETE, DETAIL, END, HEADER, MONVER,
PRIMETIME, SEQUENCE, STOPCD, and UNDISPOSED. Each command is
described separately below.
4.0 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. The use of
this command is not usually required since the
COPY command marks the crash file as having
been copied when it finishes the copy. It may
be useful after stand alone time or
preventative maintenance to insure that no
stale dumps are present.
COPY filespec=filespec Copy input filespec to output filespec, make a
log entry in SYS:CRASH.SYS, and clear the
unprocessed dump bit in the file being copied
so that MONBTS can dump on it without operator
intervention. If only one filespec is typed,
it is used as the filespec of the file to
copy.
DISPOSITION filespec Give a disposition for the crash or crashes
specified by filespec. Filespec is the name
of the crash file or files as specified in
SYS:CRASH.SYS. Both filename and extension
may be wildcarded and DSK:, ALL:, and XPN:,
when specified as a device in the command,
will match any device in an entry. The
disposition is a one line description of what
caused the crash and is given after the crash
is analyzed. The disposition may be printed
with the REPORT command using the
DETAIL:DISPOSITION switch or command. The
crashes disposed by this command may be
further restriced by using one or more of the
report or disposition commands described
below. Note that it is much more efficient to
CRSCPY - Program For Automatically Copying Crashes Page 4
ACTION COMMANDS
dispose a crash by sequence number via a
DISPOSITION/SEQUENCE:nn command since this
allows CRSCPY to directly index into
CRASH.SYS. If no /SEQUENCE switch is
specified, CRSCPY must make a linear scan of
the file.
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 contents of
this report may be restricted by using one or
more of the report or disposition selection
commands described below.
5.0 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 and causes
output to go to the users terminal. OPR is
the default if CRSCPY is run by the system and
causes output to go to device OPR:. This
command should not be used in normal
operation.
STRUCTURE <str:blk,str:blk,...>,<str:blk,str:blk,...>,...
Select the structure 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 that structure after the copy is completed.
CRSCPY will not copy a crash to a structure
unless it meets this minimum block
restriction. The angle brackets group
structures into sets. CRSCPY scans the sets
from left to right and will select a structure
from the first set which meets all
restrictions. Within each set, CRSCPY will
CRSCPY - Program For Automatically Copying Crashes Page 5
STATUS SETTING COMMANDS
select the structure which meets the minimum
block restrictions and will contain the most
space after the copy. This command usually
appears in SWITCH.INI with a line of the form:
CRSCPY/STRUCTURE:(<str:blk,str:blk,...>,<str:blk,...>,...)
and allows the system administrator to specify
to which structures crashes may be copied if
not explicitly overridden by the operator.
Note that since CRSCPY runs logged out ([2,5])
when run by the system, the SWITCH.INI
containing the STRUCTURE command must be
placed in [2,5].
6.0 REPORT OR DISPOSITION SELECTION COMMANDS
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 after it has been
disposed. NODELETE is the complement and the
default if no switch is specified.
DETAIL value Give more detail than that given by the normal
report. Legal arguments are ALL which gives a
full report, and DISPOSITION which gives only
the disposition, if any.
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. The argument
to this command is the version number from the
monitor location MONVER, not that contained in
.JBVER.
CRSCPY - Program For Automatically Copying Crashes Page 6
REPORT OR DISPOSITION SELECTION COMMANDS
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 bound.
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 is the complement
and restricts processing to those crashes
which have been disposed.
The report or disposition selection commands may also appear as
switches on the REPORT or DISPOSITION command line, e.g.,
CRSCPY>REPORT/BEGIN:TODAY
CRSCPY>DISPOSITION/SEQUENCE:14:20
If used in this manner, the value applies only to this command.
Subsequent commands will continue to use any sticky defaults specified
by report or disposition selection commands. Local switches override
any sticky defaults.
7.0 MONITOR INTERFACE
When the monitor takes a continuable STOPCD dump or is reloaded, it
starts the crash copy program using the FRCLIN mechanism (see MCOs
8546, 8809, 8845, 8852, and 8868). The program which is to copy the
crash(es) is run logged out but with the JACCT privilege. It must
determine that is was run on FRCLIN (see MCO 8852 and GETTAB %CNFLN)
and detach itself as soon as possible so that FRCLIN may be used
again. It must determine which, if any, structures contain dumps
which have not been copied, copy then, and then clear the bit in the
RIB (RIPDMP in RIBSTS) which tells MONBTS that the file contains an
unprocessed dump. When all dumps have been copied, it must then issue
a LOGOUT UUO.
CRSCPY - Program For Automatically Copying Crashes Page 7
ALGORITHMS USED BY CRSCPY
8.0 ALGORITHMS USED BY CRSCPY
CRSCPY determines whether or not it was run on FRCLIN by comparing the
results of a GETLCH for its line with the result of doing a GETTAB for
%CNFLN. If it is running on FRCLIN, it detaches itself immediatly.
If it is not running on FRCLIN, CRSCPY will conditionally clear JACCT.
If the symbol DFTPPN is defined, FILDAE is not running, and CRSCPY is
running under the PPN given by DFTPPN, JACCT will not be cleared.
This is used during field test to allow DEC to dispose crashes in
CRASH.SYS from the PPN assigned to DEC by the field test site (usually
[10,1]). DFTPPN should be set to zero if the site is not in field
test or if they run FILDAE.
When processing the DISPOSITION command, CRSCPY starts with the entry
specified by the lower bound to the /SEQUENCE switch by indexing
directly into the file with USETI and USETO. If no /SEQUENCE switch
was specified, CRSCPY must start at the beginning of the file and do a
linear scan until it finds an entry matching the restrictions. It is
much more efficient to specify at least a ball-park lower bound via
/SEQUENCE to avoid having to search the entire file. This is
especially important if CRASH.SYS is large.
CRSCPY finds unprocessed dumps to copy by finding the name of each
structure in the system with SYSSTR, doing a DSKCHR on that structure
to determine if it is in the system dump list and then looking up
CRASH.EXE[1,4] to see if RIBDMP is set in RIBSTS. It will not
automatically copy crashes which are dumped on structures which are
not in the system dump list.
When CRSCPY copies a crash file, it copies the lesser of the file size
as specified by .RBSIZ or the size of the crash as specified by the
.EXE directory. This means that no space is wasted in copying blocks
that do not contain dumped information. CRSCPY does this by reading
in the .EXE directory and computing the size of the dump from the last
pointer. Note that this computed size is used in the selection of the
output structure as described below.
CRSCPY selects an output structure by finding a structure in one of
the sets specified in the STRUCTURE command/switch which meets the
minimum block restrictions and which will contain the most space of
any structure in the set after the copy is done. If no structure is
found in a set which meets the block restrictions, CRSCPY goes on to
the next set. If effect, CRSCPY will load balance copied crashes
across structures in the same set and will go to the next set if and
only if it rejects all structures in the current set. This scheme
allows great flexibility in specifying where crashes are to be copied.
If no STRUCTURE command/switch was specified, device XPN is used. The
STRUCTURE command/switch is usually specified with a line in
SWITCH.INI of the form:
CRSCPY/STRUCTURE:(<str:blk,str:blk,...>,<str:blk,...>,...)
CRSCPY is assembled to accept up to four sets with up to twenty
CRSCPY - Program For Automatically Copying Crashes Page 8
ALGORITHMS USED BY CRSCPY
structures in all sets. These defaults may be adjusted by changing
parameters .MXSET, and .MXSTR.
When run on FRCLIN, CRSCPY sets its job search list to be the first
two (assembly parameter, see .SLSTR) structures in the system search
list. Therefore, the SWITCH.INI should be placed on one of these
structures in [2,5] since it runs logged out. This will be necessary
until SCAN can be taught to read the system wide options file
(INI:SWITCH.INI) with some future release.
CRSCPY selects an output filename by appending the 3 character STOPCD
name with a 3 digit sequence number obtained from the header of the
log file, SYS:CRASH.SYS, e.g., EUE123. If no STOPCD occurred, SER is
used.
CRSCPY clears the unprocessed dump bit in the RIB by calling CLRBIT.
Installations that have their own crash copy programs should install
this routine in their programs and call it when a crash is copied.
CLRBIT works by doing a USETI 0 and reading in the RIB of the crash
file, doing a DSKCHR on the channel on which the crash file is open to
get the physical unit name containing the RIB, opening that unit, and
doing a super USETO and OUTPUT to rewrite the RIB. If this routine is
not called, MONBTS will not dump on this file without operator
intervention.