Enter your search terms Submit search form
	Web pdp-10.trailing-edge.com

DUMPER.DOC -- Changes from V3A(172) to V4(303)
October 1981






























COPYRIGHT (C) 1976,1979,1982 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
TRANSFERRED.

THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE  WITHOUT  NOTICE
AND  SHOULD  NOT  BE  CONSTRUED  AS  A COMMITMENT BY DIGITAL EQUIPMENT
CORPORATION.

DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR  RELIABILITY  OF  ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.

DMR4.DOC                                                        Page 2


DUMPER.DOC -- Changes from V3A(172) to V4(303)
October 1981



1.0  SUMMARY

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 4(303) runs on TOPS-20 Release 5.

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.



2.0  EXTERNAL CHANGES

File archiving, migration, and retrieval support has been added.

The interface to TOPS-20 using tape-drive allocation has  been  added.
Volume  identifiers are included in the listing when saving files on a
system using tape-drive allocation.

The SET  BLOCKING-FACTOR  command  was  added  to  achieve  a  greater
percentage of tape utilization.

The UNLOAD command was added for use  on  systems  without  tape-drive
allocation.

The INCREMENTAL feature of the SAVE command has been enhanced.



3.0  KNOWN BUGS AND DEFICIENCIES

     1.  Reverse SKIPs in interchange mode do not work.

     2.  If there are  any  read  errors  or  duplicate  records,  the
         CHECKSUM feature under the PRINT command is not valid.

     3.  Interchange tapes written in DUMPER cannot be read  past  the
         first  saveset by BACKUP.  Therefore a restriction of the one
         saveset of one tape exists.

DMR4.DOC                                                        Page 3


     4.  Typing a ^C during the RETRIEVE command may cause your system
         to  crash  with Galaxy V4 and earlier.  If you need to ^C out
         of a RETRIEVE, RESET the fork to lose the PID associated with
         DUMPER.  
         PCO 20-DUMPER-024 fixes this problem [Edit 313].

     5.  During a full save, ARCHIVED/MIGRATED FDB may not  be  saved.
         This may result in their loss during a refresh of disk packs.



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
following commands:

     SKIP MTA0:5 FILES
     R DUMPER
     TAPE MTA0:
     REWIND
     DENSITY 1600-BPI
     SKIP 1
     RESTORE <*>DUMPER.EXE (TO) SYS:*.*.-1
     REWIND


4.3  Files Needed for Build DUMPER

DUMPER is built from the following files:

     DUMPER.MAC
     ARMAIL.MAC

In addition, the following files must be on SYS:

     MACSYM.REL
     MONSYM.UNV
     MACSYM.UNV
     QSRMAC.UNV
     GLXMAC.UNV
     ACTSYM.UNV
     ARMAIL.REL

DMR4.DOC                                                        Page 4


4.4  Instructions for Building DUMPER

Mount the tape labeled  Distribution  Tape  on  MTA0:   and  type  the
following commands:

     R DUMPER
     TAPE MTA0:
     REWIND
     DENSITY 1600-BPI
     SKIP 1
     RESTORE <*>*.*.* (TO) <self>*.*.*
     REWIND
     ^C
     SUBMIT DUMPER.CTL/TIME/UNIQ:0/REST


     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
way.

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
information.



5.0  INTERNAL CHANGES

Refer to DUMPER.TCO for detailed information about changes.



6.0  SUGGESTIONS

None.



[End of DMR4.DOC]