1 04/05/85 incremental_volume_dump
  2 
  3 Syntax as a command:  incremental_volume_dump -control_args
  4 
  5 
  6 Function:  starts an incremental volume dump.  For each physical volume
  7 specified, those segments and directories that are stored on the volume
  8 are dumped if they have been modified since the last incremental volume
  9 dump.
 10 
 11 
 12 Control arguments:
 13 -accounting
 14    specifies that accounting data is to be collected in the directory
 15    >sc1>volume_backup_accounts for later processing.  The default is
 16    off.  This control argument is optional.
 17 -auto
 18    specifies that dump volumes are to be selected from the default dump
 19    volume pool, which is also known as the tape pool or the volume pool
 20    segment, and is located at >ddd>volume_backup>Volume_Dumper.volumes.
 21    For more information, see the description of the manage_volume_pool
 22    command in the Multics Commands and Active Functions manual, Order
 23    No.  AG92.  This control argument is optional.
 24 
 25 
 26 -control entry
 27    where entry is the entryname of the control segment.  The suffix
 28    "dump" is assumed if not specified.  This control argument is
 29    required.
 30 -cumulative
 31    specifies that segments and directories dumped are not to be removed
 32    from the list of objects to be dumped next time.  This provides
 33    cumulative dumping if desired.  The default is off.  This control
 34    argument is optional.
 35 -detach
 36    specifies that dump volumes be detached after each pass of the
 37    Dumper.  The default is -no_detach.  This control argument is
 38    optional.
 39 
 40 
 41 -error_on
 42    specifies that all error messages are to be written to the
 43    error_output switch as well as to the dmpr_err.mm/dd/yy.hhmm.s
 44    segment.  The default is that error messages are written only to the
 45    dmpr_err.mm/dd/yy.hhmm.s segment.  This control argument is
 46    optional.
 47 -names
 48    specifies that the entire name space of each directory dumped will
 49    be recorded online.  This online data base significantly improves
 50    the performance of the volume retrieve, but requires a large amount
 51    of disk storage.  This control argument is optional.
 52 -no_detach
 53    specifies that dump volumes not be detached after each pass of the
 54    Dumper, but only when they become full, when they have an error, or
 55    at the end of the dump.  This is the default.
 56 
 57 
 58 -no_object
 59    specifies that segments and directories are not to be dumped.  Only
 60    the header information that describes them is dumped.  The default
 61    is to dump the segments and directories.  This control argument is
 62    optional.
 63 -no_trace
 64    specifies that the dumping process is not be be traced.  This is the
 65    default.
 66 -no_update
 67    specifies that the VTOCE of segments and directories dumped is not
 68    to be updated.  This speeds up dumping at the cost of invalidating
 69    the dtd and volume ID fields of the VTOCE.  The default is to update
 70    the VTOCE.  This control argument is optional.
 71 
 72 
 73 -operator STR
 74    where STR specifies the name or initials of the user.  This control
 75    argument is required.
 76 -output_volume_desc STR
 77    where STR specifies a value to be used instead of the default attach
 78    description.  The dump volume name is inserted in the attach
 79    description at the first occurrence of the string "^a" in the attach
 80    description.  The default attach description is:
 81 
 82          tape_mult_ ^a -write -system
 83 
 84    If STR contains blanks, it must be enclosed in quotation marks.
 85    This control argument is optional.
 86 
 87 
 88 -preattach N
 89    specifies that N volumes are to be preattached before writing on the
 90    first volume.  This allows a site to operate the volume dumper
 91    without user intervention, by premounting the requested or supplied
 92    volumes.  The default is to not preattach.  This control argument is
 93    optional.
 94 -restart STR
 95    specifies that the dump should restart from physical volume STR,
 96    which is implicitly or explicitly defined in the control file.  This
 97    only occurs in the first pass.  This control argument is optional.
 98 -trace
 99    specifies that the dumping process is to be traced.  As each segment
100    is dumped to the output tape volume, its unique id and pathname is
101    written to the user_output I/O switch.
102 
103 
104 -wakeup N
105    where N is a wakeup interval in minutes for the incremental volume
106    dumper.  The interval must be between 1 and 480 minutes.  The
107    default is 60 minutes.  This control argument is optional.
108 -working_dir, -wd
109    specifies that the volume backup databases are to be searched for
110    relative to the working directory.  The default is to search
111    relative to the >ddd>volume_backup directory.  This control argument
112    is optional.
113 
114 
115 Notes:  After a dump cycle has completed, you should invoke the
116 end_volume_command to close any open volume logs and detach any
117 attached switches.  The end_volume_dump command can also be used to
118 clean up a dumper process prior to the reinvocation of dumping after a
119 problem has occurred.
120 
121 
122 Should the alarm clock timer fail, the incremental volume dumper can be
123 restarted by using the wakeup_volume_dump command.