There are 32 other files named dumper.doc in the archive. Click here to see a list.
DUMPER.DOC -- Changes from V4(407) to V6(528)
COPYRIGHT (C) 1976,1979,1982,1985 BY
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER
COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY
OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
DUMPER is a program for saving and restoring disk files using magtape.
It is used by operations personnel for file system maintenance, and
may be employed by users who wish to keep certain files on magtape
and/or transfer them between systems.
DUMPER version 6(528) runs on TOPS-20 Release 6.
DUMPER does not require any other software modules during execution.
DUMPER is documented in the TOPS-20 User's Guide, and some privileged
functions are described in the TOPS-20 Operator's Guide and TOPS-20
System Manager's Guide.
You should read the DUMPER.BWR file. There are many important changes
to 6(528) that you should be aware of.
2.0 EXTERNAL CHANGES
1. The new DUMPER should SAVE files with less CPU use than it used to.
This shows up especially in /INCREMENTAL and /FULL incremental commands,
ARCHIVAL, and other "special saves". CHECK and RESTORE should also be
2. Several new save commands exist. ARCHIVE is equivalent to SAVE/ARCHIVE,
and MIGRATE does a SAVE/MIGRATE.
ABORT, previously mentioned, is available after typing ^E to interrupt a
3. The new TRANSFER command acts like RESTORE, except that the defaults are
TRANSFER DSK*:<*>*.*.* (as) *.*.*; ie, restore everything from anywhere
into your connected directory.
4. The LIST command has two new options, /MAIL and /NOMAIL. /NOMAIL is the
default and does a normal LIST file. /MAIL is used to write the file
you feed to the new MAIL command. The /MAIL option makes only small changes
to the listfile. The default LIST/MAIL file is DUMPER-MAIL.TXT
Also, the list file format is slightly cleaner.
5. The MAIL command will take a file written by LIST/MAIL and send mail to
the owners of the files mentioned therein. This takes the place of
the automatic mail sent by the old version of the Retrieve command; ie,
you don't have to have the mail if you don't want it. If you do, you
would type (before the retrieve) LIST/MAIL and (after the retrieve)
MAIL. This command types to the terminal what it sends to each user.
This mechanism can be used with ANY kind of SAVE and the RETRIEVE command.
6. Several new NO commands exist, these being the date setting commands
(ABEFORE, MSINCE, etc), and NO DATES, which clears all the dates at
7. At the end of a save command, the CPU time used is printed, for those
interested in tuning DUMPER. Timing starts after parsing all filespecs
in the command line (ie, after the command is confirmed) and continues
through everything (including pass 2, if one is needed).
8. A new command, EXACT, is available under conditional assembly. When
given, the SAVE command will not expand the logical name given
explicitly as the second filespec (the "as" filespec), as it would
normally do. This means that, if you have PS: defined to be FOOBAR:,
in EXACT mode the command SAVE ME:*.* (AS) PS:<YOU>*.* would write
the files on tape as saved from PS:<YOU>, instead of FOOBAR:<YOU>.
It has a similiar effect on the first filename in a RESTORE command.
9. PRINT has gained a /FAST switch. This tries to write a print file that
fits in 80 columns/line without losing any information. Hence, P/F<CR>
should type a neater list to the terminal.
10. ^A types out more information than it used to in some cases. It types
out the last seen filename on the tape more consistantly than old DUMPER
did, among other things.
11. DUMPER has several Feature Test switches that can be used to increase
its speed or affect other changes. A list of these, and the ramifications
of changing them, are listed in DUMPER.BWR.
3.0 KNOWN BUGS AND DEFICIENCIES
1. Reverse SKIPs with labeled tape does not work.
2. Interchange tapes written in DUMPER cannot be read past the
first saveset by BACKUP. Therefore a restriction of one
saveset per tape exists.
4.0 INSTALLATION INSTRUCTIONS
4.1 Files Needed to Run DUMPER
DUMPER consists of one file, DUMPER.EXE.
4.2 Instructions for Loading and Installing DUMPER
Mount the tape labeled Installation Tape on MTA0: and type the
SKIP MTA0:5 FILES
RESTORE <*>DUMPER.EXE (TO) SYS:*.*.-1
4.3 Files Needed for Build DUMPER
DUMPER is built from the following files:
In addition, the following files must be on SYS:
4.4 Instructions for Building DUMPER
Mount the tape labeled Distribution Tape on MTA0: and type the
RESTORE <*>*.*.* (TO) <self>*.*.*
4.5 Special Considerations
DUMPER is used during the initial phases of system installation
and file structure refreshing. For this reason, it is advisable
to have a copy of DUMPER on one or more magtapes. DUMPER may be
put on magtape by:
@ASSIGN MTAn: ! assign and mount blank tape
@REWIND MTAn: ! put DUMPER at beginning
@COPY SYS:DUMPER.EXE (TO) MTAn: ! copy to tape
DUMPER may be loaded and run directly from a magtape generated in this
DUMPER is intended to perform a number of privileged functions when
run by operations personnel, and its behavior is modified slightly
when running with WHEEL or OPERATOR capabilities enabled. Consult
TOPS-20 User's Guide and TOPS-20 Operator's Guide for additional
5.0 INTERNAL CHANGES
Refer to the history in DUMPER.MAC for detailed information
about changes, and carefully read DUMPER.BWR as well.
DUMPER can be customized in various ways to increase its speed. Notes
on this can be found in DUMPER.MAC.