Click on FTP to download from the FTP archives.
![[FTP]](http://www2.encompassus.org/hidedecus/graphics/i_ftp.gif)
This directory contains the sources and EXE for DUMPER-32. DUMPER-32 is
a utility written by Robert McQueen and Nick Bush at Stevens Institute of
Technology, for reading TOPS-10 BACKUP and TOPS-20 DUMPER tapes under VMS.
BACKUP and DUMPER "interchange" mode tapes are also can be read. Note that
DUMPER-32 only reads tapes, it cannot be used to write tapes.
This is a version derived from version 1.0-003 on the Integration Tools
tape (from the directory [TOOLS.DUMPER013]). This version contains 29
edits added by James Harvey at Indiana University - Purdue University at
Indianapolis, mostly to make DUMPER-32 read labeled version 5 and 6 TOPS-20
DUMPER tapes. This version has been tested using DUMPER format version 6
tapes written by DUMPER version 6(542) under TOPS-20 version 6.1 at
IUPUI. The program was also tested with an unlabeled BACKUP format tape
written under TOPS-10 version 6.03. All tests were run on a VAX 8800 system
under VMS version 4.6.
Problems fixed:
o Version 5 and 6 TOPS-20 DUMPER tapes are now supported. What
this means is that DUMPER-32 can now handle: (1) unlabeled TOPS-20
DUMPER tapes with (version 4-5) or without (version 3-) file marks
between the savesets, (2) labeled TOPS-20 DUMPER tapes with file
labels around each saveset (version 4-5-6), (3) TOPS-20 DUMPER
tape volume switches at logical EOT (version 4-5) or when a TONEXT
record is seen (version 6).
o DUMPER-32 now allows reading to begin on a TOPS-20 DUMPER tape at
a continued-saveset record. This means you no longer have to
read through all the reels of a four-volume set, for example, if
you know the file you want is on the last volume.
o Files split across tape volumes are now properly restored.
o Many fixes to cure DUMPER-32's habit of blowing off with a status
of FALSE ("message number 000000") and no other message.
o Trying to restore binary files (e.g., .EXEs) no longer causes
DUMPER-32 to die with an RMS record length error. A warning
message is issued and the restore continues.
o The /SSNAME and /SKIP qualifiers now work. Skipping backwards
on labeled TOPS-20 DUMPER tapes is still not supported however.
o The /LOG=DIRECTORIES qualifier now works.
New enhancements:
o Digital had Stevens modify the program in version 1.0-003 to always
restore 36-bit files as text files. This is usually the desired
action, but the modification left no way to restore 36-bit files
as binary files. A /BINARY qualifier has been added to allow you
to force the restoration of 36-bit files as binary files rather
than text files. /NOBINARY is the default, which causes 36-bit
files to be restored as text files.
o A /REMOVE_LSNS qualifier causes EDIT/SOS-style line numbers
to be removed when restoring text files. /REMOVE_LSNS is the
default. The previous behaviour, which caused the line number
to show up in the file as plain text, may be preserved by using
/NOREMOVE_LSNS.
o An on-line HELP file has been written for the BAKDMP command
(command that runs DUMPER-32).
The COM files included are:
BUILD.COM
Builds production (DUMPER.EXE) and debugging (DUMPER_DEBUG.EXE)
EXE files. You will have to edit this to use at your site; I
was using it under batch and it has a SET DEFAULT command in it.
Also *WARNING* it deletes all the EXE, OBJ, and MAP files
before rebuilding DUMPER.
DLINK.COM
Links DUMPER with /DEBUG/TRACE.
DMOUNT.COM
Canned procedure to mount a TOPS-20 labeled tape for use with
DUMPER-32. Mounts the tape with /OVERRIDE=(ACC,OWN) on an
MU device (you might have to change this) and gives it the
logical name DUMPER.
DRESTORE.COM
Canned procedure to restore a single DUMPER saveset to the current
default directory.
DUMPER.COM
Compiles and links DUMPER.EXE. Used by BUILD.COM.
DUMPER_DEBUG.COM
Compiles and links DUMPER_DEBUG.EXE. Used by BUILD.COM.
INSTALL.COM
Used to re-install DUMPER.EXE after a fix.
KITINSTAL.COM
Original installation COM file from Stevens Institute.
The DUMPER-32 source files are described quite well in the program logic
manual written at Stevens, DUMPER_FUNC_SPEC.MEM. The source files are:
DUMPER.BLI
Main routine. Contains the calls to the command processing, and
some general subroutines.
DUMPER.CLD
Command line definition file. This is the file that is used with
the DCL command SET COMMAND to define the command to invoke the
utility (note: this one has the definitions for the /BINARY and
/REMOVE_LSNS qualifiers added).
DUMPER_DRIVER.BLI
Main restore and list driver routines.
DUMPER_CVT.BLI
Main data type conversion routines. Converts 36 bit text, numbers,
bytes, etc into text descriptors, characters and valid 32 bit data.
DUMPER_LIST.BLI
Main listing routines.
DUMPER_TAPE_IO.BLI
Tape I/O processing routines. These are the routines that will
read the data from the tape.
DUMPER_FILE.BLI
File output routines. These routines provide for setting of the
various file attributes, creating the file and writing the data
into the file.
DUMPER_BACKUP_TAPE.BLI
This module provides the basic support for reading a BACKUP-10
written tape.
DUMPER_DUMPER_TAPE.BLI
This module provides the basic support for reading a DUMPER-20
written tape.
CHARACTER_DEFINITIONS.REQ
Symbol definitions for control characters.
DUMPER_SYMBOLS.REQ
Macro and symbol definitions used in all of the various modules
found in the utility.
TAPE_FORMAT.REQ
Macros and symbols that define the format of a tape.
DUMPER_ERROR.MSG
Message file that contains all of the DUMPER specific messages
that are signalled.
Other miscellaneous files include:
DUMPER.RNH
RUNOFF source for DUMPER help topic. Note command documented
is DUMPER32, you might want to change that to BAKDMP (here we
defined a symbol DUMPE*R32 :== BAKDMP/FORMAT=DUMPER, sort of a
cheap way of changing the default, an giving it a name that
would otherwise conflict with the DUMP command).
DUMPER.RNO
RUNOFF source for document describing uses of DUMPER-32.
IUPUI_REVISION_HISTORY.TXT
Descriptions of IUPUI revisions (there are also module-specific
descriptions in the revision histories of each module).
NEWSLETTER.RNO
RUNOFF source for a newsletter article we did on DUMPER-32.
THINGS_TO_DO.MEM
Description of remaining known bugs/restrictions and a DUMPER-32
wish list.
Click on FTP to download from the FTP archives.