.set paragraph 0,1,3
.ap.lm2.rm75.nj.f
.i-2;1#DUMPER
.br
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:
.s1.lit
	$ DUMPER32 [qualifiers] input-tape output-spec
	$ DUMPER32 /LIST[=filespec] [qualifiers] input-tape
.end lit.s1
.i-2;2#Parameters
.lm+2
.br
.i-2;input-tape

The "input-tape" parameter should name the tape to be read.
.s1
.i-2;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).
.lm-2
.s1
.i-2;2#Qualifiers
.lm+2
.br
.i-4;/BINARY
.i-2;/BINARY
.i-2;/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:
.s1.lit
	 3333332   2222222   2211111   1111100   0000000  0
	 5432109   8765432   1098765   4321098   7654321  0
	 !     !   !	 !   !	   !   !     !	 !     !  /
	 !     !   !	 !   !	   !   !     !	!+-----!-/
	 !     !   !	 !   !	   !   !     !	!!     !
	76543210  76543210  76543210  76543210  76543210
.end lit.s1
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.
.s1
.i-4;/BLOCKING__FACTOR
.i-2;/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.
.s1
.i-4;/CREATE__DIRECTORY
.i-2;/CREATE__DIRECTORY
.i-2;/NOCREATE__DIRECTORY (default)

This qualifier indicates that directories are to be created as
necessary while restoring files.  By default, directories are not
created.
.s1
.i-4;/FORMAT
.i-2;/FORMAT[=keyword]

This qualifier specifies the format of the input tape.  The default
format is INTERCHANGE.
.s1
.lm+4
.i-2;BACKUP

This indicates that the tape was written in TOPS-10 BACKUP
native mode.
.s1
.i-2;DUMPER

This indicates that the tape was written in TOPS-20 DUMPER
native mode.
.s1
.i-2;INTERCHANGE

This indicates that the tape was written in either TOPS-10
BACKUP INTERCHANGE mode or TOPS-20 DUMPER INTERCHANGE mode.
.lm-4
.s1
.i-4;/LIST
.i-2;/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.
.s1
.i-4;/LOG
.i-2;/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.
.lm+4
.s1
.i-2;ALL

This indicates that all events should be logged.
.s1
.i-2;DIRECTORIES

This indicates that directory creations should be logged.
.s1
.i-2;FILES

This indicates that file creations should be logged.
.lm-4
.s1
.i-4;/REMOVE__LSNS
.i-2;/REMOVE__LSNS (default)
.i-2;/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.
.s1
.i-4;/REWIND
.i-2;/REWIND
.i-2;/NOREWIND (default)

This qualifier indicates that the tape should be rewound before
reading.
.s1
.i-4;/SELECT
.i-2;/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 "*.*.*".
.s1
.i-4;/SKIP
.i-2;/SKIP[=number]

This qualifier causes a number of savesets to be skipped before
reading.  The default number is 1.
.s1
.i-4;/SSNAME
.i-2;/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.
.lm-2
.s1
.i-2;2#Examples

To list the files on the tape mounted on HSC000$MUA0_: to your terminal:
.s1.lit
	$ DUMPER32/LIST/FORMAT=DUMPER HSC000$MUA0
.end lit.s1
To list the files on the tape mounted on a drive with the logical name
TAPE, placing the output in a file MYTAPE.LIS:
.s1.lit
	$ DUMPER32/LIST=MYTAPE.LIS/FORMAT=DUMPER TAPE:
.end lit.s1
To restore all files from TAPE to the directory [ITST000] on your
default disk:
.s1.lit
	$ DUMPER32/FORMAT=DUMPER TAPE: SYS$DISK:[ITST000]
.end lit.s1
To restore all FORTRAN source files from OLDIE to a subdirectory
GOODIES:
.s1.lit
	$ DUMPER32/FORMAT=DUMPER/SELECT=*.FOR OLDIE: SYS$DISK:[.GOODIES]
.end lit.s1
.i-2;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.
.s1.lit
	$ DMOUNT volume-id "visual-id"
.end lit.s1
.i-2;3#Parameters
.lm+2
.s1
.i-2;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.
.s1
.i-2;"visual-id"

The visual id is provided to the operator who mounts the tape for
added security, for example, "Dr. Jones' SPSS tape".
.lm-2
.s1
.i-2;3#Examples
.s1
To mount the volume D04907 using the visual i.d. "Dr. Jones' SPSS
tape":
.s1.lit
	$ 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
	$
.end lit.s1
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.
.s1
.i-2;3#Dismounting

After you have finished with the tape, you should dismount it with
the command:
.s1.lit
	$ DISMOUNT DUMPER:
.end lit.s1
.i-2;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:
.s1.lit
	$ DRESTORE
	$ DRESTORE n
.end lit.s1
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.