There are 3 other files named crscpy.doc in the archive. Click here to see a list.
CRSCPY -- Program to copy crashes, version 1A -- October 1985 Page 1
COPYRIGHT (c) DIGITAL EQUIPMENT CORPORATION
ALL RIGHTS RESERVED.
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE INCLUSION
OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER COPIES
THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY OTHER
PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE AND
SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
CRSCPY -- Program to copy crashes, version 1A -- October 1985 Page 2
The TOPS-10 bootstrap (BOOT) has the capability of performing very fast
dumps and loads. 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 you may use to help
you 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 you may wish to write to tailor the copy procedure
to your installation. Every installation will have varying needs and
procedures with regard to crash copying, and may indeed already have
some form of semi-automatic procedure to copy crashes. Therefore, it is
not expected that CRSCPY will be used without change by each
The DIGITAL-supplied prototype supports automatic 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. Refer to
CRSCPY.HLP and the TOPS-10 Crash Analysis Guide for more detailed
information about the operation of the program and the interface with
CRSCPY has been tested on KL10 and KS10 processors under the 7.02,
7.02/Autopatch, and 7.03 versions of the monitor.
2.0 EXTERNAL CHANGES
There are a couple of changes that affect the REPORT command.
2.1 Crash Flag "R"
In a REPORT display, immediately following the crash sequence number,
are a number of flags that indicate the "state" of the crash (active,
undisposed, etc.). There is the addition of the "R" flag. It indicates
the crash in question caused a reload.
2.2 /PRIMETIME Switch
Previous version of CRSCPY treated prime time as 0800 to 1700, seven
days a week. CRSCPY now excludes weekends.
CRSCPY -- Program to copy crashes, version 1A -- October 1985 Page 3
2.3 /SUMMARY Switch
A new REPORT switch causes a summary to be appended to the end of the
REPORT display. This switch takes three optional arguments.
"STOPCODES" causes a summary by stopcode names to appear. "TOTALS"
causes a summary line that indicates the number of crashes, those
active, undisposed, reloads, and the total number of crashes on disk.
"ALL" causes both stopcodes and totals to appear at the end of the
REPORT display. If no argument is given to the /SUMMARY switch, "ALL"
2.4 /MONVER Switch
The /MONVER switch now ignores all but the DEC monitor/load number.
This is because the LH of %CNVER is reserved to customers, some of whom
use it for different information.
2.5 /STOPCD Switch
The /STOPCD switch argument may now be wildcarded with the traditional
"*" and "?" wildcard characters.
3.0 KNOWN BUGS AND DEFICIENCIES
4.0 INSTALLATION INSTRUCTIONS
CRSCPY searches JOBDAT, MACTEN, SCNMAC, and UUOSYM and loads with SCAN
5.0 INTERNAL CHANGES
Refer to the revision history in CRSCPY.MAC.
Provide a way to check that all entries in SYS:CRASH.SYS are still on
disk, and/or determine which files of ALL:*.EXE[10,1] are not in
Add a PURGE command to purge the first n disposed entries. the
following FORTRAN program purges the first n entries regardless of the
CRSCPY -- Program to copy crashes, version 1A -- October 1985 Page 4
* Program to purge the first n entries in CRASH.SYS if it starts to
* get large but you don't want to do a PURGE FILE command to CRSCPY
* becuase you want to save the last part of the file. This may be an
* option in CRSCPY someday.
IMPLICIT INTEGER (A-Z)
PARAMETER NEWLEN=46 ! Size of each entry
IF (CHCNT .GT. 0) GOTO 1000
DO 2000 I=1,NUMBER
DO 3000 I=1,CHCNT
10 FORMAT(' Number of entries to purge: ',$)
30 FORMAT(' ?Not that many in the file')
[End of CRSCPY.DOC]