1 01/11/87 copy_dump_tape
2
3
4 Syntax as a command: copy_dump_tape -control_args
5
6
7 Function: This command copies Multics storage system hierarchy dump
8 data from a set of input master tapes to a set of output copy
9 tapes. Options allow comparing master and copy tapes after the copy
10 operation; selective copying based upon pathname specifications in a
11 selection file; and copying/comparing from or to a storage system file
12 containing an image of a set of dump tape, rather than tapes.
13
14
15 Control arguments:
16 -abort
17 indicates that comparing of the master with the copy should stop
18 when the first discrepancy is found.
19 -compare, -cmp
20 indicates that master and copy should be compared after the copy is
21 generated. Any discrepancies are reported to the user.
22
23
24 -input_file IN_PATH, -if IN_PATH
25 gives the pathname of a file containing an image of the backup dump
26 tape. This file must have been created by a prior invocation of
27 copy_dump_tape. It contains the master data to be copied.
28 -input_volume VOLNAMES, -ivol VOLNAMES
29 gives a list of input tape volume names containing the master data
30 to be copied. The names are separated from one another by a blank.
31 Up to 20 volume names can be given. This control argument may be
32 followed by the control arguments described below in "Control
33 arguments for volume attributes".
34
35
36 -map MAP_PATH
37 controls the generation and naming of a dump map. If -map is given
38 with a MAP_PATH, then a dump map listing the copied files is
39 generated in that file. A suffix of map is assumed if not supplied.
40 If no MAP_PATH is given, the map is generated in a file in the
41 working directory. The file name is derived from other control
42 arguments, as follows. If -select SELECT_PATH is given, then the
43 map file name is the final entryname from SELECT_PATH. If -select
44 is omitted but -ovol VOLNAME is given, then the map file is called
45 VOLNAME.map. If -of OUT_PATH is given, then the map file is the
46 final entryname from OUT_PATH. Otherwise, the map file name is a
47 unique character string returned by the unique_chars_ subroutine.
48
49
50 -maximize_devices, -maxdv
51 indicates that all tape drives reserved by the process or assigned
52 to the process are to be used equally round-robin when copying
53 from or to tape, and that during comparison, tape volumes are to be
54 mounted on a different tape drive than was used during copying.
55 This helps detect tape failures caused by reading or writing on a
56 poorly calibrated tape drive.
57 -no_abort, -nabort
58 indicates that comparing master and copy should continue when errors
59 are encountered, until 20 discrepancies are found. This is the
60 default.
61 -no_compare, -ncmp
62 indicates that master and copy are not to be compared after the copy
63 operation. This is the default.
64
65
66 -no_map, -nmap
67 indicates that no backup map of the copied data is to be produced.
68 This is the default.
69 -no_maximze_devices, -nmaxdv
70 allows RCP to select which tape drives to use when reading or
71 writing tapes. This is the default.
72 -no_select, -nslct
73 indicates that all master data is to be copied and compared. This
74 is the default.
75 -no_trace, -ntrace
76 prevents tracing information from being printed. This is the
77 default.
78
79
80 -output_discard, -od
81 indicates that no output copy is to be generated. This is useful in
82 conjunction with -map to produce a map of the master data, or in
83 conjunction with -trace for debugging purposes.
84 -output_file OUT_PATH, -of OUT_PATH
85 gives the pathname of a copy file into which the master data is
86 copied.
87 -output_volume VOLNAMES, -ovol VOLNAMES
88 gives a list of output tape volume names. The master data is copied
89 onto this copy tape volume set. The names are separated from one
90 another by a blank. Up to 20 volume names can be given. This
91 control argument may be followed by the control arguments described
92 below in "Control arguments for volume attributes".
93
94
95 -select SELECT_PATH, -slct SELECT_PATH
96 gives the pathname of a file similar to a standard backup_dump
97 control file. This file gives paths of master files to be selected
98 for copying. See "Notes on control file."
99 -trace TYPE
100 controls printing of trace information while copying and comparing.
101 This information is primarily used for debugging copy_dump_tape.
102 See "List of trace types".
103
104
105 Control arguments for volume attributes:
106 The following control arguments define attributes of tape volumes
107 given in preceding -input_volume or -output_volume control argument.
108 -density DEN, -den DEN
109 gives a tape density. DEN may be 800, 1600 or 6250. If given for
110 input tapes, the tapes are mounted on a tape drive capable of
111 reading density DEN. However, the actual density at which the input
112 tapes are written determines the density used for reading. If given
113 for output tapes, the tapes are written at density DEN. The default
114 density is 1600 BPI bits per inch.
115 -track TK, -tk TK
116 mounts tapes on a tape drive capable of handling tapes containing TK
117 tracks. TK may be 7 or 9. The default track size is 9.
118
119
120 List of trace types:
121 One of the following trace types may be given as operand with the
122 -trace control argument. These arguments control the type of trace
123 information printed. If any tracing is enabled, then attach
124 descriptions are printed in addition to the segment information
125 described below.
126 all, a
127 during both copy and compare operations, trace master segments
128 selected by paths in the -select file.
129 compare, cmp
130 during the compare operation, trace master segments selected by
131 paths in the -select file. No segments are traced during the copy
132 operation.
133
134
135 copy, cp
136 during the copy operation, trace master segments selected by paths
137 in the -select file. No segments are traced during the compare
138 operation. This is the default if -trace is specified without a
139 TYPE operand.
140 off
141 turn off tracing. This is equivalent to -no_trace.
142 rejects, reject, rej
143 print master segments unmatched or rejected by paths in the -select
144 file.
145
146
147 List of severity values:
148 copy_dump_tape sets an external variable to indicate the success or
149 failure of copy and compare operations. This variable may be
150 examined using the severity command/active function. For example:
151
152 &goto RESULT_&severity copy_dump_tape
153
154 The following severity values can be returned.
155
156
157 0
158 Both copy and compare operations completed successfully.
159 2
160 The copy and compare operations completed successfully, but one or
161 more paths given in the -select file were not matched by master
162 segments. These pathnames are listed in a message printed by
163 copy_dump_tape.
164 3
165 The copy operation completed successfully, but the compare operation
166 found discrepancies between master and copy segments.
167 4
168 Either copy or compare operations failed, due to fatal errors.
169 These errors are listed in error messages printed by copy_dump_tape.
170
171
172 Notes: Either -input_file or -input_volume must be given to specify
173 the source of master input data. Either -output_discard, -output_file
174 or -output_volume must be given to specify the target for copied data.
175
176
177 Notes on control file: The control file specified by -select is an
178 ASCII segment containing pathnames of entries segments MSFs and
179 directory subtrees. Each pathname must be given on a separate line.
180 Absolute pathnames must be given, with each entryname of the path being
181 a primary name the first name of the entry. Master entries matching
182 one of the paths are copied and compared. Master entries which are
183 superior to one of the paths are also copied/compared. If a path
184 identifies a directory, then master entries inferior to that directory
185 are copied/compared. A pathname preceded by a circumflex ^ character
186 identifies entries which are NOT to be copied or compared, unless later
187 entries in the control file override the rejection.
188
189
190 For example--
191
192 >library_dir_dir>hardcore
193 ^>library_dir_dir>hardcore>info
194 >library_dir_dir>hardcore>info>hardcore.header
195
196 selects all entries in the subtree below >library_dir_dir>hardcore,
197 except those in the info directory. However, the hardcore.header entry
198 in the info directory is selected.