1 10/3/89  complete_volume_dump
  2 
  3 Syntax as a command:  complete_volume_dump -control_args
  4 
  5 
  6 Function:  starts a complete volume dump.  For each physical volume
  7 specified, all segments and directories are dumped.
  8 
  9 
 10 Control arguments:
 11 -accounting
 12    specifies that accounting data is to be collected in the directory
 13    >sc1>volume_backup_accounts for later processing.  The default is
 14    off.  This control argument is optional.
 15 -auto
 16    specifies that dump volumes are to be selected from the default dump
 17    volume pool, which is also known as the tape pool or the volume pool
 18    segment, and is located at >ddd>volume_backup>Volume_Dumper.volumes.
 19    For more information, see the description of the manage_volume_pool
 20    command in the Multics Commands and Active Functions manual, Order
 21    No.  AG92.  This control argument is optional.
 22 
 23 
 24 -control entry
 25    where entry is the entryname of the control segment.  The suffix
 26    "dump" is assumed if not specified.  This control argument is
 27    required.
 28 -error_on
 29    specifies that all error messages are to be written to the
 30    error_output switch as well as to the dmpr_err.mm/dd/yy.hhmm.s
 31    segment.  The default is that error messages are written only to the
 32    dmpr_err.mm/dd/yy.hhmm.s segment.  This control argument is
 33    optional.
 34 
 35 
 36 -manual_free
 37    specifies that if purging is done, volumes must be freed from the
 38    volume pool manually.  This means that dump volumes are purged from
 39    the respective volume logs but are not reused until they are marked
 40    as free in the volume pool.  The default is to automatically free
 41    volumes in the volume pool.  This control argument should be used
 42    only with the -auto control argument.
 43 -mod_after DT
 44    where DT is a time acceptable to the convert_date_to_binary_
 45    subroutine.  Only those segments and directories whose
 46    date-time-modified exceeds DT are dumped.  This control argument is
 47    optional.
 48 
 49 
 50 -names
 51    specifies that the entire name space of each directory dumped is
 52    recorded online.  This online data base significantly improves the
 53    performance of the volume retriever, but requires a large amount of
 54    disk storage.  This control argument is optional.
 55 -no_object
 56    specifies that segments and directories are not to be dumped.  Only
 57    the header information that describes them is dumped.  The default
 58    is to dump the segments and directories.  This control argument is
 59    optional.
 60 -no_purge_volume_log, -npvl
 61    specifies that the volume log of each physical volume dumped is NOT
 62    to be purged using the values set with the set_volume_log command.
 63    (Default).
 64 
 65 
 66 -no_trace
 67    specifies that the dumping process is not be be traced.  This is the
 68    default.
 69 -no_update
 70    specifies that the VTOCE of segments and directories dumped is not
 71    to be updated.  This speeds up dumping at the cost of invalidating
 72    the dtd and volume ID fields of the VTOCE.  The default is to update
 73    the VTOCE.  This control argument is optional.
 74 -operator STR
 75    where STR specifies the name or initials of the user.  This control
 76    argument is required.
 77 
 78 
 79 -output_volume_desc STR
 80    where STR specifies a value to be used instead of the default attach
 81    description.  The dump volume name is inserted in the attach
 82    description at the first occurrence of the string "^a" in the attach
 83    description.  The default attach description is:
 84 
 85          tape_mult_ ^a -write -system
 86 
 87    If STR contains blanks, it must be enclosed in quotation marks.
 88    This control argument is optional.
 89 
 90 
 91 -preattach N
 92    specifies that N volumes are to be preattached before writing on the
 93    first volume.  This allows a site to operate the volume dumper
 94    without user intervention, by premounting the requested or supplied
 95    volumes.  The default is to not preattach.  This control argument is
 96    optional.
 97 -purge_volume_log, -pvl
 98    specifies that the volume log of each physical volume dumped is to
 99    be purged using the values set with the set_volume_log command.
100 -restart STR
101    specifies that the dump should restart from physical volume STR,
102    which is implicitly or explicitly defined in the control file.  The
103    default is to start at the last volume dumped.  This control
104    argument is optional.
105 
106 
107 -trace
108    specifies that the dumping process is to be traced.  As each segment
109    is dumped to the output tape volume, its unique id and pathname is
110    written to the user_output I/O switch.
111 -working_dir, -wd
112    specifies that the volume backup databases are to be searched for
113    relative to the working directory.  The default is to search
114    relative to the >ddd>volume_backup directory.  This control argument
115    is optional.
116 
117 
118 Notes:  If a dump terminates abnormally, reinvoke the
119 complete_volume_dump command.  The dump will be restarted and reload
120 groups will be kept consistent.  If the dump terminates again, use the
121 new_proc command to clean up the dumper process.  Then reinvoke the
122 complete_volume_dump command with the -restart argument.  The -restart
123 argument must be used after a new_proc to keep reload groups
124 consistent.