04/05/85 incremental_volume_dump Syntax as a command: incremental_volume_dump -control_args Function: starts an incremental volume dump. For each physical volume specified, those segments and directories that are stored on the volume are dumped if they have been modified since the last incremental volume dump. Control arguments: -accounting specifies that accounting data is to be collected in the directory >sc1>volume_backup_accounts for later processing. The default is off. This control argument is optional. -auto specifies that dump volumes are to be selected from the default dump volume pool, which is also known as the tape pool or the volume pool segment, and is located at >ddd>volume_backup>Volume_Dumper.volumes. For more information, see the description of the manage_volume_pool command in the Multics Commands and Active Functions manual, Order No. AG92. This control argument is optional. -control entry where entry is the entryname of the control segment. The suffix "dump" is assumed if not specified. This control argument is required. -cumulative specifies that segments and directories dumped are not to be removed from the list of objects to be dumped next time. This provides cumulative dumping if desired. The default is off. This control argument is optional. -detach specifies that dump volumes be detached after each pass of the Dumper. The default is -no_detach. This control argument is optional. -error_on specifies that all error messages are to be written to the error_output switch as well as to the dmpr_err.mm/dd/yy.hhmm.s segment. The default is that error messages are written only to the dmpr_err.mm/dd/yy.hhmm.s segment. This control argument is optional. -names specifies that the entire name space of each directory dumped will be recorded online. This online data base significantly improves the performance of the volume retrieve, but requires a large amount of disk storage. This control argument is optional. -no_detach specifies that dump volumes not be detached after each pass of the Dumper, but only when they become full, when they have an error, or at the end of the dump. This is the default. -no_object specifies that segments and directories are not to be dumped. Only the header information that describes them is dumped. The default is to dump the segments and directories. This control argument is optional. -no_trace specifies that the dumping process is not be be traced. This is the default. -no_update specifies that the VTOCE of segments and directories dumped is not to be updated. This speeds up dumping at the cost of invalidating the dtd and volume ID fields of the VTOCE. The default is to update the VTOCE. This control argument is optional. -operator STR where STR specifies the name or initials of the user. This control argument is required. -output_volume_desc STR where STR specifies a value to be used instead of the default attach description. The dump volume name is inserted in the attach description at the first occurrence of the string "^a" in the attach description. The default attach description is: tape_mult_ ^a -write -system If STR contains blanks, it must be enclosed in quotation marks. This control argument is optional. -preattach N specifies that N volumes are to be preattached before writing on the first volume. This allows a site to operate the volume dumper without user intervention, by premounting the requested or supplied volumes. The default is to not preattach. This control argument is optional. -restart STR specifies that the dump should restart from physical volume STR, which is implicitly or explicitly defined in the control file. This only occurs in the first pass. This control argument is optional. -trace specifies that the dumping process is to be traced. As each segment is dumped to the output tape volume, its unique id and pathname is written to the user_output I/O switch. -wakeup N where N is a wakeup interval in minutes for the incremental volume dumper. The interval must be between 1 and 480 minutes. The default is 60 minutes. This control argument is optional. -working_dir, -wd specifies that the volume backup databases are to be searched for relative to the working directory. The default is to search relative to the >ddd>volume_backup directory. This control argument is optional. Notes: After a dump cycle has completed, you should invoke the end_volume_command to close any open volume logs and detach any attached switches. The end_volume_dump command can also be used to clean up a dumper process prior to the reinvocation of dumping after a problem has occurred. Should the alarm clock timer fail, the incremental volume dumper can be restarted by using the wakeup_volume_dump command. ----------------------------------------------------------- Historical Background This edition of the Multics software materials and documentation is provided and donated to Massachusetts Institute of Technology by Group BULL including BULL HN Information Systems Inc. as a contribution to computer science knowledge. This donation is made also to give evidence of the common contributions of Massachusetts Institute of Technology, Bell Laboratories, General Electric, Honeywell Information Systems Inc., Honeywell BULL Inc., Groupe BULL and BULL HN Information Systems Inc. to the development of this operating system. Multics development was initiated by Massachusetts Institute of Technology Project MAC (1963-1970), renamed the MIT Laboratory for Computer Science and Artificial Intelligence in the mid 1970s, under the leadership of Professor Fernando Jose Corbato. Users consider that Multics provided the best software architecture for managing computer hardware properly and for executing programs. Many subsequent operating systems incorporated Multics principles. Multics was distributed in 1975 to 2000 by Group Bull in Europe , and in the U.S. by Bull HN Information Systems Inc., as successor in interest by change in name only to Honeywell Bull Inc. and Honeywell Information Systems Inc. . ----------------------------------------------------------- Permission to use, copy, modify, and distribute these programs and their documentation for any purpose and without fee is hereby granted,provided that the below copyright notice and historical background appear in all copies and that both the copyright notice and historical background and this permission notice appear in supporting documentation, and that the names of MIT, HIS, BULL or BULL HN not be used in advertising or publicity pertaining to distribution of the programs without specific prior written permission. Copyright 1972 by Massachusetts Institute of Technology and Honeywell Information Systems Inc. Copyright 2006 by BULL HN Information Systems Inc. Copyright 2006 by Bull SAS All Rights Reserved