Google
 

Trailing-Edge - PDP-10 Archives - bb-d868b-bm_tops20_v3a_2020_dist - new-subsys/dumper.hlp
There are 53 other files named dumper.hlp in the archive. Click here to see a list.
Format
     @DUMPER
     DUMPER  25-DEC-75
     DUMPER> command arguments
     command        is  a  DUMPER   action-command,   tape-positioning
                    command,  or  status-command.   Table n contains a
                    list of the DUMPER commands, grouped by function.
     arguments      is a file specification,  date,  density,  parity,
                    drive  number, number, or save-set name, depending
                    on the command.
                    dates          are  in  the  form  day-month-year.
                                   Type January 16, 1975 as 16-JAN-75.
                    times          are in 24-hour  format  (nn:mm:ss),
                                   or  in  AM,  PM form.  Thus 9:23 in
                                   the evening  is  either  21:23,  or
                                   9:23 PM.
                    filespecs
                    sources
                    destination    are       in        the        form
                                   dev:<dir>name.typ.gen.  The * and %
                                   wildcard characters are  permitted.
                                   Separate   multiple   source  file
                                   specifications with commas.
                    save-set name  is   a   string   of   alphanumeric
                                   characters which is used as a title
                                   for a save set.
                           DUMPER Commands
     ACTION-COMMANDS
        DUMPER action commands start, stop, interrupt  or  continue  a
        file transfer or file check.
     CHECK (ALL MTA FILES)
        Checks the files in the current save set  to  make  sure  that
        they  agree  with  the  files  on  disk.   The system prints a
        message if the files do not agree;  refer to items 1 and 2  in
        the  error  section.   Be  sure  to  rewind  the  tape  to the
        beginning of the save set before giving the CHECK command.
     CONTINUE
        Continues a CHECK, RESTORE, SAVE or  tape-positioning  command
        after  you  have  typed  a  CTRL/E  to  halt  it.  If you have
        prevented DUMPER from continuing, the  system  prints  ?CANNOT
        CONTINUE on your terminal.
     CTRL/E
        Halts   the   action   of   a   CHECK,   RESTORE,   SAVE,   or
        tape-positioning  command.   When  the  system  processes  the
        CTRL/E, it prints a message, suspends the action, then  prints
        the DUMPER prompt.


        INTERRUPTING...
        DUMPER>
        After typing CTRL/E, you may  give  a  CONTINUE,  DIRECTORIES,
        EXIT,  FILES, HELP, or SILENCE command.  If you give any other
        command, DUMPER loses the information  necessary  to  continue
        the action you halted.
     EXIT
        Exits immediately to system command level.
     HELP
        Prints a list of the valid DUMPER commands on your terminal.
     PRINT (DIRECTORY OF TAPE ONTO FILE) destination
        Prints a directory of the current save set  to  the  specified
        file   specification.    You  must  type  a  destination  file
        specification, but if you use recognition, the system defaults
        to TTY:  (your terminal).
     RESTORE (MTA FILES) sources (TO) destination
        Restores the magnetic tape source file(s)  to  disk  with  the
        given  destination  file  specification(s).   You  must type a
        source file specification.  If you do not type  a  destination
        file specification, the system uses *.*.*.
        When  the  restore  operation  starts  placing  files   in   a
       directory, the system prints the message:
        LOADING FILES INTO <directory>
        where directory is the name of the directory.
        If you are restoring files saved from  another  disk  area  to
        your  own disk area, you must explicitly specify the directory
        name in the source file specifications.
        Since all commands and programs assume that  the  most  recent
        file (in a group of files with the same file name and type) is
        the one with the highest generation number, you should try  to
        avoid  a  situation  where the most recent file has other than
        the highest generation number.  The easiest way is to use  the
        destination file specification *.*.-1 in your RESTORE command.
        This file specification forces all restored files  to  have  a
        generation  number one greater than any existing file with the
        same file name and type.  Should you  not  give  *.*.-1  as  a
        destination file specification and if you are restoring:
        1.  A file that is newer than a disk file with the  same  file
            name and type,
        2.  With the current mode set to SUPERSEDE OLDER (the  default
            mode), and
        3.  The file on tape has a generation number  lower  than  the
            file on disk,
        the system deletes the disk file(s)  and  issues  the  warning
        message:
        % FILE filespec DELETED WHILE SUPERSEDING
        where filespec identifies  the  disk  file  that  is  deleted.
        Under  these  conditions,  the system does not delete the disk
        file if it has a lower generation  number  than  the  magnetic
        tape  file  (unless  your  FILE  GENERATION-RETENTION-COUNT is
        one).
        If you set the mode to SUPERSEDE ALWAYS, the system  does  not
        check  for  older files with higher generation numbers and you
        may get newer files with lower generation numbers.
        If you set the mode to SUPERSEDE NEVER, the  system  will  not
        restore a file if one with the same file name and type exists,
        so the problem of newer files with  lower  generation  numbers
        will not occur.
        When the system gets to the end of the current save set or  to
        the end of the tape, it prints the message:
        Any more tapes?  YES
        Answer NO if you are at the end of a save-set;  answer YES  if
        the  save set continues onto another tape.  If you answer YES,
        the system prints:
        TAPE (FILESPEC)  MTA0:
        Mount the new tape, then type the name of the drive  on  which
        you  mount  it.  (If you have to run the PLEASE program, refer
        to the instructions in the SAVE command description.)
     SAVE (DISK FILES) sources (as) destination
        Saves the disk source file(s) onto magnetic tape.  If  you  do^
        not  give  any arguments to the SAVE command, DUMPER saves all
        the files in your connected directory.
        A save set is the group  of  files  saved  by  a  single  SAVE
        command.   You  may  give  the  save  set a name by giving the
        SSNAME command.

        DUMPER prints information about the saved files every time you
        give  the SAVE command.  Refer to the LIST command if you want
        to alter this function.
        If all the files in the save set cannot fit on a single  tape,
        the  system  stops  at  the  end  of the tape, rewinds it, and
        prints the message:
        End of tape, continue save on
        TAPE (FILESPEC) MTA0:
        Mount a fresh tape, then type the name of  the  magnetic  tape
        drive.   The  system prints a header, then continues the save.
        If you have to run the PLEASE program to get the  operator  to
        mount  the tape, type a CTRL/C, give the PUSH command, run the
        PLEASE program,  give  the  POP  command,  give  the  CONTINUE
        command,  type  a  CTRL/R,  then type the name of the magnetic
        tape drive.  Follow the next example:
        End of tape, continue save on
        TAPE (FILESPEC) ^C         Type CTRL/C to stop DUMPER
        @PUSH (COMMAND LEVEL)      Give the PUSH command
                                   (or DUMPER can not continue)
         TOPS-20 1(100)
        @PLEASE                    Run PLEASE
        WHAT IS THE OPERATOR'S ID?
        ENTER TEST: PLEASE MOUNT MY NEXT MAGTAPE ON MTA1:
        [OPERATOR HAS BEEN NOTIFIED]
        ALL DONE, USE MTA1: NOW.
        $
        [FINISHED AT 20:52:32]
        @POP (COMMAND LEVEL)       Give the POP command
        @CONTINUE                  Give the CONTINUE command
                                   Type a CTRL/R
        TAPE (FILESPEC) MTA1:      Then type the magnetic tape drive 
                                   number.
     TAPE-POSITIONING COMMANDS
        DUMPER tape-positioning commands control  the  tape  you  have
        specified  with  the last TAPE command or the tape assigned to
        the logical  name  MTA-DUMPER.   You  should  have  previously
        allocated  these  drives  to  your  job with the system ASSIGN
        command.
     EOT
        Skips to the end of the last save set on the tape  and  prints
        the  message:   TAPE  POSITIONED AT EOT.  If any save sets are
        encountered, the system prints the save set names.  
     REWIND
        Rewinds the tape to the logical beginning of tape (BOT).
     SKIP (NUMBER OF SAVESETS) n
        Skips the tape over n save sets.
     SKIP (NUMBER OF SAVESETS) 0
        Backspaces the tape to the beginning of the current save set.
     SKIP (NUMBER OF SAVESETS) -n
        Backspaces the tape over n save sets.
     STATUS-COMMANDS
        DUMPER  status-commands  set  parameters  which   affect   the
        operation  of  the CHECK, RESTORE and SAVE commands.  Once you
        set a parameter, it stays in effect until  you  change  it  or
        restart DUMPER.
     ABEFORE (DATE AND TIME) date time
        Includes only those files which were accessed  by  a  non-write
        operation (i.e., typed, printed or read in some manner) before
        the given date and time.
     ACCOUNT (OF RESTORED FILES FROM) location
        Specifies that any file being restored will  have  either  the
        SYSTEM-DEFAULT  account  (usually your current account) or the
        account that was stored with the file.  Normally,  the  system
        uses the system default.
     ASINCE (DATE AND TIME) date time
        Includes only those files which were accessed by  a  non-write
        operation  (i.e., typed, printed or read in some manner) since
        the given date and time.
     BEFORE (DATE AND TIME) date time
        Includes only those files which were created or  last  written
        (i.e.,  whose contents were changed) before the given date and
        time.
    
    [^n^o] ^c^h^e^c^k^s^u^m (files) type
        ^turns on (or off) checksumming. there are two types of
        checksum that may be specified. they are sequential and
        by-pages.  sequential checksums stop at eof. in interchange
        mode, only sequential checksums should be used.  ^by pages
        checksums do every existing word of every existing page of
        a file.  This command works like the checksum sub-command
        in the tops-20 command language.  When checksumming is turned
        on, it is causes checksums to be computed during the SAVE
        and PRINT commands.


     DENSITY (OF MAGTAPE) n
        Sets the tape density to the given number  of  bits  per  inch
        (BPI).    The   density  must  be  200,  556,  800,  1600,  or
        JOB-DEFAULT (set by the system command SET TAPE DENSITY).   If
        you  do  not give the DENSITY command, DUMPER uses the density
        listed in the system command INFORMATION (ABOUT) TAPES.
     [NO] DIRECTORIES
        Starts (or stops, directory name if you type NO)  printing  on
        your terminal each directory name as the directory is saved or
        restored.  Normally, the system prints each directory name.
     [NO] FILES
        Starts (or stops, if you type NO) printing  on  your  terminal
        each  file  specification  as  the  file is saved or restored.
        Normally, the system does not print each file specification.
     FORMAT (VERSION NUMBER IS) n
        Allows the system to read and write  DUMPER  tapes  that  were
        written  with  other  (unsupported)  versions  of DUMPER.  The
        default format is 2;  BBN-TENEX users should use 0 to read and
        write tapes created by BBN-DUMPER.
     [NO] INITIAL (FILESPEC) filespec
        Starts (or stops, if you  type  NO)  checking,  restoring,  or
        saving at the file identified by filespec.
     [NO] INTERCHANGE (FORMAT)
        Starts (or stops, if  you  type  NO)  using  the  DECsystem-10
        (TOPS10  BACKUP)  interchange  format  in  reading and writing
        tapes.
     [NO] LIST (LOG INFORMATION ON FILE) filespec
        Makes a list of the files transferred in the  file  identified
        by  filespec.  If you do not give a file specification, DUMPER
        uses the file LPT:DUMPER.LOG.  By default, 
