Google
 

Trailing-Edge - PDP-10 Archives - cuspbinsrc_1of2_bb-x128c-sb - 10,7/crscpy/crscpy.rnh
There are no other files named crscpy.rnh in the archive.
.;COPYRIGHT (c) DIGITAL EQUIPMENT CORPORATION 1985,1988. ALL RIGHTS RESERVED.

\\
.LM0;.RM70;.F;.J;.FLAG CAP;.SP1;.TS5
^COMMANDS TO <CRSCPY ARE OF THE GENERAL FORM:
.B 1
	<COMMAND ARGUMENT
.B 1
AND ARE OF THREE TYPES, ^ACTION, ^STATUS SETTING, AND ^REPORT,
^DISPOSITION OR ^MOVE SELECTION.
.B 2
1.#^ACTION COMMANDS
.B 1
^THE ACTION COMMANDS ARE:
.LM 24.I-24.TS 24.B 1
<CLEAR FILESPEC	^MARK THE SPECIFIED FILE AS HAVING BEEN PROCESSED SO THAT
<MONBTS CAN DUMP ON IT WITHOUT OPERATOR INTERVENTION.
.B.I-24
<COPY FILESPEC=FILESPEC	^COPY INPUT FILESPEC TO OUTPUT FILESPEC, MAKE A
LOG ENTRY, AND CLEAR THE UNPROCESSED DUMP BIT.
.B.I-24
<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.
.B.I-24
<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.
.B.I-24
<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.
.B.I-24
<REPORT FILESPEC	^GENERATE A REPORT ON THE SPECIFIED FILE OF
THE CONTENTS OF ^^SYS:CRASH.SYS\\.
.B1.LM 0.TS 5
^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:
.B1
	^^CLEAR SDL:CRASH.EXE[1,4]\\
.BR
	^^COPY STR:\\SSSNNN.^^EXE[10,1]=SDL:CRASH.EXE[1,4]\\
.BR
	^^MOVE DSK:\\INPUTFILENAME^^.EXE[10,1]=DSK:*.EXE[10,1]\\
.BR
	^^REPORT TTY:CRASH.LOG[-]\\ or ^^DSK:CRASH.LOG[-]\\
.B1
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.
.B1
^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\\.
.B2
2.#^STATUS SETTING COMMANDS
.B1
^THE STATUS SETTING COMMANDS ARE:
.LM 24.I-24.TS 24.B1
<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.
.B1.I-24
<STRUCTURE _<STR:BLK,STR:BLK,..._>,_<STR:BLK,STR:BLK,..._>,...
.B1
^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:
.LM5.TS 5.B 1
^^CRSCPY/STRUCTURE:(\\_<str:blk,str:blk,..._>,_<str:blk,..._>,...)
.LM0.TS 5.B1
^THE STATUS SELECTION COMMANDS SIMPLY SET FLAGS OR VALUES FOR USE
WHEN ONE OF THE ACTION COMMANDS IS TYPED.
.B2
3.#^REPORT, DISPOSITION, OR MOVE SELECTION COMMANDS/SWITCHES
.B1
^THE REPORT, DISPOSITION, OR MOVE  SELECTION COMMANDS ARE:
.B1.LM24.TS 24.I-24
<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.
.B1.I-24
<BEGIN DATE:TIME	^PROCESS ONLY THOSE CRASHES WHICH WERE DUMPED AFTER THE
SPECIFIED DATE AND TIME.
.B1.I-24
<CBEGIN DATE:TIME	^PROCESS ONLY THOSE CRASHES WHICH WERE COPIED AFTER
THE SPECIFIED DATE AND TIME.
.B1.I-24
<CEND DATE:TIME	^PROCESS ONLY THOSE CRASHES WHICH WERE COPIED BEFORE THE
SPECIFIED DATE AND TIME.
.B1.I-24
<DELETE	^DELETE THE CRASH FILE WHEN IT IS DISPOSED.  <NODELETE
IS THE COMPLEMENT AND THE DEFAULT IF NO VALUE IS SPECIFIED.
.B1.I-24
<DETAIL VALUE	^GENERATE REPORTS WITH MORE DETAIL THAN THE DEFAULT
REPORT.  ^LEGAL VALUES ARE <ALL AND <DISPOSITION.
.B1.I-24
<END DATE:TIME	^PROCESS ONLY THOSE CRASHES WHICH WERE DUMPED BEFORE THE SPECIFIED
DATE AND TIME.
.B1.I-24
<HEADER	^GIVE A HEADER LINE ON THE <REPORT COMMAND.  <NOHEADER IS
THE COMPLEMENT AND CAUSES THE HEADER TO BE SUPPRESSED.
.B1.I-24
<INACTIVE	^PROCESS ONLY THOSE CRASH DUMPS WHICH HAVE BEEN DELETED.
<NOINACTIVE RESTRICTS THE COMMAND TO THE CRASHES WHICH HAVEN'T BEEN DELETED YET.
.B1.I-24
<MONVER N	^PROCESS ONLY THOSE CRASHES WHICH WERE RUNNING THE SPECIFIED
MONITOR VERSION.
.B1.I-24
<PRIMETIME	^PROCESS ONLY THOSE CRASHES WHICH OCCURRED DURING
PRIME TIME (WEEKDAYS BETWEEN 0800 AND 1700).
.B1.I-24
<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.
.B1.I-24
<STOPCD XXX	^PROCESS ONLY THOSE CRASHES WHICH OCCURRED BECAUSE OF
THE SPECIFIED <STOPCD.
XXX MAY CONTAIN THE WILDCARD CHARACTERS "?" OR "*".
.B1.I-24
<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.
.B1.I-24
<UNDISPOSED	^PROCESS ONLY THOSE CRASHES WHICH HAVE NOT YET BEEN
DISPOSED.  <NOUNDISPOSED RESTRICTS THE COMMAND TO THOSE CRASHES WHICH HAVE
ALREADY BEEN DISPOSED.
.B1.TS 5.LM 0
^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.
.B2
^ANY NON-ACTION COMMAND MAY BE SPECIFIED IN <SWITCH.INI WITH A LINE
OF THE FORM:
.B1
	^^CRSCPY/COMMAND:\\ARGUMENT
.B2
^FOR MORE INFORMATION ON <CRSCPY COMMANDS AND ITS INTERNAL WORKINGS,
REFER TO <CRSCPY.MEM AND <CRSCPY.DOC.