  I This directory contains the sources and EXE for DUMPER-32.   DUMPER-32 is I a utility written by Robert McQueen and Nick Bush at Stevens Institute of J Technology, for reading TOPS-10 BACKUP and TOPS-20 DUMPER tapes under VMS.K 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.   G This is a version derived from version 1.0-003 on the Integration Tools F tape (from the directory [TOOLS.DUMPER013]).  This version contains 29H edits added by James Harvey at Indiana University - Purdue University atK Indianapolis, mostly to make DUMPER-32 read labeled version 5 and 6 TOPS-20 I DUMPER tapes.  This version has been tested using DUMPER format version 6 C tapes written by DUMPER version 6(542) under TOPS-20 version 6.1 at H IUPUI.  The program was also tested with an unlabeled BACKUP format tapeL written under TOPS-10 version 6.03.  All tests were run on a VAX 8800 system under VMS version 4.6.    E If you are getting this via anonymous FTP, you will want at least the  following files:  
 DUMPER.CLDA 	The Command Language Definition Utility file for the command for 8 	running DUMPER-32 (BAKDMP).  Tranfer this in text mode.  
 DUMPER.EXE> 	The executable file for the utility.  Transfer this in binary 	(image) mode.  
 DUMPER.HLP 	The help file.     . Problems fixed (in the original SI_DUMPER013):  ? o	Version 5 and 6 TOPS-20 DUMPER tapes are now supported.  What C 	this means is that DUMPER-32 can now handle: (1) unlabeled TOPS-20 D 	DUMPER tapes with  (version 4-5) or without (version 3-) file marksA 	between the savesets, (2) labeled TOPS-20 DUMPER tapes with file ? 	labels around each saveset (version 4-5-6), (3) TOPS-20 DUMPER C 	tape volume switches at logical EOT (version 4-5) or when a TONEXT  	record is seen (version 6).  C 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 toA 	read through all the reels of a four-volume set, for example, if 2 	you know the file you want is on the last volume.  < o	Files split across tape volumes are now properly restored.  C o	Many fixes to cure DUMPER-32's habit of blowing off with a status 9 	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:   E o	Digital had Stevens modify the program in version 1.0-003 to always A 	restore 36-bit files as text files.  This is usually the desired A 	action, but the modification left no way to restore 36-bit files B 	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; IA 	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.COMC 	Canned procedure to restore a single DUMPER saveset to the current  	default directory.   
 DUMPER.COM3 	Compiles and links DUMPER.EXE.  Used by BUILD.COM.    DUMPER_DEBUG.COM9 	Compiles and links DUMPER_DEBUG.EXE.  Used by BUILD.COM.    INSTALL.COM + 	Used to re-install DUMPER.EXE after a fix.   
 KITINSTAL.COM 7 	Original installation COM file from Stevens Institute.     H The DUMPER-32 source files are described quite well in the program logicG manual written at Stevens, DUMPER_FUNC_SPEC.MEM.  The source files are:   
 DUMPER.BLIA 	Main routine.  Contains the calls to the command processing, and  	some general subroutines.  
 DUMPER.CLDB 	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.BLID 	Main data type conversion routines.  Converts 36 bit text, numbers,D 	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 A 	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 5 	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 that1 	would otherwise conflict with the DUMP command).   
 DUMPER.RNO9 	RUNOFF source for document describing uses of DUMPER-32.    IUPUI_REVISION_HISTORY.TXT@ 	Descriptions of IUPUI revisions (there are also module-specific8 	descriptions in the revision histories of each module).   NEWSLETTER.RNO< 	RUNOFF source for a newsletter article we did on DUMPER-32.   THINGS_TO_DO.MEMA 	Description of remaining known bugs/restrictions and a DUMPER-32  	wish list. 