Google
 

Trailing-Edge - PDP-10 Archives - tops20tools_v6_9-jan-86_dumper - tools/10backup/10backup.mem
There are 10 other files named 10backup.mem in the archive. Click here to see a list.
10BACKUP                                                                                 Page 1


                            10BACKUP V1.0
                           Computer Centre
                         La Trobe University
                             19-Oct-1984





1  INTRODUCTION

     10BACKUP is a VAX program  to  read  DECsystem-10  BACKUP  format
tapes.

     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.

     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.



2  RUNNING 10BACKUP

     At La Trobe 10BACKUP resides in the SYSPUB (SYStem PUBlic)  area.
When  invoked  with  a  DCL  RUN  command  the program prompts for its
commands using a '/'.  10BACKUP does not have Run-Time  commands  like
DECsystem-10 BACKUP.

        eg
            $ RUN SYSPUB:10BACKUP
            /



3  COMMANDS

     The commands used in 10BACKUP are:-

     1.  The EXIT command is used to exit from the program.

                   Format:  EXIT


     2.  The  HELP  command  provides  help  from  the  10BACKUP  help
         library.   At  La Trobe  the help library is contained in the
         file SYSPUB:10BACKUP.HLB.

                   Format:  HELP [topic]
10BACKUP                                                                                 Page 2


     3.  The TAPE command identifies the tape device to be used by the
         program.   The  tape  is  assumed to be a DECsystem-10 BACKUP
         tape and to be mounted /FOREIGN.

                   Format:  TAPE device


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

                   Format:  SSNAME save-set


     5.  To get a directory of the tape the DIR command can  be  used.
         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.

                   Format:  DIR [file-names]


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

                   Format:  RESTORE [file-names]


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

                   Format:  FILE file-name


     8.  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 beginning.

                   Format:  REWIND
10BACKUP                                                                                 Page 3


     9.  The SKIP command is used to skip over one or more  save-sets.
         The command parameter describes how many save-sets to skip.

                   Format:  SKIP n


    10.  The SIXBIT command causes the RESTORE command  to  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
         then be written to convert the data to the required format.

                   Format:  SIXBIT n





4  INSTALLING 10BACKUP

     To use 10BACKUP on a system two files are  required.   These  are
the  image  10BACKUP.EXE,  and  the  help  library  10BACKUP.HLB.   At
La Trobe both of these files reside in our SYStem PUBlic area, SYSPUB.

     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.

     The source modules that make up the 10BACKUP program are:-

     10BACKUP.BAS     the main line program.
     BIO.BAS          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.

     The program can be compiled and linked in the following manner:-

          $ BASIC 10BACKUP
          $ BASIC BIO
          $ MACRO BUR
          $ MACRO C36
          $ MESSAGE BMS
          $ LINK/NOTRACE 10BACKUP,BIO,BUR,C36,BMS
          $ RUNOFF 10BACKUP.RNH
          $ LIBRARY/CREATE/HELP 10BACKUP 10BACKUP
10BACKUP                                                                                 Page 4


5  PROBLEMS

     10BACKUP  is  distributed  on  an   'as   is'   basis   with   no
responsibility  being taken by its author for its use.  If you do have
any problems or suggestions regarding 10BACKUP then I  would  be  very
interested and would consider modifying the program.

        Paul Nankervis,
        Computer Centre,
        La Trobe University,
        BUNDOORA 3083,
        AUSTRALIA.



6  EXAMPLE

   $ RUN SYSPUB:10BACKUP
   /TAPE MFA0:
   /DIR
   Start of Save Set: SS1  Written at: 20-JUL-1984 16:23:41.87
   Under System: La Trobe 6.03A #3  On: MTA010
   Density: 800  Tape: 9-track

   FLSSKL  .CTL        53  12-SEP-1983 13:41:16
   DAYACC  .CTL        15  20-JUL-1984 02:52:13
   DAYFLS  .CTL        10  20-JUL-1984 02:51:13

   End of Save Set: SS1  Written at: 20-JUL-1984 16:23:44.84
   Under System: La Trobe 6.03A #3  On: MTA010
   Density: 800  Tape: 9-track

   /REWIND
   /RESTORE DAYACC.*,DAYFLS.CTL

   Start of Save Set: SS1  Written at: 20-JUL-1984 16:23:41.87
   Under System: La Trobe 6.03A #3  On: MTA010
   Density: 800  Tape: 9-track

   DAYACC  .CTL        15  20-JUL-1984 02:52:13
   DAYFLS  .CTL        10  20-JUL-1984 02:51:13

   End of Save Set: SS1  Written at: 20-JUL-1984 16:23:44.84
   Under System: La Trobe 6.03A #3  On: MTA010
   Density: 800  Tape: 9-track

   /EXIT
   $