Google
 

Trailing-Edge - PDP-10 Archives - bb-h137e-bm_tops20_v6_1_instl - new-subsys/dumper.hlp
There are 53 other files named dumper.hlp in the archive. Click here to see a list.
DUMPER is a TOPS-20  utility  whose  function  is  to  transfer  files
between  disk  storage  and  9-track  magnetic tape.  It is invoked by
giving the DUMPER command when you  see  the  "@"  prompt  at  TOPS-20
executive command level.  DUMPER will prompt for a command, which will
have the following format:

    DUMPER>command arguments

command       is a DUMPER action-command, tape-positioning command, or
              status-command.

arguments     is a file specification, date, density, parity,  number,
              or saveset name, depending on the command.  Dates are in
              the form day-month-year.  For  example,  type  July  21,
              1975   as   21-JUL-75.   Times  are  in  24-hour  format
              (hh:mm:ss), or in AM/PM form.  Thus 9:23 in the  evening
              is  either 21:23, or 9:23 PM.  Filespecs are in the form
              dev:<dir>name.typ.gen.   Use  of  *   and   %   wildcard
              characters   is   permitted.   Use  commas  to  separate
              multiple source file specifications.   A  saveset  is  a
              group  of files on tape that were saved as the result of
              one SAVE command to DUMPER.  A saveset name is a  string
              of alphanumeric characters that is used as a title for a
              saveset.



                           DUMPER Commands

ACTION-COMMANDS:  These commands start, stop, interrupt, or continue a
file transfer or file check.

     ABORT (command)
        Aborts execution of  previously  interrupted  command. 
        See entry for CTRL/E (Control-E) for more information.

     ARCHIVE (DISK FILES)
        Equivalent to SAVE/ARCHIVE.

     CHECK (ALL TAPE FILES)
        Checks the files in the current saveset to make sure that they
        agree  with  the  files  on disk.  Actual file checking is not 
        done; rather,  DUMPER  searches the  File Descriptor Block for
        differences  between  files.  DUMPER  prints  a message if the
        files do not agree.  Be sure  to  position  the  tape  to  the
        beginning of the saveset before giving the CHECK command.

     CONTINUE
        Continues   a   CHECK,    RESTORE,    RETRIEVE,    SAVE,    or
        tape-positioning command after you have typed a CTRL/E to halt
        it.  CONTINUE is legal only when the double-broket ("DUMPER>>")
        prompt is visible.

     CTRL/E
        Halts the action of  a  CHECK,  RESTORE,  RETRIEVE,  SAVE,  or
        tape-positioning  command.   When DUMPER processes the CTRL/E,
        it prints a message, suspends  the  action,  then  prints  the
        DUMPER  prompt  followed by another ">" to indicate there is a
        command waiting in the background:

           Interrupting...
           DUMPER>>

        After typing CTRL/E, you may give any command that does
        not fatally interfere with the  interrupted  command  (eg
        SILENCE, HELP or CONTINUE  to resume).  To give any other 
        command that might cause  DUMPER to lose its place on the
        tape (such as any tape-positioning or read/write command)
        it is necessary  to  type  ABORT.  DUMPER will reply with
 
          Aborting FOO command...
 
       and the regular DUMPER prompt, where "FOO" is the name of
        the interrupted command.  There is no way to continue an
        interrupted command once ABORTed. CTRL/E will be ignored
        if DUMPER is in command level or almost finished with
        the previously entered command.

     EXIT
        Exits immediately to TOPS-20 command level.

     MIGRATE (DISK FILES)
        Equivalent to SAVE/MIGRATE.

     PRINT (DIRECTORY OF TAPE ONTO FILE) destination
        Prints a directory of the  current  tape  to  the  destination
        file   specification.    If  you  omit  the  destination  file
        specification or use recognition, the destination defaults  to
        TTY:  (your terminal).

     QUIT
        Same function as the EXIT command.

     RESTORE (TAPE FILES) sources (TO) destination
        Restores the magnetic tape source file(s)  to  disk  with  the
        given destination file specification(s).  If you do not type a
        source file specification, DUMPER uses *.*.*.  If you  do  not
        type  a  destination  specification,  DUMPER assumes it is the
        same  as  the  source  specification.   When   DUMPER   begins
        restoring files to a directory, it prints the message:

           Loading files into <directory>

        If you are restoring files from a directory other than  yours,
        you   must   specify   that   directory  in  the  source  file
        specification.  If files exist in  the  destination  directory
        with the same names and types as the files on the tape, DUMPER
        performs according to the setting  of  the  supersede  control
        (see the SUPERSEDE command).

     RETRIEVE (FILES) filespec
        Instructs DUMPER to process the requests in  the  system  file
        retrieval queue.  A wildcarded filespec can be used to specify
        the files to be retrieved.  If no filespec is given, all files
        in the queue will be processed.

     SAVE (disk FILES) [switch] 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.  As DUMPER saves files,
        it  reports  its  progress at the terminal (refer to the FILES
        and DIRECTORIES commands).  If all the files cannot fit on one
        tape,  DUMPER requests that the next tape volume in the set be
        mounted.  After this is done, DUMPER prints a header line  and
        resumes the save operation.

        Switches for the SAVE command are:

           /ARCHIVE - Requests that DUMPER save only files  that  have
           been marked for archival

           /MIGRATE - Requests that DUMPER save only files  that  have
           been marked for migration

           /FULL-INCREMENTAL - Saves all  specified  files  and  marks
           each file as having been saved

           /INCREMENTAL:n - Saves all files that have either:  not yet
           been  saved  on  n tapes, or been modified or created since
           the last INCREMENTAL or FULL-INCREMENTAL run

           /NOINCREMENTAL - Files will not be marked as saved (this is
           the default)

	   /UNLOAD - unload the  tape  after  writing  the  saveset if
	   possible

     TRANSFER (TAPE FILES) source (TO) destination
	Identical to RESTORE,  but the defaults are  DSK*:<*>*.*.* for
	the    source   and    DSK:<connected-directory>*.*.* for  the
	destination.