LIST is turned off.

        
     MBEFORE (DATE AND TIME) date time^
        Include only those files  modified  (i.e.,  written,  created,
        appended,  or  renamed) before the specified internal date and
        time.
     MSINCE (DATE AND TIME) date time
        Includes only those files modified  (i.e.,  written,  created,
        appended,  or  renamed)  since the specified internal date and
        time.
     PARITY (OF MAGNETIC TAPE) type
        Sets the parity of the current magnetic tape to EVEN  or  ODD.
        DUMPER  normally  uses the parity listed in the system command
        INFORMATION (ABOUT) TAPES.
     PROTECTION (OF RESTORED FILES FROM) location
        Takes  the  protection  of  the  restored   files   from   the
        SYSTEM-DEFAULT (usually 770000) or from the tape.

    SET TAPE-NUMBER n
        Used for multi-reel savesets when continuing a restore after
        a crash or when restoring a file non-sequentially from a 
        mult-reel saveset.  ^also used for continuing a save after a
        crash:
                DUMPER>INITIAL <JONES>*.*.*
                DUMPER>SET TAPE-NUMBER 4
                DUMPER>SAVE

     [NO] SILENCE
        Stops (or starts, if you type NO) printing directory names and
        file specifications as the files are saved or restored.
     SINCE (DATE AND TIME) date time
        Includes only those files that were created  or  last  written
        (i.e.,  whose  contents were changed) since the specified date
        and time.
     SSNAME name
        Identifies  a  save  set  name  of  up  to   30   alphanumeric
        characters.  
     SUPERSEDE condition
        Sets the condition under which DUMPER will  supersede  a  disk
        file with a magnetic tape file of the same file name and type.
        Use ALWAYS when you always want to  supersede  the  disk  file
        with  the  tape  file.   Use  NEVER  when  you  never  want to
        supersede the disk file;  in this case, a file is  transferred
        from  tape only if there is no disk file in the directory with
        the same file name and type.  Use OLDER when you want the tape
        file to supersede only older disk files;  in this case, a tape
        file is transferred to disk  file.   If  you  do  not  give  a
        SUPERSEDE  command, the system uses SUPERSEDE OLDER.  Refer to
        the RESTORE command.
     TAPE (FILESPEC) MTAn:
        Uses the specified tape for the file transfers.  If the  drive
        is not available to your job, the system prints:
        ?INVALID FILESPEC, DEVICE IS NOT AVAILABLE TO THIS JOB
        wait until you can assign a magnetic tape to your job.  You do
        not  have to give a TAPE command if you assign a magnetic tape
        device name to the logical name MTA-DUMPER.
