% VAX-11 Librarian V04-00 5@8`[85 DUMPER`[81 DUMPERG DUMPER-32 is a utility for reading tapes written by TOPS-10 BACKUP or2 TOPS-20 DUMPER. DUMPER-32 does not write tapes.< DUMPER-32 is invoked by one of the following DCL commands:6 $ DUMPER32 [qualifiers] input-tape output-spec; $ DUMPER32 /LIST[=filespec] [qualifiers] input-tape 2 Parameters input-tape? The "input-tape" parameter should name the tape to be read. output-specI The "output-spec" parameter should specify t he name(s) to be given toK the file(s) restored. The default is to write the files to directoriesA specified by the directory information on the tape. If theseH directories do not exist, you should specify at least the device andG directory name (for example, SYS$DISK:[ITST000] if your access codeI name is ITST000. SYS$DISK is always defined to be the disk that your login directory is on). 2 Qualifiers/BINARY /BINARY /NOBINARY (default)I This quali fier causes files with a 36-bit word size to be restored inE "binary" mode. The resulting file will be written using variableK length records up to 510 bytes in size, with no carriage control. EachF 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:; 3333332 2222222 2211111 1111100 0000000 0; 5432109 8765432 1098765 4321098 7654321 0; ! ! ! ! ! ! ! ! ! ! /: ! ! ! ! ! ! ! ! !+-----!-/8 ! ! ! ! ! ! ! ! !! !8 76543210 76543210 76543210 76543210 76543210G The leftmost five seven-bit fields from each 36-bit word are storedB right justified in five 8-bit bytes in the VAX disk file. TheG remaining least significant bit of the 36-bit word is stored in the+ most significant bit of the fifth byte.F This format will preserve all  the bits from the TOPS-10 or TOPS-20K file. Note, however, that binary files from TOPS-10 and TOPS-20 cannot. be used with any of the VAX/VMS utilities./BLOCKING_FACTOR /BLOCKING_FACTOR=numberF The /BLOCKING_FACTOR qualifier is used to specify the value of SETF BLOCK that was used when creating the tape; that is, the number ofE logical blocks per physical block on the tape. The default is 1./CREATE_DIRECTORY /CREATE_DIRECTORY /NOCREATE_DIRECTORY (default) B This qualifier indicates that directories are to be created asE necessary while restoring files. By default, directories are not created./FORMAT /FORMAT[=keyword]G This qualifier specifies the format of the input tape. The default format is INTERCHANGE. BACKUPI This indicates that the tape was written in TOPS-10 BACKUP native mode. DUMPERI This indicates that the tape was written in TOPS-20 DUMPER native  mode. INTERCHANGEI This indicates that the tape was written in either TOPS-10 BACKUP< INTERCHANGE mode or TOPS-20 DUMPER INTERCHANGE mode./LIST /LIST[=output-file]I This qualifier indicates that files are not to be restored; rather, a@ listing of the files in the next saveset is to be written toE "output-file". The default "output-file" is the user's terminal./LOG /LOG[=keyword]H This qualifier indicates that certain events should be logged on theC user's terminal. Events include file restoration and directory, creation. The default keyword is FILES. ALL8 This indicates that all events should be logged. DIRECTORIESA This indicates that directory creations should be logged. FILES< This indicates that file creations should be logged. /REMOVE_LSNS /REMOVE_LSNS (default) /NOREMOVE_LSNSG This qualifier indicates that any EDIT or SOS line sequence numbersJ should be removed when restoring text files. The default is to always1 remove line sequence numbers from text files./REWIND /REWIND /NOREWIND (default)C This qualifier indicates that the tape should be rewound before reading./SELECT /SELECT[=file-specification]H This qualifier indicates that only certain files should be restored.K The "file-specification" may contain wildcards; only files matching theG given specification will be restored. The default specification is "*.*.*"./SKIP /SKIP[=number]C This qualifier causes a number of savesets to be skipped before& reading. The default number is 1./SSNAME /SSNAME[=saveset-name]J This qualifier indicates that the tape is to be searched for the namedJ saveset. The default "saveset-name" is ALL. If /SSNAME is not given,8 the default is to read the next saveset on the tape. 2 ExamplesI To list the files on the tape mounted on HSC000$MUA0: to your terminal:1 $ DUMPER32/LIST/FORMAT=DUMPER HSC000$MUA0H To list the files on the tape mounted on a drive with the logical name0 TAPE, placing the output in a file MYTAPE.LIS:6 $ DUMPER32/LIST=MYTAPE.LIS/FORMAT=DUMPER TAPE:K To restore all files from TAPE to the directory [ITST000] on your default disk:9 $ DUMPER32/FORMAT=DUMPER TAPE: SYS$DISK:[ITST000]K To restore all FORTRAN source files from OLDIE to a subdirectory GOODIES:H  $ DUMPER32/FORMAT=DUMPER/SELECT=*.FOR OLDIE: SYS$DISK:[.GOODIES]2 DMOUNTJ The DMOUNT command may be used to mount TOPS-20 labeled DUMPER tapes forK reading by DUMPER32. The DMOUNT command functions similarly to the MOUNTG command. The only parameters you have to provide are the volume i.d.J 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.& $ DMOUNT volume-id "visual-id" 3 Parameters volume-idI This is the volume identifier for the TOPS-20 tape. This is commonly> "D0" followed by a four digit number, for example, D04907. "visual-id"K The visual id is provided to the operator who mounts the tape for added3 security, for example, "Dr. Jones' SPSS tape". 3 ExamplesE To mount the volume D04907 using the visual i.d. "Dr. Jones' SPSS tape":. $ DMOUNT D04907 "Dr. Jones' SPSS tape"J %MOUNT-I-OPRQST, Please mount volume D04907 in device _ATLAS$MUA0:( Dr. Jones' SPSS tape - READ ONLY5 %MOUNT-I-OPRQSTCAN, operator request canceled $H The "request canceled" message indicates that the operator mounted theJ tape (if the mount was refused, a "request aborted" message would appearJ instead). If no tape drive is currently available, DMOUNT will indicate this with a message. 3 DismountingH After you have finished with the tape, you should dismount it with the command: $ DISMOUNT DUMPER: 2 DRESTOREJ The DRESTORE command executes a command procedure that runs the DUMPER32F program to restore files from a TOPS-20 DUMPER tape that was mountedJ using the DMOUNT command. It assumes that the tape is mounted on a tape% drive with the logical name DUMPER.C The following commands may be used to invoke the DRESTORE command procedure: $ DRESTORE $ DRESTORE nJ where n is the number of the saveset on the tape that is to be restored.K By default, if no number is given, DRESTORE will list the names of all ofJ the files on the tape into the file DRESTORE.LIS in your current defaultG directory, and restore all of the files from the first saveset on the+ tape into your current default directory.ww