TAPE-POSITIONING COMMANDS:  These commands control the position of the
tape  without  transferring  any file information between the tape and
disk.

     EOT
        Skips to the end of the last saveset on the  tape  and  prints
        the message:

           At End of Tape.

         Any saveset names encountered by DUMPER will be displayed
         on the terminal.

     REWIND argument
        If the argument is CURRENT-VOLUME or no argument is given, the
        currently-mounted  volume  is rewound to the beginning of tape
        (BOT).  If the argument is SWITCHING  followed  by  a  number,
        DUMPER switches to the specified volume and rewinds it.

     SKIP (NUMBER OF SAVESETS) n
        Skips the tape over n savesets.   If  n  is  0,  the  tape  is
        backspaced  to  the  beginning  of  the  current  saveset.   A
        negative value causes backspacing over n savesets.  Values  of
	0 or less are not legal with labeled tapes.

     UNLOAD
        Unloads the tape from the drive.  This command works only  for
        MTA devices.  Use the system command DISMOUNT TAPE to unload a
        MOUNTed tape device (MT device).


STATUS-COMMANDS:   These  commands  set  parameters  that  affect  the
operation  of  the  CHECK, RESTORE, RETRIEVE, and SAVE commands.  Once
you set a parameter, it stays in effect until you change it or restart
DUMPER.   In commands that can accept  a preceding NO,  the NO variant
clears the listed condition.

     [NO] ABEFORE (DATE AND TIME) date time
        Includes only those files that 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, DUMPER  uses
        the system default.

     [NO] 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.

     [NO] 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.

     [NO] CHECKSUM (FILES) type
        Turns on (or  off)  checksumming.   There  are  two  types  of
        checksum  that  may  be  specified:   SEQUENTIAL and BY-PAGES.
        Sequential checksums stop at EOF.  In interchange  mode,  only
        sequential  checksums  should  be  used.   BY-PAGES  checksums
        include every existing word of every existing page of a  file.
        This command works like the CHECKSUM subcommand in the TOPS-20
        command language.  When  checksumming  is  turned  on,  it  is
        causes  checksums  to  be  computed  during the save and print
        commands.

     [NO] CREATE (DIRECTORIES FROM TAPE DATA)
        Requests (or suppresses if you type NO) the creation  of  user
        directories from directory information on the tape.

     NO DATES
	Undoes  the  effect  of the  ASINCE,  MSINCE, SINCE,  ABEFORE,
	MBEFORE, and BEFORE commands.  Only the NO form exists.

     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, 6250, or
        job-default (set by the system command SET TAPE DENSITY).   If
        you  do  not give the DENSITY command, DUMPER uses the density
        listed   by   the   system   command    INFORMATION    (ABOUT)
        TAPE-PARAMETERS.   If  the tape is labeled, the density of the
        tape is already determined by the  label  information  on  the
        tape.

     [NO] DIRECTORIES
        Starts (or stops, if you type NO) printing  on  your  terminal
        each  directory  name  as  the directory is saved or restored.
        Normally, DUMPER 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, DUMPER does not print each file specification.

     FORMAT (VERSION NUMBER IS) n
	Allows  DUMPER  to read  DUMPER tapes that were  written  with
	older versions of DUMPER.  The default format is 6.

     HELP
        Prints this list of the valid DUMPER commands on your terminal.

     [NO] INITIAL (FILESPEC) filespec
        Starts (or stops, if you  type  NO)  checking,  restoring,  or
        saving at the file identified by filespec.  This  condition is
	cleared once it has taken effect.

     [NO] INTERCHANGE (FORMAT)
        Starts (or stops, if  you  type  NO)  using  the  DECSYSTEM-10
        (TOPS-10  BACKUP)  interchange  format  in reading and writing
        tapes.

     [NO] LIST [switches] (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.
	If the /MAIL switch  is given,  this writes a file that can be
	read   back   with  the  MAIL command.   The  default is  then
	DUMPER-MAIL.TXT.


     [NO] MBEFORE (DATE AND TIME) date time
        Include only those files  modified  (i.e.,  written,  created,
        appended, or renamed) before the specified date and time.

     [NO] MSINCE (DATE AND TIME) date time
        Includes only those files modified  (i.e.,  written,  created,
        appended, or renamed) since the specified date and time.

     PARITY (OF MAGTAPE) 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) TAPE-PARAMETERS.

     PROTECTION (OF RESTORED FILES FROM) location
        Takes the protection of the restored  files  from  the  system
        default (usually 770000) or from the tape.

     SET BLOCKING-FACTOR (TO) n (RECORDS)
        Sets the number of logical records per physical record written
        by DUMPER.  The default value is 1.

     SET TAPE-NUMBER (DECIMAL NUMBER) n
        Used for multi-reel savesets when continuing a restore after a
        crash  or  when  restoring  a  file  non-sequentially  from  a
        multi-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.

     [NO] 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
        Specifies the name to be written in the saveset header on  the
        tape. The name may by any string of up to 200 characters long.

     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, DUMPER uses SUPERSEDE OLDER.  Refer to the
        RESTORE command.

     TAPE (FILESPEC) tapespec
        Specifies the tape device to be used for file transfers.   The
        tapespec  is  either  a physical tape drive (MTAn:), a logical
        tape device (MTn:), or a logical name.
	You  do not have to give a TAPE command if you assign a
        magnetic tape device name to the logical name MTA-DUMPER.



                               EXAMPLES