Operation
     1.  Type DUMPER and press the  RETURN  key;   the  system  prints
         DUMPER, the date it was installed, and the prompt DUMPER>.
         @DUMPER
         DUMPER 25-DEC-75
         DUMPER>
     2.  Give the DUMPER commands you want.  (You  must  give  a  TAPE
         command  before  giving  an  action  command.)  When  you are
         finished, give the EXIT command.
         DUMPER> TAPE (FILESPEC) MTA1:
         DUMPER> REWIND
         DUMPER> SSNAME TEST1
         DUMPER> SAVE
         DUMPER TAPE # 1, TEST1, WEDNESDAY, 27-DEC-75 0958
         TOTAL FILES DUMPED = 5
         TOTAL PAGES DUMPED = 95
         DUMPER> EXIT
         @
Examples
1.  Saving all the files in your connected  directory--  To  save  all
    files  in  your  connected  directory  onto MTA0:  in the save set
    labeled Reference  Files,  then  check  the  magnetic  tape  files
    against the corresponding disk files:
    @ASSIGN (DEVICE) MTA0:              !Assign drive 0
    @DUMPER                             !Start DUMPER
    DUMPER 25-DEC-75
    DUMPER>TAPE (FILESPEC) MTA0:        !Tell DUMPER to use drive  0
    DUMPER>REWIND                       !Move to the beginning of tape
    DUMPER>SSNAME REFERENCE FILES       !Declare the save-set name
    DUMPER>SAVE (DISK FILES)            !Give the SAVE command
    DUMPER TAPE # 1, REFERENCE FILES, FRIDAY, 2-JAN-76 1432
    <TPORADA>
    TOTAL FILES DUMPED = 8
    TOTAL PAGES DUMPED = 65
    DUMPER>REWIND                       !Move to the beginning of tape
    DUMPER>CHECK (ALL MTA FILES)        !Check the saved files
    DUMPER TAPE # 1, REFERENCE FILES, FRIDAY, 2-JAN-76 1432
    ANY MORE TAPES? N                   !There is only one tape
    DUMPER>EXIT                         !There are no errors, stop
    @UNLOAD (DEVICE) MTA0:              !Rewind tape onto source reel
    @DEASSIGN (DEVICE) MTA0:            !Return tape for other users
    @
                                 Hint
               If you want the names of the saved files
               printed on your terminal, give the FILES
               command  immediately  after  the  SSNAME
               command.
