1 DUMPER
  DUMPER-32 is a utility for reading tapes written by TOPS-10 BACKUP or
  TOPS-20 DUMPER.  DUMPER-32 does not write tapes.

  DUMPER-32 is invoked by one of the following DCL commands:

        $ DUMPER32 [qualifiers] input-tape output-spec
        $ DUMPER32 /LIST[=filespec] [qualifiers] input-tape

2 Parameters
  input-tape

    The "input-tape" parameter should name the tape to be read.

  output-spec

    The "output-spec" parameter should specify the name(s) to be given to
    the file(s) restored.  The default is to write the files to directories
    specified by the directory information on the tape.  If these
    directories do not exist, you should specify at least the device and
    directory name (for example, SYS$DISK:[ITST000] if your access code
    name is ITST000.  SYS$DISK is always defined to be the disk that your
    login directory is on).

2 Qualifiers
/BINARY
  /BINARY
  /NOBINARY (default)

    This qualifier causes files with a 36-bit word size to be restored in
    "binary" mode.  The resulting file will be written using variable
    length records up to 510 bytes in size, with no carriage control.  Each
    36-bit word from the original file is stored in 5 successive 8-bit
    bytes in the VAX disk file as shown in the diagram below:

         3333332   2222222   2211111   1111100   0000000  0
         5432109   8765432   1098765   4321098   7654321  0
         !     !   !     !   !     !   !     !   !     !  /
         !     !   !     !   !     !   !     !  !+-----!-/
         !     !   !     !   !     !   !     !  !!     !
        76543210  76543210  76543210  76543210  76543210

    The leftmost five seven-bit fields from each 36-bit word are stored
    right justified in five 8-bit bytes in the VAX disk file.  The
    remaining least significant bit of the 36-bit word is stored in the
    most significant bit of the fifth byte.

    This format will preserve all the bits from the TOPS-10 or TOPS-20
    file.  Note, however, that binary files from TOPS-10 and TOPS-20 cannot
    be used with any of the VAX/VMS utilities.

/BLOCKING_FACTOR
  /BLOCKING_FACTOR=number

    The /BLOCKING_FACTOR qualifier is used to specify the value of SET
    BLOCK that was used when creating the tape; that is, the number of
    logical blocks per physical block on the tape.  The default is 1.

/CREATE_DIRECTORY
  /CREATE_DIRECTORY
  /NOCREATE_DIRECTORY (default)

    This qualifier indicates that directories are to be created as
    necessary while restoring files.  By default, directories are not
    created.

/FORMAT
  /FORMAT[=keyword]

    This qualifier specifies the format of the input tape.  The default
    format is INTERCHANGE.

      BACKUP

        This indicates that the tape was written in TOPS-10 BACKUP native
        mode.

      DUMPER

        This indicates that the tape was written in TOPS-20 DUMPER native
        mode.

      INTERCHANGE

        This indicates that the tape was written in either TOPS-10 BACKUP
        INTERCHANGE mode or TOPS-20 DUMPER INTERCHANGE mode.

/LIST
  /LIST[=output-file]

    This qualifier indicates that files are not to be restored; rather, a
    listing of the files in the next saveset is to be written to
    "output-file".  The default "output-file" is the user's terminal.

/LOG
  /LOG[=keyword]

    This qualifier indicates that certain events should be logged on the
    user's terminal.  Events include file restoration and directory
    creation.  The default keyword is FILES.

      ALL

        This indicates that all events should be logged.

      DIRECTORIES

        This indicates that directory creations should be logged.

      FILES

        This indicates that file creations should be logged.

/REMOVE_LSNS
  /REMOVE_LSNS (default)
  /NOREMOVE_LSNS

    This qualifier indicates that any EDIT or SOS line sequence numbers
    should be removed when restoring text files.  The default is to always
    remove line sequence numbers from text files.

/REWIND
  /REWIND
  /NOREWIND (default)

    This qualifier indicates that the tape should be rewound before
    reading.

/SELECT
  /SELECT[=file-specification]

    This qualifier indicates that only certain files should be restored.
    The "file-specification" may contain wildcards; only files matching the
    given specification will be restored.  The default specification is
    "*.*.*".

/SKIP
  /SKIP[=number]

    This qualifier causes a number of savesets to be skipped before
    reading.  The default number is 1.

/SSNAME
  /SSNAME[=saveset-name]

    This qualifier indicates that the tape is to be searched for the named
    saveset.  The default "saveset-name" is ALL.  If /SSNAME is not given,
    the default is to read the next saveset on the tape.

2 Examples

  To list the files on the tape mounted on HSC000$MUA0: to your terminal:

        $ DUMPER32/LIST/FORMAT=DUMPER HSC000$MUA0

  To list the files on the tape mounted on a drive with the logical name
  TAPE, placing the output in a file MYTAPE.LIS:

        $ DUMPER32/LIST=MYTAPE.LIS/FORMAT=DUMPER TAPE:

  To restore all files from TAPE to the directory [ITST000] on your default
  disk:

        $ DUMPER32/FORMAT=DUMPER TAPE: SYS$DISK:[ITST000]

  To restore all FORTRAN source files from OLDIE to a subdirectory GOODIES:

        $ DUMPER32/FORMAT=DUMPER/SELECT=*.FOR OLDIE: SYS$DISK:[.GOODIES]

2 DMOUNT

  The DMOUNT command may be used to mount TOPS-20 labeled DUMPER tapes for
  reading by DUMPER32.  The DMOUNT command functions similarly to the MOUNT
  command.  The only parameters you have to provide are the volume i.d.
  and the visual i.d.  for the tape.  DMOUNT will mount the tape on a free
  drive, and define the logical name DUMPER for that drive.

        $ DMOUNT volume-id "visual-id"

3 Parameters

  volume-id

    This is the volume identifier for the TOPS-20 tape.  This is commonly
    "D0" followed by a four digit number, for example, D04907.

  "visual-id"

    The visual id is provided to the operator who mounts the tape for added
    security, for example, "Dr.  Jones' SPSS tape".

3 Examples

  To mount the volume D04907 using the visual i.d.  "Dr.  Jones' SPSS
  tape":

        $ DMOUNT D04907 "Dr. Jones' SPSS tape"
        %MOUNT-I-OPRQST, Please mount volume D04907 in device _ATLAS$MUA0:
        Dr. Jones' SPSS tape - READ ONLY
        %MOUNT-I-OPRQSTCAN, operator request canceled
        $

  The "request canceled" message indicates that the operator mounted the
  tape (if the mount was refused, a "request aborted" message would appear
  instead).  If no tape drive is currently available, DMOUNT will indicate
  this with a message.

3 Dismounting

  After you have finished with the tape, you should dismount it with the
  command:

        $ DISMOUNT DUMPER:

2 DRESTORE

  The DRESTORE command executes a command procedure that runs the DUMPER32
  program to restore files from a TOPS-20 DUMPER tape that was mounted
  using the DMOUNT command.  It assumes that the tape is mounted on a tape
  drive with the logical name DUMPER.

  The following commands may be used to invoke the DRESTORE command
  procedure:

        $ DRESTORE
        $ DRESTORE n

  where n is the number of the saveset on the tape that is to be restored.
  By default, if no number is given, DRESTORE will list the names of all of
  the files on the tape into the file DRESTORE.LIS in your current default
  directory, and restore all of the files from the first saveset on the
  tape into your current default directory.
