Trailing-Edge
-
PDP-10 Archives
-
ap-c796e-sb
-
backup.rnh
There are 11 other files named backup.rnh in the archive. Click here to see a list.
\\
.FLAG CAPITAL
^COMMANDS TO <BACKUP ARE IN THE FORM OF VERBS. <BACKUP PROMPTS
WITH A "/", and has
THREE KINDS OF VERBS:
.skip 1
.indent 5
1.##^action
.skip 1
.indent 5
2.##^status setting
.skip 1
.indent 5
3.##^tape positioning.
.sk 1
.SKIP 1
^THE ACTION VERBS ARE:
.SK1
.TAB STOPS 24
. ;<SAVE SPEC-LIST SAVE THE SPECIFIED DISK FILES ON TAPE
. ;<RESTORE SPEC-LIST RESTORE THE SPECIFIED FILES FROM TAPE TO DISK
. ;<CHECK SPEC-LIST VERIFY THAT THE DISK AND TAPE FILES AGREE
. ;<[N]PRINT SPEC PRINT A DIRECTORY OF THE ENTIRE TAPE ON SPEC
.SKIP 1
^THE ACTION VERBS PERFORM <I/O AND OPERATE ON THE TAPE
SPECIFIED BY THE LAST <TAPE VERB (ONE OF THE STATUS SETTING VERBS).
^A TAPE MUST BE SPECIFIED BEFORE USING ANY OF THE ACTION COMMANDS.
.SKIP 1
^THE ACTION COMMANDS TAKE AS AN OPTIONAL ARGUMENT A LIST OF FILE
SPECIFICATIONS IN THE STANDARD FORMAT OF DEV:FILENAME.EXT[DIRECTORIES].
^THE FILE SPECIFICATIONS MAY HAVE WILD CARDS. ^THE USER MAY SPECIFY
BOTH AN INPUT AND AN OUTPUT SIDE (OUTPUT=INPUT) OR JUST THE INPUT
FILE SPEC. ^THIS ALLOWS FILES TO BE RENAMED AS THEY ARE SAVED OR
RESTORED. ^FILE SPEC ENTRIES IN THE LIST ARE SEPARATED BY COMMAS.
.SKIP 1
^IF NO ARGUMENT IS SUPPLIED WITH AN ACTION COMMAND <BACKUP WILL
DEFAULT A FILE SPEC IN THE FOLLOWING WAY. ^THE DEFAULT FILE SPEC FOR THE
OPERATOR IS <ALL:*.*[*,*,*,*,*,*]. ^THIS SPECIFIES
ALL FILES ON ALL ^^UFD\\S AND ALL ^^SFD\\S OF ALL FILE STRUCTURES WITH
NO RENAMING.
.SKIP 1
^FOR A USER NOT LOGGED IN UNDER [1,2] THE DEFAULT FOR THE <SAVE VERB
IS <DSK:*.*[<PPN,*,*,*,*,*]. ^FOR A USER DOING A <RESTORE, THE DEFAULT IS TO TRANSFER THE USER'S FILES ON TAPE TO THE USER'S DISK
AREA; SO THE DEFAULT SPEC IS <DSK:*.*[<PPN,*,*,*,*,*] = <ALL:*.*[<PPN,*,*,*,*,*]. ^THE <CHECK VERB DEFAULT IS THE SAME AS THAT FOR <RESTORE.
.SKIP 1
^THE ARGUMENT FOR THE <PRINT VERB IS A SINGLE FILE SPEC.
^IT'S DEFAULT IS <LPT:BACKUP.LOG.
.SKIP 1
^NOTE THAT SPECIFYING ANY OF THE FILE SPEC FIELDS OVERLAYS ONLY
THAT FIELD AND LEAVES THE REST OF THE SPEC DEFAULTS WITHSTANDING.
^UNDER NO CIRCUMSTANCES DO THE FILE SPEC FIELDS BECOME "STICKY"
PARAMETERS, E.G. SPECIFYING THE <PPN FOR ONE SPEC DOES
<NOT CARRY OVER TO THE NEXT SPEC IN THE LIST.
.SK2
^THE STATUS SETTING COMMANDS SET A PARAMETER
WHICH AFFECTS FUTURE ACTION COMMANDS. ^ONCE A STATUS PARAMETER IS SET,
IT REMAINS IN EFFECT UNTIL CHANGED BY THE USER. ^THE FORMAT FOR
DATE/TIME ARGUMENTS IS <DD-MMM-YY:HH:MM:SS. ^THE STATUS SETTING
COMMANDS ARE:
.SK1
.TAB STOPS 24
. ;<ABEFORE DATE INCLUDE ONLY FILES ACCESSED BEFORE DATE
. ;<[NO]APPEND APPEND TO LOG FILE (DEFAULT)
. ;<ASINCE DATE INCLUDE ONLY FILES ACCESSED SINCE DATE
. ;<BEFORE DATE-TIME INCLUDE ONLY FILES LAST CREATED OR MODIFIED
. ; BEFORE DATE-TIME
. ;<CPOINT USE CHECKPOINTING
. ;<[NO]DATE75 ALWAYS ACCEPT FILES WITH POSSIBLE <DATE75
. ; problems (DEFAULT)
. ;<DELETE DELETE DISK FILES AFTER SAVING THEM
. ;<DENSITY (200,556,800,1600) SET TAPE DENSITY
. ;<[NO]DIRECTORIES TYPE EACH DIRECTORY WHILE RUNNING (DEFAULT)
. ;<[NO]ENCRYPTION ENCRYPT THE MAG TAPE (ASKS FOR KEY LATER;
. ; A KEY IS SIMILAR TO A PASSWORD AND MAY HAVE
. ; UP TO 30 CHARACTERS)
. ;<[NO]EXEMPT EXEMPT <PPNS OF THE FORM [^A,*] AND
. ; [10,^B] WHERE ^A AND ^B <.LE. 7 FROM
. ; DATE/TIME AND LENGTH RESTRICTIONS (DEFAULT)
. ;<[NO]FILES TYPE EACH FILE NAME WHILE RUNNING
. ;<INITIAL SPEC START PROCESSING AT SPEC
. ;<[NO]INTERCHANGE RUN IN INTERCHANGE MODE (IGNORE SYSTEM DEPENDENT
. ; DATA)
. ;<LENGTH L:H INCLUDE ONLY FILES WHOSE LENGTH IS BETWEEN L, H
. ;<[N]LIST SPEC WHILE RUNNING, MAKE A LISTING ON SPEC
. ; (default SPEC is ^^LPT:BACKUP.LOG\\)
. ;<MBEFORE DATE-TIME INCLUDE ONLY FILES MOVED BEFORE DATE-TIME
. ;<MESSAGE <[NO]PREFIX SUPPRESS ERROR MESSAGE PREFIX
. ;<MESSAGE <[NO]FIRST SUPPRESS ERROR MESSAGE FIRST TEXT LINE
. ;<MSINCE DATE-TIME INCLUDE ONLY FILES MOVED SINCE DATE-TIME
. ;<[NO]MULTIREEL ALLOW MULTIPLE REELS ON SAVE (DEFAULT)
. ; (MULTIPLE REELS ON A RESTORE ARE ALWAYS
. ; PERMITTED)
. ;<OPTION NAME USE OPTION ^^BACKUP\\:NAME FROM <SWITCH.INI
. ;<PARITY (EVEN,ODD) SET TAPE PARITY
. ;<RESUME ^N START AT BLOCK ^N OF INITIAL FILE
. ;<SILENCE SUPPRESS DIRECTORY AND FILE NAME TYPEOUT
. ; WHILE RUNNING
. ;<SINCE DATE-TIME INCLUDE ONLY FILES CREATED OR MODIFIED
. ; SINCE DATE-TIME
. ;<SORT <DIRECTORY X SORT DIRECTORIES WITHIN EACH FILE STRUCTURE
. ; IN ORDER X WHEN SAVING
. ;<SORT <FILES X SORT FILES WITHIN EACH DIRECTORY IN ORDER X
. ; WHEN SAVING
. ; ##X=<ALPHABETICAL, <LOCATION, OR <NONE
. ;<SSNAME A SAVE-SET NAME IS A (UP TO 30 CHARS; USE QUOTES
. ; TO INCLUDE NON-ALPHABETICS; <ALL<=ALL SAVE SETS
. ; ON TAPE)
. ;<SUPERSEDE <ALWAYS ALWAYS RESTORE FILE FROM TAPE
. ;<SUPERSEDE <NEVER RESTORE FILE FROM TAPE UNLESS ALREADY ON DISK
. ;<SUPERSEDE <OLDER RESTORE FROM TAPE IF DISK FILE IS OLDER
. ; (DEFAULT)
. ;<TAPE <MTAX USE TAPE UNIT <MTAX
. ;<UPROTECTION <NNN SET PROTECTION OF ALL CREATED DIRECTORIES
. ;<[NO]USETI USE SUPER-<USETI (FASTER SAVES WITH </SINCE,#ETC.)
. ;<[NO]WRITE SUPPRESS DISK WRITING DURING A <RESTORE
.SK 2
^^BACKUP\\'S TAPE POSITIONING COMMANDS TAKE IMMEDIATE EFFECT. ^THEY
TAKE A LIST OF TAPES AS AN ARGUMENT. ^IF NO TAPE IS SPECIFIED
for a given command, THE LAST TAPE DECLARED WITH THE
<TAPE VERB IS POSITIONED. ^THE TAPE POSITIONING COMMANDS ARE:
.SK 1
.TAB STOPS 24
. ;<EOT TAPE-LIST SKIP TO END OF TAPE
. ;<REWIND TAPE-LIST REWIND TO BEGINNING OF TAPE
. ;<SKIP ^N TAPE-LIST SKIP ^N SAVE SETS FORWARD
. ;<SKIP 0 TAPE-LIST BACKUP TO START OF CURRENT SAVE SET
. ;<SKIP -^N TAPE-LIST SKIP ^N SAVE SETS BACKWARD
. ;<UNLOAD TAPE-LIST UNLOAD TAPE FROM DRIVE
.SK 2
^SWITCHES WHICH MAY BE INCLUDED WITHIN THE FILE SPECIFICATION
LIST FOR THE ACTION VERBS ARE:
.SK 1
.ts 22,32
. ;<ABEFORE DATE (INPUT) INCLUDE FILE ONLY IF ACCESSED BEFORE
. ; DATE
. ;<ASINCE DATE (INPUT) INCLUDE FILE ONLY IF ACCESSED SINCE DATE
. ;<BEFORE DATE-TIME (INPUT) INCLUDE ONLY IF LAST CREATED OR MODIFIED
. ; BEFORE DATE-TIME
. ;<ERNONE (INPUT) GIVE ERROR IF NO FILES MATCH
. ;<ERPROTECTION (INPUT) GIVE ERROR IF PROTECTION FAILURE
. ;<ERSUPERSEDE (OUTPUT) DO NOT RESTORE FILE FROM TAPE IF ON DISK
. ;<ESTIMATE N (OUTPUT) ESTIMATE OUTPUT FILE SIZE
. ;<LENGTH L:H (INPUT) INCLUDE ONLY IF LENGTH IS BETWEEN L, H
. ;<MBEFORE DATE-TIME (INPUT) INCLUDE ONLY IF MOVED BEFORE DATE-TIME
. ;<MSINCE DATE-TIME (INPUT) INCLUDE ONLY IF MOVED SINCE DATE-TIME
. ;<OKNONE (INPUT) NO ERROR IF NO FILES MATCH
. ;<OKPROTECTION (INPUT) NO ERROR IF PROTECTION FAILURE
. ;<OKSUPERSEDE (OUTPUT) ALWAYS RESTORE FILE FROM TAPE
. ;<[NO]PHYSICAL (IN/OUT) IGNORE LOGICAL NAMES
. ;<PROTECTION <NNN (OUTPUT) SET OUTPUT FILE PROTECTION
. ;<SINCE DATE-TIME (INPUT) INCLUDE ONLY IF CREATED OR MODIFIED
. ; SINCE DATE-TIME
. ;<STRS (INPUT) LOOK AT ALL STRUCTURES FOR FILE
. ;<VERSION V (OUTPUT) SET OUTPUT FILE VERSION
.SK 2
^THE FOLLOWING RUN-TIME COMMANDS MAY BE GIVEN WHILE <BACKUP IS
EXECUTING AN ACTION VERB.
<BACKUP PROMPTS WITH AN EXCLAMATION POINT (!) WHEN READY
TO ACCEPT A RUN-TIME COMMAND.
.SK1
.TS16
. ;<[NO]DIRECTORIES START TYPING EVERY DIRECTORY PROCESSED
. ;<EXIT EXIT TO MONITOR WHEN DONE WITH THE CURRENT ACTION
. ;<[NO]FILES START TYPING EVERY FILE AND DIRECTORY PROCESSED
. ;<GO CONTINUE FROM A <STOP
. ;<HELP LIST THESE RUN-TIME COMMANDS
. ;<KILL ABORT EXECUTION OF THE CURRENT ACTION VERB
. ;<PAUSE RETURN TO COMMAND LEVEL WHEN ALL DONE (DEFAULT)
. ;<RESET RESET ALL STATUS PARAMETERS WHEN ALL DONE
. ;<SILENCE STOP TYPING EVERY DIRECTORY OR FILE NAME
. ;<STOP STOP TEMPORARILY
. ;<WHAT DISPLAY CURRENT FILE NAME AND STATUS
.SK 2
<NOTE:##^TAPE REWINDS ARE NOT AUTOMATIC WHEN RUNNING <BACKUP.
.SKIP 4
<EXAMPLES:
.SK 2
.TS 24
1.#<SAVE SPEC-LIST ^^SAVE FROM DISK TO TAPE\\
.SK 1
^ONE SAVE SET WILL BE CREATED ON TAPE FOR EACH <SAVE COMMAND.
^THE SAVE SET MAY BE NAMED BY USING THE <SSNAME
STATUS SETTING COMMAND.
.SKIP 2
.INDENT 5
^A)#^SAVING ONLY RECENTLY ACCESSED FILES
.SKIP 1
^AN OPERATOR MAY USE <BACKUP TO SAVE ONLY THOSE FILES ACCESSED
TODAY AND CONCURRENTLY PRINT A DIRECTORY BY TYPING:
.SKIP 1
.LEFT MARGIN 10
^R <BACKUP
. ; /<TAPE <MTA0
. ;/<LIST
. ;/<ASINCE:1-^JUL-1975
. ; /<SSNAME "^JULY 1 INCREMENTAL"
. ; /<SAVE
.SKIP 1
.LEFT MARGIN 0
^A DIRECTORY FILE NAMED <BACKUP.LOG WILL BE SPOOLED TO <LPT.
.SKIP 2
.INDENT 5
^B) ^RECOVERING FROM A SYSTEM CRASH
.SKIP 1
<BACKUP'S DEFAULT TYPEOUT LEVEL IS DIRECTORIES, SO IN THE ABOVE EXAMPLE,
<BACKUP WOULD TYPE EACH <UFD AS IT BEGAN TO SAVE FILES FROM THAT <UFD.
^IF THE SYSTEM SHOULD CRASH DURING THE SAVE WHILE <BACKUP IS IN THE
PROCESS OF SAVING FILES FROM <UFD [10,123] THE OPERATOR COULD RESTART
AT <UFD [10,123] AFTER THE SYSTEM IS BROUGHT UP BY TYPING:
.SKIP 1
.LEFT MARGIN 10
^R <BACKUP
. ;/<TAPE <MTA0
. ;/<LIST
. ;/<ASINCE:1-^JUL-1975
. ;/<SSNAME "^JULY 1 INCREMENTAL"
. ;/<INITIAL [10,123]
. ;/<SAVE
.SKIP 1
.LEFT MARGIN 0
^NOTE THAT ALL THE STATUS PARAMETERS MUST BE RESET. ^NOTE
ALSO THAT THE TAPE SHOULD <NOT BE REWOUND.
.SK 2
.INDENT 5
^C)#^SAVING A USER'S DISK AREA
.SK 1
^A USER MAY SAVE HIS OWN DISK AREA WITH <BACKUP BY TYPING:
.SKIP 1
.LEFT MARGIN 10
^R <BACKUP
. ;/<TAPE <MTA0
. ;/<SAVE
. ;/<UNLOAD
. ;_^^C
.SKIP 1
.LEFT MARGIN 0
2.#<RESTORE SPEC-LIST ^^RESTORE FROM TAPE TO DISK\\
.SK 1
^IF A SAVE SET HAS BEEN NAMED BEFORE THIS COMMAND IS TYPED,
<BACKUP WILL RESTORE FILES ONLY FROM THE NAMED SAVE SET.
^TO RESTORE FILES FROM MORE THAN ONE SAVE SET, THE SAVE SET NAME
SHOULD BE RESET TO <ALL.
.SKIP 2
.INDENT 5
^A) ^RESTORING A SET OF FILES FROM A DISTRIBUTION TAPE
.SKIP 1
<BACKUP FORMAT DISTRIBUTION TAPES ARE MADE IN INTERCHANGE MODE
TO AVOID INCLUDING SYSTEM DEPENDENT DATA,
AND RELATED FILES ARE GROUPED TOGETHER IN NAMED SAVE SETS.
^TO COPY ALL FILES IN THE <SCAN SAVE SET TO <DEC:,TYPE:
.SK 1
.LEFT MARGIN 10
^R <BACKUP
. ; /<TAPE <MTA0
. ; /<INTERCHANGE
. ; /<SSNAME <SCAN
. ; /<RESTORE <DEC:#=#<DSK:
.SK 2
.LEFT MARGIN 0
.INDENT 5
^B) ^RESTORING INDIVIDUAL FILES FROM A <BACKUP TAPE
.SKIP 1
^TO RESTORE FILES <FOO.BAR AND <TST???.MAC SAVED UNDER <UFD [10,123] ON A <BACKUP TAPE, TYPE:
.SKIP 1
.LEFT MARGIN 10
^R <BACKUP
. ;/<TAPE <MTA0
. ;/<RESTORE [10,123]<FOO.BAR, [10,123]<TST???.MAC
. ;/<UNLOAD
. ;/<EXIT
.SK 2
.LEFT MARGIN 0
3.#<[N]PRINT SPEC ^^PRINT DIRECTORY OF THE ENTIRE TAPE ON\\ SPEC
.SK 1
^THE PREFIX ^N INDICATES A NARROW (72 COLUMN) LISTING. ^THE CURRENT
DIRECTORY ALWAYS FITS WITHIN 72 COLUMNS (SO <NPRINT
IS EQUIVALENT TO <PRINT) BUT IN THE FUTURE A WIDER FORMAT WHICH INCLUDES
MORE DIRECTORY INFORMATION MAY BE DEVELOPED. ^TO CREATE A DIRECTORY FILE ON DISK NAMED <BACKUP.LOG TYPE:
.SK 2
.LEFT MARGIN 10
^R <BACKUP
. ; /<TAPE <MTA0
. ; /<PRINT <DSK:
.LEFT MARGIN 0
.SK 1
4.#<CHECK SPEC-LIST ^^VERIFY THAT THE TAPE AND DISK AGREE\\
.SK 1
^THIS COMMAND CAUSES <BACKUP TO DO A WORD BY WORD COMPARISON OF THE
DISK FILES SPECIFIED BY THE OUTPUT SIDE AND THE TAPE FILES
SPECIFIED BY THE INPUT SIDE OF THE ENTRIES IN THE SPEC LIST.
^FOR EXAMPLE, TO SAVE ON TAPE ALL <COBOL FILES AND THEN
VERIFY THAT THE SAVED TAPE FILES ARE IDENTICAL TO THOSE ON DISK
TYPE:
.SK 1
.LEFT MARGIN 10
^R <BACKUP
. ; /<TAPE <MTA0
. ; /<SSNAME <COBOL
. ; /<SAVE *.<CBL
. ; /<REWIND
. ; /<CHECK *.<CBL
.SK 1
.LEFT MARGIN 0
^TO RESTORE ALL <SHR AND <LOW FILES FROM THE SAME TAPE AND THEN VERIFY THAT
THE FILES WERE RESTORED CORRECTLY TYPE:
.SK 1
.LEFT MARGIN 10
. ; /<REWIND
. ; /<SSNAME <ALL
. ; /<RESTORE *.<SHR, *.<LOW
. ; /<REWIND
. ; /<CHECK *.<SHR, *.<LOW
. ; /<UNLOAD
. ; /_^^c