2.  Saving a single file on tape-
    @ASSIGN (DEVICE) MTA0:              !Assign drive 0
    @DUMPER                             !Start DUMPER
    DUMPER 25-DEC-75
    DUMPER>TAPE (FILESPEC) MTA0:        !Tell DUMPER to use drive 0
    DUMPER>REWIND                       !Go to beginning of tape
    DUMPER>SSNAME FORTRAN PROGRAMS      !Declare save-set name
    DUMPER>FILES                        !Print file names as saved
    DUMPER>SAVE (DISK FILES) TEST.FOR   !Save TEST.FOR
    DUMPER TAPE # 1, FORTRAN PROGRAMS, FRIDAY, 2-JAN-76 1442
    <TPORADA>
    TEST.FOR.1
    TOTAL FILES DUMPED = 1
    TOTAL PAGES DUMPED = 1
    DUMPER>REWIND                       !Move to beginning of tape
    DUMPER>CHECK (ALL MTA FILES)        !Check the file
    DUMPER TAPE # 1, FORTRAN PROGRAMS, FRIDAY 2-JAN-76 1442
    ANY MORE TAPES? N                   !No more tapes
    DUMPER>EXIT                         !End DUMPER
    @UNLOAD (DEVICE) MTA0:              !Rewind the tape onto source
                                        reel
    @DEASSIGN (DEVICE) MTA0:            !Let other users have the
                                        drive
    @
