Trailing-Edge - PDP-10 Archives - integ_tools_tops20_v7_30-apr-86_dumper - tools/10backup_v2_2/10backup.hlp
There are 8 other files named 10backup.hlp in the archive. Click here to see a list.
!  10BACKUP help file.
!  For 10BACKUP v2.2
!  The source modules that make up the 10BACKUP program are:-
!       10BACKUP.BAS    the main line program.
!       BIO.MAR         contains tape and file IO routines.
!       BUR.MAR         is a set of macro utility routines.
!       C36.MAR         contains 36 bit conversion routines.
!       BMS.MSG         contains the error message definitions.
!       10BACKUP.RNH    Runoff input to build the help library.

      10BACKUP is an easy to use  VAX  program  to  read  files  from  a
 magnetic  tape  written  by the DECsystem-10 BACKUP utility.  It's main
 use is to aid in transfering files from a DECsystem-10 to a VAX, or  to
 read existing DECsystem-10 BACKUP format tapes.

      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.

      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
 facility for transferring binary information is available  through  the
 SIXBIT command.

      10BACKUP uses 'interchange'  mode  to  read  the  tape.   This  is
 because  DECsystem-10  disk and UFD information does not apply on a VAX
 and has to be ignored.
1 Using_10BACKUP

      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.

      At La Trobe the 10BACKUP program resides  in  the  SYSPUB  (SYStem
 PUBlic)  area.  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.

      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.

      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 DIRECTORY and  RESTORE  commands
 can  be  used to get directory information or to restore files from the
1 Commands

      The commands used in 10BACKUP may be entered  in  upper  or  lower
 case  and  may  be  abbreviated as long as they are not made ambiguous.
 10BACKUP continues to prompt for commands using the '/' prompt until it
 reaches the end of command input or an EXIT command.
 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.
           Format:  HELP [topic [,...] ]
 The EXIT command exits from the program.
           Format:  EXIT
 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.
           Format:  TAPE device-name
           Example:  /TAPE MTA0:
 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 (").
           Format:  SSNAME [save-set-name]
           Example:  /SSNAME "COBOL File Save"
 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.
           Format:  RESTORE [file-names]
           Example:  /RESTORE SYS*.CBL,BACK.RNO
 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.
           Format:  DIRECTORY [file-names]
           Example:  /DIRECT *.RNO
 The REWIND command repositions the tape to its beginning.  This  allows
 the contents of the tape to be reprocessed.
           Format:  REWIND
 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.
           Format:  OUTPUT_DEFAULT [file-specification]
           Example:  /OUTPUT_DEFAULT DSK1B:[CCPN]
 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.
           Format:  SKIP save-set-count
 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.
           Format:  SIXBIT record-size
1 Multi_Volumes

      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:

 1.  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.

 2.  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.

 3.  A CTRL/Z to abort further processing of the save set.

      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.
1 Examples

      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".

           $ RUN SYSPUB:10BACKUP
           /TAPE TAPE:
              ... directory appears here ...
           /SSNAME "My Save Set"
           /RESTORE *SKL.CTL,*.RNO
              ... information on files appears here ...

      The next example shows the commands used to; a) get a directory of
 the  whole tape, b) restore files *.FOR from all save sets on the tape,
 and c) restore file BINARY.DAT as 36 byte SIXBIT records from save  set

           $ RUN SYSPUB:10BACKUP
           /TAPE MYTAPE:
              ... directory appears here ...
           /RESTORE *.FOR
              ... information on restored files appears here ...
           /SIXBIT 36
              ... information on restored files appears here ...
1 File_Transfers

      The DECsystem-10 BACKUP Utility and 10BACKUP may be used  together
 to transfer files from the DECsystem-10 to the VAX using magnetic tape.

      At La Trobe only MTA0:  on VAX2 can read the 800 BPI tapes written
 by  the DECsystem-10.  Therefore all DECsystem-10 to VAX file transfers
 must be done using this tape drive.

      The first  step  is  to  write  the  files  onto  tape  using  the
 DECsystem-10  BACKUP  utility.   The  following commands show the files
 *.RNO and NEW*.FOR being saved onto tape 456TAP:

      .R BACKUP
      /SSNAME "Files for VAX"
      /SAVE *.RNO,NEW*.FOR

 Now the files may be restored using MTA0:  on VAX2 with the commands:

         ... information on restored files appears here ...