1 01/13/87 compare_dump_tape
2
3
4 Syntax as a command: compare_dump_tape -control_args
5
6
7 Function: This command compares Multics storage system hierarchy dump
8 data on two sets of input tape, a master set and a copy set. Options
9 allow selective comparinging based upon pathname specifications in a
10 selection file; and comparing using a storage system file containing an
11 image of a set of dump tape, rather than tapes.
12
13
14 Control arguments:
15 -abort
16 indicates that comparing of the master with the copy should stop
17 when the first discrepancy is found.
18 -copy_file OUT_PATH, -cf OUT_PATH
19 gives the pathname of a copy file to be compared with the master
20 data.
21 -copy_volume VOLNAMES, -cvol VOLNAMES
22 gives a list of tape volume names. The master data is compared with
23 this copy tape volume set. The names are separated from one another
24 by a blank. Up to 20 volume names can be given. This control
25 argument may be followed by the control arguments described below in
26 "Control arguments for volume attributes".
27
28
29 -master_file IN_PATH, -mf IN_PATH
30 gives the pathname of a file containing an image of the backup dump
31 tape. This file must have been created by a prior invocation of
32 compare_dump_tape. It contains the master data to be copied.
33 -master_volume VOLNAMES, -mvol VOLNAMES
34 gives a list of tape volume names containing the master data to be
35 copied. The names are separated from one another by a blank. Up to
36 20 volume names can be given. This control argument may be followed
37 by the control arguments described below in "Control arguments for
38 volume attributes".
39 -maximize_devices, -maxdv
40 indicates that all tape drives reserved by the process or assigned
41 to the process are to be used equally round-robin when mounting
42 tapes.
43
44
45 -no_abort, -nabort
46 indicates that comparing master and copy should continue when errors
47 are encountered, until 20 discrepancies are found. This is the
48 default.
49 -no_maximze_devices, -nmaxdv
50 allows RCP to select which tape drives to use when reading tapes.
51 This is the default.
52 -no_select, -nslct
53 indicates that all master data is to be compared with copy data.
54 This is the default.
55 -no_trace, -ntrace
56 prevents tracing information from being printed. This is the
57 default.
58
59
60 -select SELECT_PATH, -slct SELECT_PATH
61 gives the pathname of a file similar to a standard backup_dump
62 control file. This file gives paths of master files to be selected
63 for comparison. See "Notes on control file."
64 -trace TYPE
65 controls printing of trace information while comparing. This
66 information is primarily used for debugging compare_dump_tape. See
67 "List of trace types".
68
69
70 Control arguments for volume attributes:
71 The following control arguments define attributes of tape volumes
72 given in preceding -master_volume or -copy_volume control argument.
73 -density DEN, -den DEN
74 gives a tape density. DEN may be 800, 1600 or 6250. The input
75 tapes are mounted on a tape drive capable of reading density DEN.
76 However, the actual density at which the input tapes are written
77 determines the density used for reading. The default density is
78 1600 BPI bits per inch.
79 -track TK, -tk TK
80 mounts tapes on a tape drive capable of handling tapes containing TK
81 tracks. TK may be 7 or 9. The default track size is 9.
82
83
84 List of trace types:
85 One of the following trace types may be given as operand with the
86 -trace control argument. These arguments control the type of trace
87 information printed. If any tracing is enabled, then attach
88 descriptions are printed in addition to the segment information
89 described below.
90 compare, cmp
91 during the compare operation, trace master segments selected by
92 paths in the -select file. This is the default if -trace is
93 specified without a TYPE operand.
94 off
95 turn off tracing. This is equivalent to -no_trace.
96 rejects, reject, rej
97 print master segments unmatched or rejected by paths in the -select
98 file.
99
100
101 List of severity values:
102 compare_dump_tape sets an external variable to indicate the success
103 or failure of copy and compare operations. This variable may be
104 examined using the severity command/active function. For example:
105
106 &goto RESULT_&severity compare_dump_tape
107
108 The following severity values can be returned.
109
110
111 0
112 The compare operation completed successfully.
113 2
114 The compare operation completed successfully, but one or more paths
115 given in the -select file were not matched by master segments.
116 These pathnames are listed in a message printed by
117 compare_dump_tape.
118 3
119 The compare operation found discrepancies between master and copy
120 segments.
121 4
122 The compare operation failed, due to fatal errors. These errors are
123 listed in error messages printed by compare_dump_tape.
124
125
126 Notes: Either -master_file or -master_volume must be given to specify
127 the source of master input data. Either -copy_file or -copy_volume
128 must be given to specify the source of copy input data.
129
130
131 Notes on control file: The control file specified by -select is an
132 ASCII segment containing pathnames of entries segments MSFs and
133 directory subtrees. Each pathname must be given on a separate line.
134 Absolute pathnames must be given, with each entryname of the path being
135 a primary name the first name of the entry. Master entries matching
136 one of the paths are compared. Master entries which are superior to
137 one of the paths are also compared. If a path identifies a directory,
138 then master entries inferior to that directory are compared. A
139 pathname preceded by a circumflex ^ character identifies entries
140 which are NOT to be compared, unless later entries in the control file
141 override the rejection.
142
143
144 For example--
145
146 >library_dir_dir>hardcore
147 ^>library_dir_dir>hardcore>info
148 >library_dir_dir>hardcore>info>hardcore.header
149
150 selects all entries in the subtree below >library_dir_dir>hardcore,
151 except those in the info directory. However, the hardcore.header entry
152 in the info directory is selected.