1.  Saving multiple groups of files in different directories under
    different saveset names:

@MOUNT TAPE DTEST:/WRITE-ENABLED /LABEL-TYPE:ANSI
[Mount request DTEST queued, request #21]

[Tape set DTEST, volume DTEST mounted]
[DTEST: defined as MT0:]
@DUMPER
DUMPER>TAPE DTEST:
DUMPER>SSNAME FOO.BAR tape
DUMPER>SAVE WORK:<SANTIAGI>*.*.*

 DUMPER tape #1, Tue 26-Jun-84 1501.  "FOO.BAR tape"  volid DTEST

 WORK:<SANTIAGI>


 Total files dumped:     12
 Total pages dumped:    217
DUMPER>SSNAME PART II
DUMPER>SAVE (DISK FILES) RANDOM:<THALI>*.*.*

 DUMPER tape #1, Tue 26-Jun-84 1501.  "PART II"  volid DTEST

 RANDOM:<THALI>


 Total files dumped:      9
 Total pages dumped:    297
DUMPER>EXIT
@DISMOUNT TAPE DTEST: 
[Tape dismounted, logical name DTEST: deleted]


2.  Renaming files on Tape:

@MOUNT TAPE FOO: /WRITE-ENABLED /LABEL-TYPE:ANSI 
[Mount request FOO queued, request #22]

[Tape set FOO, volume FOO mounted]
[FOO: defined as MT0:]
@DUMPER
DUMPER>REWIND
 Tape specification needed: FOO:
DUMPER>SSNAME Installation-Specific Routines
DUMPER>SAVE WOK:<ALETHEA>*.*.* (AS) RANDOM:<UNSUPPORTED>*.*.*

 DUMPER tape #1, Tue 26-Jun-84 1504.  "Installation-Specific Routines"  volid
 DTEST

 WOK:<ALETHEA> (AS) RANDOM:<UNSUPPORTED>


 Total files dumped:     197
 Total pages dumped:    10342
DUMPER>EXIT
@DISMOUNT TAPE FOO:
[Tape dismounted, logical name FOO: deleted]

3. Printing a directory of files on tape:

@MOUNT TAPE TEST1: /READ-ONLY /LABEL-TYPE:ANSI /VOLUME-SET:SMAYO
[Mount request TEST1 queued, request #23]

[Tape set TEST1, volume SMAYO mounted]
[TEST1: defined as MT0:]
@DUMPER
DUMPER>TAPE TEST1:
DUMPER>REWIND
DUMPER>PRINT
^L
 DUMPER tape #1, Tue 26-Jun-84 1504.  "Version 7.0"  volid DTEST
     Filename                                               Last write date     
Pages               Checksum      Page #1


     SNARK:<RANDOM>ADVISE.MAC.27			    25-Nov-82 1130	
6
     SNARK:<RANDOM>BOOTUP.EXE.1				    27-Apr-84 1304	
30
     SNARK:<RANDOM>CRASH.LOG.29762			    31-Dec-99 1117	
1
     SNARK:<RANDOM>FOO.BAR.1				    23-Apr-74 0104	
21
     SNARK:<RANDOM>GI.GO.9				    26-Nov-79 1102	
3
     SNARK:<RANDOM>INDEX.FILES.7			    12-Apr-84 1438	
22
     SNARK:<RANDOM>TH-TH-THATS.ALL-FOLKS.222		    22-Jan-81 0905	
6

 End of Tape.
DUMPER>REWIND
DUMPER>RESTORE SNARK:<RANDOM>*.*.*
Saveset "Version 7.0"
 End of Tape.

 Number of files skipped:     7
DUMPER>REWIND
DUMPER>EXIT
@DISMOUNT TAPE TEST1:
[Tape dismounted, logical name TEST1: deleted]
@

4.  Interrupting and aborting, showing each filename as it is being written:

@MOUNT TAPE BACKUP: /WRITE-ENABLED /LABEL-TYPE:ANSI
[Mount request BACKUP: queued, request #24]

[Tape set BACKUP, volume BACKUP mounted]
[BACKUP: defined as MT0:]
@DUMPER
DUMPER>TAPE BACKUP:
DUMPER>SSNAME Backup of 27-Jun-84 18:00
DUMPER>FILES
DUMPER>SAVE FLOAT:<GUMBY>A*.*.* (AS) SNARK:<THALI>A*.*.* 

 DUMPER tape #1, Tue 26-Jun-84 1510, volid TEST1

 FLOAT:<GUMBY> (as) SNARK:<THALI>
   FLOAT:<GUMBY>ACCESS.EXE.1 (as) SNARK:<THALI>ACCESS.EXE.1
   FLOAT:<GUMBY>ACL.EXE.1 (as) SNARK:<THALI>ACL.EXE.1
   FLOAT:<GUMBY>ADJPSX.EXE.1 (as) SNARK:<THALI>ADJPSX.EXE.1
   FLOAT:<GUMBY>ADJPSX.HLP.1 (as) SNARK:<THALI>ADJPSX.HLP.1
   FLOAT:<GUMBY>AID.EXE.1 (as) SNARK:<THALI>AID.EXE.1
   FLOAT:<GUMBY>ALU.EXE.1 (as) SNARK:<THALI>ALU.EXE.1
   FLOAT:<GUMBY>ALUF.EXE.1 (as) SNARK:<THALI>ALUF.EXE.1
   FLOAT:<GUMBY>ASCII.EXE.1 (as) SNARK:<THALI>ASCII.EXE.1 ^E
Interrupting...
DUMPER>>ABORT (SAVE)
 Aborting SAVE command...
DUMPER>EXIT
@DISMOUNT TAPE BACKUP:
[Tape dismounted, logical name BACKUP: deleted]
@
			[End of DUMPER.HLP 23-Jan-85]