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.