Trailing-Edge - PDP-10 Archives - integ_tools_tops20_v7_30-apr-86_dumper - tools/10backup/10backup.rnh
There are 8 other files named 10backup.rnh in the archive. Click here to see a list.
.ps ,70;
.lm 1;.npa;
.i -1;! 10BACKUP help file.
.i -1;! For 10BACKUP v1.0
.i -1;!
.i -1;!
.i -1;! This module is part of 10BACKUP - a program to read DECsystem-10
.i -1;! BACKUP tapes in INTERCHANGE mode on a VAX.
.i -1;!
.i -1;! The source modules that make up the 10BACKUP program are:-
.i -1;!
.i -1;!	10BACKUP.BAS	the main line program.
.i -1;!	BIO.BAS		contains tape and file IO routines.
.i -1;!	BUR.MAR		is a set of macro utility routines.
.i -1;!	C36.MAR		contains 36 bit conversion routines.
.i -1;!	BMS.MSG		contains the error message definitions.
.i -1;!	10BACKUP.RNH	Runoff input to build the help library.
.i -1;!
.i -1;!
.i -1;!
.i -1;1 HELP
.p;10BACKUP is a VAX program to read DECsystem-10 BACKUP format tapes.
.p;10BACKUP has two primary functions; to get directories of, and to
selectively restore files from tapes written by BACKUP on a
DECsystem-10. Because INTERCHANGE mode is used to read the tape, any
UFD and disk name information on the tape is ignored. 
.p;Because of differences between the DEC-10 and the VAX this program
is intended mainly for restoring ASCII files. Limited facilities for
restoring binary information are available through the SIXBIT command.
.i -1;1 EXIT
.br;The EXIT command is used to exit from the program.
.b;.i +10;Format:  EXIT
.i -1;1 TAPE
.br;The Tape command identifies the tape device to be used by the
program. The tape is assumed to be a DECsystem-10 BACKUP format tape
and to be mounted /FOREIGN. 
.b;.i +10;Format:  TAPE device
.i -1;1 SSNAME
.br;The SSNAME command is used to select a particular save-set name.
All other save-sets on the tape are ignored. To use the default mode
of selecting all save-sets, no save-set name should be specified. 
.b;.i +10;Format:  SSNAME save-set
.i -1;1 DIR
.br;The DIR command is used to get a directory of the tape. This
command shows the selected files, their sizes, and creation dates. The
only wildcarding allowed in the optional file name list is the *
character, which may be used in place of an entire file-name or an
entire file-extension. 
.b;.i +10;Format:  DIR [file-names]
.i -1;1 RESTORE
.br;The RESTORE command is used to restore the selected files from the
tape. The files are written to the current default area using the same
names as they have on the tape. A list of file names may be specified
in the RESTORE command to select particular files to be restored. The
wildcard character * may be used in place of an entire file-name or an
entire file-extension. 
.b;.i +10;Format:  RESTORE [file-names]
.i -1;1 FILE
.br;The FILE command is an alternative to the TAPE command, to be used
when the DECsystem-10 BACKUP tape has been copied into a VMS file. The
FILE command cause all tape information to be read from the specified
file. The file must have the format where each tape block is stored as
a file record, with any tape marks being represented by zero length
records. At La#Trobe a suitable format file can be created from the
source tape using the COPYTAPE program. On a TU80 this command is
useful for performance reasons, as the COPYTAPE program keeps the
drive streaming, where as 10BACKUP may not. 
.b;.i +10;Format:  FILE file-name
.i -1;1 REWIND
.br;The REWIND command rewinds the tape so that it may be reprocessed.
If the tape information is in a file the file is positioned at its
.b;.i +10;Format:  REWIND
.i -1;1 SKIP
.br;The SKIP command is used to skip over one or more save-sets. The
command parameter describes how many save-sets to skip. 
.b;.i +10;Format:  SKIP n
.i -1;1 SIXBIT
.br;The SIXBIT command causes the RESTORE command write out files in
SIXBIT mode. SIXBIT takes an integer parameter to say how big the
output records should be in characters. If the parameter is zero then
the restored files are written in the default ASCII format. SIXBIT
could be used when the required files are not in ASCII and a user
program could be written to convert the data to the required format. 
.b;.i +10;Format:  SIXBIT n