3.  To copy all the files from the second save set on the tape to your
    disk  area:   (if  a  file  already  exists  with  the  same  file
    specification, the file on tape is written only  if  it  is  newer
    than the disk file;  refer to the SUPERSEDE parameter command.)
    @ASSIGN (DEVICE) MTA0:              !Assign drive 0
    @DUMPER                             !Start DUMPER
    DUMPER 25-DEC-75
    DUMPER>TAPE (FILESPEC) MTA0:        !Use drive 0
    DUMPER>REWIND                       !Go to beginning of tape
    DUMPER>SKIP (NUMBER OF SAVESETS) 1  !Skip to end of first save set
    DUMPER TAPE # 1, SATURDAY'S FILES, SATURDAY, 3-JAN-76 1151
    DUMPER>RESTORE (MTA FILES) *.*.* (TO)    !Restore all files
    DUMPER TAPE # 1, LIBRARY FILES, SATURDAY, 3-JAN-76 1153
    ANY MORE TAPES? N                   !No more tapes
    DUMPER>SKIP 0                       !Go to start of current save
                                        set
    DUMPER TAPE # 1, LIBRARY FILES, SATURDAY, 3-JAN-76 1153
    DUMPER>CHECK (ALL MTA FILES)        !Check files for errors
    DUMPER TAPE # 1, LIBRARY FILES, SATURDAY, 3-JAN-76 1153
    ANY MORE TAPES? N                   !No more tapes
    DUMPER>EXIT                         !End DUMPER
    @UNLOAD (DEVICE) MTA0:              !Rewind tape onto source reel
    @DEASSIGN (DEVICE) MTA0:            !Return tape for other users
    @