.page size 58,72
.style headers 7,0,0,7,7,2,1
.set paragraph 0,1,3
.ap.lm0.rm72.nj.f
.center;Using DUMPER-32
.s2
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:
.s1.lit
$ DMOUNT D09999 "Dr. Smith's research data"
.end lit.s1
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:
.s1.lit
     $ DUMPER [qualifiers] input-tape [output-spec]
.end lit.s1
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:
.s1.lit
     $ HELP DUMPER QUALIFIERS
.end lit.s1
will list out help for all of the DUMPER qualifiers.

When a DUMPER command is executed, DUMPER-32 performs the following actions:
.list
.le
First, if a /REWIND qualifier was given, the tape is rewound to the
beginning of the volume set.
.le
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 positions to the beginning of the current saveset
on a labeled tape.
.le
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:
.list "o"
.le
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.
.le
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.
.end list
If files are being restored, the /SSNAME qualifier works slightly
differently:
.list "o"
.le
If /SSNAME=ALL was specified, files are restored from all savesets on
the tape after the current postion.
.le
If the /SSNAME qualifier was not given, or was given without an argument,
files are restored from one saveset.
.le
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.
.end list
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.
.end list
.s1
Examples:
.s1
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:
.s1.lit
     $ DUMPER/REWIND/LIST/FORMAT=DUMPER DUMPER:
.end lit.s1
To list all files in all savesets on the tape to the file
D09999.LIS in the current default directory:
.s1.lit
     $ DUMPER/REWIND/LIST=D09999.LIS/FORMAT=DUMPER DUMPER:
.end lit.s1
To list the third saveset on the tape to the file SAVE3.LIS:
.s1.lit
     $ DUMPER/REWIND/SKIP=2/LIST=SAVE3.LIS/FORMAT=DUMPER DUMPER:
.end lit.s1
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):
.s1.lit
     $ DUMPER/REWIND/SKIP=2/LOG/FORMAT=DUMPER
     _From: DUMPER:
     _To: DISK:[IJRS000]
.end lit.s1
To restore the file MYPROG.FOR from the third saveset on the tape
to the VAX directory [IJRS000]:
.s1.lit
    $ DUMPER/REWIND/SKIP=2/LOG/FORMAT=DUMPER/SELECT=MYPROG.FOR
     _From: DUMPER:
     _To: DISK:[IJRS000]
.end lit.s1
To restore all the files matching the file types .FOR and .DAT from
the third saveset on the tape to the VAX directory [IJRS000]:
.s1.lit
    $ 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]
.end lit.s1
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.