Google
 

Trailing-Edge - PDP-10 Archives - integ_tools_tops20_v7_30-apr-86_dumper - tools/10backup_v2_3/10backup.rno
There are 8 other files named 10backup.rno in the archive. Click here to see a list.
.ps 58,74;
.rm 72;
.ft;.t 10BACKUP
.c;10BACKUP#V2.3
.c;Computer#Centre
.c;La#Trobe#University
.c;22-July-1985
.b 2;

.hl 1 Introduction
.p;10BACKUP is an easy to use VAX program to read files from a magnetic
tape created by the DECsystem-10 BACKUP utility. It's purpose is to enable
file transfer from a DECsystem-10 to a VAX, or to read existing
DECsystem-10 BACKUP format tapes. 
.p;Tapes written by the TOPS-20 DUMPER utility are very similar so most of
these should be able to be read by 10BACKUP as well. 
.p;Because of the architectural differences between the two machines,
binary files from a DECsystem-10 (such as .EXE or .REL files) are normally
meaningless on a VAX. 10BACKUP is therefore intended mainly for restoring
normal ASCII text files (such as .FOR or .RNO files). A limited facility
for transferring binary information is available through the SIXBIT
command. 
.p;10BACKUP uses 'interchange' mode to read the tape as DECsystem-10 disk
and UFD information is not useful on a VAX. 

.hl 1 Using 10BACKUP
.p;Before using 10BACKUP the tape to be read must be mounted using the
/FOREIGN qualifier. Also you should set your default directory to where
you wish to put any restored files. 
.p;When the program is RUN it prompts for commands using a '/'. This is
the same prompt as DECsystem-10 BACKUP uses although 10BACKUP has neither
the same commands nor Run-Time commands like DECsystem-10 BACKUP. 
.p;The commands used in 10BACKUP may be abbreviated as long as they are
not made ambiguous. 10BACKUP continues to prompt for commands until it
reaches the end of command input or an EXIT command. 
.p;The first command normally used in 10BACKUP is the TAPE command to
identify the input tape. After that the SSNAME command may be used to
select a particular tape save-set, and then DIRECTORY and RESTORE commands
can be used to get directory information or to restore files from the
tape. 

