Using DUMPER-32


DUMPER-32 is a VAX/VMS utility for reading TOPS-20 DUMPER tapes.  A
previous newsletter article described how to use the DRESTORE command to
restore all the files from the first saveset on a DUMPER tape to your
default directory on the VAX.  This article describes how to skip
savesets and restore selected files from a DUMPER tape to your directory
on the VAX.

First you must mount the tape to be read.  Use the DMOUNT command to do
this.  DMOUNT takes a volume i.d. and a visual i.d. as arguments.  For
example:

$ DMOUNT D09999 "Dr. Smith's research data"

The DMOUNT command creates a logical name DUMPER: which may be used to
refer to the tape.

The DCL foreign command "DUMPER" invokes the VAX/VMS DUMPER-32 utility.
DUMPER-32 does not have a command language like the TOPS-20 DUMPER
utility.  It may only be invoked from DCL command level by using the
DUMPER command.

The DUMPER command may be used to make a listing of savesets and files
on the tape or to restore files from the tape to the VAX.  The general
format of the DUMPER command is:

     $ DUMPER [qualifiers] input-tape [output-spec]

To make a listing of files on the tape, use the /LIST qualifier and do
not give the output-spec parameter.  To restore files from the tape to
the VAX, give the output-spec parameter and do not give the /LIST
qualifier.

DUMPER qualifiers are described in the VAX/VMS help library.  You can
give the command HELP DUMPER and select various DUMPER help topics, or
HELP DUMPER topic-name to get help on a particular topic.  For example,
the command:

     $ HELP DUMPER QUALIFIERS

will list out help for all of the DUMPER qualifiers.

When a DUMPER command is executed, DUMPER-32 performs the following
actions:

     1.  First, if a /REWIND qualifier was given, the tape is rewound to
         the beginning of the volume set.

     2.  Next, if the /SKIP qualifier was given, the number of savesets
         specified by the qualifier are skipped.  Note that /SKIP=n does
         not mean to skip to the beginning of the nth saveset, it means
         to skip n savesets.  A negative value for the /SKIP qualifier
         skips backwards through the tape.  A zero value for /SKIP
                                                                  Page 2


         positions to the beginning of the current saveset on a labeled
         tape.

     3.  Finally, the listing is made if the /LIST qualifier was given,
         otherwise DUMPER-32 looks for files to restore.  If a listing
         is being made, the following actions occur:

          o  If no /SSNAME qualifier was given, or it was given, but no
             name was specified, or if /SSNAME=ALL was specified, the
             rest of the tape volume set is listed.

          o  If the /SSNAME qualifier was given and a saveset name was
             specified, DUMPER-32 reads the tape until either the end of
             the tape or the specified saveset is found.  If the saveset
             is found, it is listed.  DUMPER-32 then exits and returns
             your process to DCL command level.

         If files are being restored, the /SSNAME qualifier works
         slightly differently:

          o  If /SSNAME=ALL was specified, files are restored from all
             savesets on the tape after the current postion.

          o  If the /SSNAME qualifier was not given, or was given
             without an argument, files are restored from one saveset.

          o  If the /SSNAME qualifier was given and a saveset name was
             specified, DUMPER-32 reads the tape until either the end of
             the tape or the specified saveset is found.  If the saveset
             is found, it is restored.  DUMPER-32 then exits and returns
             your process to DCL command level.

         If no /SELECT qualifier is given, all files from a saveset are
         restored.  If the /SELECT qualifier is given, only the files
         matching the file specification specified by the /SELECT
         qualifier are restored.  When DUMPER-32 compares saveset names,
         a name in uppercase compares as equal to the same name in
         lowercase.  Also, any surrounding quotes do not affect the
         comparision.


Examples:

All of the following examples assume that the DUMPER tape is mounted on
a drive with the logical name DUMPER:.

To list all files in all savesets on the tape to the terminal:

     $ DUMPER/REWIND/LIST/FORMAT=DUMPER DUMPER:

To list all files in all savesets on the tape to the file D09999.LIS in
the current default directory:

     $ DUMPER/REWIND/LIST=D09999.LIS/FORMAT=DUMPER DUMPER:
                                                                  Page 3


To list the third saveset on the tape to the file SAVE3.LIS:

     $ DUMPER/REWIND/SKIP=2/LIST=SAVE3.LIS/FORMAT=DUMPER DUMPER:

To restore all files from the third saveset on the tape to the VAX
directory [IJRS000], listing the names of all files restored to the
terminal (the "From:" and "To:" are prompts that DUMPER-32 outputs to
your terminal):

     $ DUMPER/REWIND/SKIP=2/LOG/FORMAT=DUMPER
     _From: DUMPER:
     _To: DISK:[IJRS000]

To restore the file MYPROG.FOR from the third saveset on the tape to the
VAX directory [IJRS000]:

    $ DUMPER/REWIND/SKIP=2/LOG/FORMAT=DUMPER/SELECT=MYPROG.FOR
     _From: DUMPER:
     _To: DISK:[IJRS000]

To restore all the files matching the file types .FOR and .DAT from the
third saveset on the tape to the VAX directory [IJRS000]:

    $ DUMPER/REWIND/SKIP=2/LOG/FORMAT=DUMPER/SELECT=*.FOR
     _From: DUMPER:
     _To: DISK:[IJRS000]

    $ DUMPER/SKIP=0/LOG/FORMAT=DUMPER/SELECT=*.DAT
     _From: DUMPER:
     _To: DISK:[IJRS000]

Note the lack of the /REWIND qualifier and the use of the zero value for
the /SKIP qualifier on the second DUMPER command in the last example.