.hl 1 Commands
The commands available in 10BACKUP are:-
.ls;
.b;
.le;The HELP command provides help from the 10BACKUP help library. This
command uses the VMS help routines and is therefore similar to the DCL
HELP command in use.
.i +10;Format:  HELP [topic [,...] ]
.b;
.le;The EXIT command exits from the program.
.i +10;Format:  EXIT
.b;
.le;The TAPE command identifies the tape device for subsequent
commands. The tape device must contain a DECsystem-10 BACKUP format tape
and must be mounted with the /FOREIGN qualifier. A logical name may be
used to specify the device. This command must be given before any other
command which accesses the tape device. A file-name may be used in place
of the device name when the file contains a copy of a DECsystem-10
BACKUP tape. 
.i +10;Format:  TAPE device-name
.i +10;Example: /TAPE MTA0:
.b;
.le;The SSNAME command may be used to select a specific save set on the
tape for processing. Subsequent RESTORE and DIRECTORY commands will only
process files from the selected save set. If no save set name is given
then all save sets on the tape will be processed (the default). To
preserve lower case characters or exact spacing in the save set name it
should be put in double quotes ("). 
.i +10;Format:  SSNAME  [save-set-name]
.i +10;Example: /SSNAME "COBOL File Save"
.b;
.le;The RESTORE command restores files from the tape to the current
default directory. A file name list may be given to restore only
specific files. The '*' character may be used as a wildcard in the
file name list. Before this command is given a TAPE command must be used
to identify the tape to be read, and an SSNAME command may be used to
select a particular save set for processing. As each file is restored
appropriate directory information is printed. 
.i +10;Format:  RESTORE  [file-names]
.i +10;Example: /RESTORE SYS*.CBL,BACK.RNO
.b;
.le;The DIRECTORY command prints file-name, size, and creation date
information about files on the tape. A file name list may be given to
print information only on specific files. The '*' character may be used
as a wildcard in the file name list. Before using this command a tape
must be selected with the TAPE command, and a specific save-set may be
selected using the SSNAME command. 
.i +10;Format:  DIRECTORY [file-names]
.i +10;Example: /DIRECT *.RNO
.b;
.le;The REWIND command repositions the tape to its beginning. This
allows the contents of the tape to be reprocessed. 
.i +10;Format:  REWIND
.b;
.le;The OUTPUT__DEFAULT command sets the default output file name
specification for files generated by the RESTORE command. This is
useful for when you wish to restore files to an area other than the
current default.
.i +10;Format:  OUTPUT__DEFAULT [file-specification]
.i +10;Example: /OUTPUT__DEFAULT  DSK1B:[CCPN]
.b;
.le;The SKIP command skips over one or more save-sets. The
command parameter describes how many save-sets to skip. The parameter 
may be a positive number to skip forward or a negative number to skip 
backwards.
.i +10;Format:  SKIP save-set-count
.b;
.le;The SIXBIT command causes the RESTORE command to write out restored
files in SIXBIT mode. SIXBIT takes an integer parameter to say how big
the output records should be in bytes. If the record size is zero then
SIXBIT mode is switched off and the restored files are written using
normal ASCII text format. SIXBIT mode is used to restore binary information
from the tape. Each 36 bit word is written as six sets of six bits each
converted to an ASCII byte by adding decimal 32. If the file contained 
SIXBIT text in fixed length records then no further conversion is required,
otherwise a user supplied program would have to convert the appropriate
binary data types into the desired format.
.i +10;Format:  SIXBIT record-size
.b;
.le;The CHECKSUM command turns OFF or ON checking of tape block checksums.
The default is to check all block checksums on the tape. The only reasons
for turning off checksum verification is to attempt to read a bad tape or
if processing time is critical.
.i +10;Format:  CHECKSUM # OFF or ON
.b;
.els;

.hl 1 Multi-Volumes
.p;When 10BACKUP reaches the end of the tape volume while it is still
processing a save set, it assumes that another tape volume must follow.
For interactive jobs, or if the tape input is coming from a file,
10BACKUP rewinds the current volume and prompts "Please ready the
next 10BACKUP tape volume:". The response to this prompt may be: 
.ls;.le;A <RETURN> to re-use the same device. Before entering this
response the next tape volume containing the save set continuation must
be loaded into the device by contacting the operators. This may be done by
ringing and telling them which volume to load, or by spawning a
subprocess to send an appropriate request message. 
.le;The name of another device to use. 10BACKUP will continue processing
the save set from this device which must also have been mounted using the
/FOREIGN qualifier.
.le;A CTRL/Z to abort further processing of the save set.
.els;
.p;For non-interactive jobs 10BACKUP sends a request to the operators
asking them to physically mount the next volume in the tape device.
When the operator replies 10BACKUP will continue processing the save set
from the new volume.
.tp 15;

.hl 1 Example Usage
.p;The following is an example of the usage of 10BACKUP. It shows the commands
used to get a directory of the whole tape, and how to restore files *SKL.CTL
and *.RNO from the save set "My Save Set".
.b 2;.lm +10;.tp 11;.nf;
$ MOUNT/foreign mtb1: backup tape
$ RUN 10backup
/TAPE tape:
/DIRECTORY
.b;
   ... directory appears here ...
.b;
/REWIND
/SSNAME "My Save Set"
/RESTORE *skl.ctl,*.rno
.b;
   ... directory of restored files appears here ...
.b;
/EXIT
$
.f;.lm -10;
.ax Installation Guide
.p;To use 10BACKUP on a system two files are required. These are the
image file 10BACKUP.EXE, and the help library file 10BACKUP.HLB. The minimum
required to install 10BACKUP is to copy these two files from the
installation tape to the desired directory. At La#Trobe both of these
files reside in our SYStem PUBlic area, SYSPUB. 
.p;As supplied, the program expects the help library to have the name
SYSPUB:10BACKUP.HLB. To put the help library in an appropriate area for
your installation you must define the logical name SYSPUB, or edit
10BACKUP.BAS (and recompile/relink etc.) to use the correct name. 
.p;The installation tape contains the following files:
.nf;.lm +8;
.b;.i 5;The ready to use files:
10BACKUP.EXE	The 10BACKUP program.
10BACKUP.HLB	The program help library.
10BACKUP.MEM	This text file.
.b;.i 5;Program sources:
10BACKUP.BAS	The main program.
BIO.MAR		Program IO routines.
BUR.MAR		Utility routines.
C36.MAR		36 bit conversion routines.
BMS.MSG		Message definitions
10BACKUP.RNH	Help library source.
10BACKUP.RNO	This text source.
.b;.i 5;Intermediate files (in case you don't have a compiler):
10BACKUP.OBJ		BIO.OBJ		BUR.OBJ
C36.OBJ			BMS.OBJ		10BACKUP.HLP
.f;.lm -8;.tp 11;
.p;If need be the program can be compiled and linked from the sources
using the following commands:
.nf;.lm +16;.b;
$ BASIC 10BACKUP
$ MACRO BIO
$ MACRO BUR
$ MACRO C36
$ MESSAGE BMS
$ LINK/NOTRACE 10BACKUP,BIO,BUR,C36,BMS
$ RUNOFF 10BACKUP.RNH
$ LIBRARY/CREATE/HELP 10BACKUP 10BACKUP
.f;.lm -16;

.hl 1 PROBLEMS
.p;10BACKUP is distributed on an 'as is' basis with no responsibility
being taken by the author for its use. It would be appreciated however,
if any problems found in 10BACKUP could be reported to the program 
author (see front of program listing for details).