1 :Info: gb64.errata: errata.gb64: Admin_Maint_Oper_Commands: 2022-09-03 GB64 Errata
2
3 Function: This info segment provides errata and addenda information for
4 the Multics manual, GB64-00A titled:
5
6 Multics Administration, Maintenance and Operations Commands
7
8
9 Table of Contents:
10
11 pg xii:
12
13 CHANGE:
14 salvage_dirs salv . . . . . . . . .. . . . . . . . . .. 4-69
15
16 TO:
17 salvage_dirs . . . . . . . . . . . .. . . . . . . . . .. 4-69
18
19
20 salvage_dirs:
21
22 pg 4-69:
23
24 CHANGE:
25 Name: salvage_dirs, salv
26
27 SYNTAX AS A COMMAND
28
29 salv
30
31
32 TO:
33 Name: salvage_dirs
34
35 SYNTAX AS A COMMAND
36
37 salvage_dirs
38
39
40 backup_dump:
41
42 pg 2-52:
43
44 Add the following two control arguments:
45
46 -volume_pool path, -vp path
47 indicates that the specified volume pool should be used to provide
48 automated selection of tapes to use for dumping. See the
49 manage_volume_pool mvp command for help on managing volume
50 pools.
51 -no_volume_pool, -no_vp
52 disables use of a volume pool for automatic tape selection.
53
54
55 ed_installation_parms:
56
57 pg 2-181:
58
59 Change the description under the default_pdir_seg_quota df_pdsq
60 keyword to read:
61
62 process directory segment quota. The default value is 2000.
63
64
65 catchup_dump:
66
67 pg 8-3:
68
69 Add the following two control arguments:
70
71 -volume_pool path, -vp path
72 indicates that the specified volume pool should be used to provide
73 automated selection of tapes to use for dumping. See the
74 manage_volume_pool mvp command for help on managing volume
75 pools.
76 -no_volume_pool, -no_vp
77 disables use of a volume pool for automatic tape selection.
78
79
80 complete_dump:
81
82 pg 8-8:
83
84 Add the following two control arguments:
85
86 -volume_pool path, -vp path
87 indicates that the specified volume pool should be used to provide
88 automated selection of tapes to use for dumping. See the
89 manage_volume_pool mvp command for help on managing volume
90 pools.
91 -no_volume_pool, -no_vp
92 disables use of a volume pool for automatic tape selection.
93
94
95 start_dump:
96
97 pg 8-14:
98
99 Add the following two control arguments:
100
101 -volume_pool path, -vp path
102 indicates that the specified volume pool should be used to provide
103 automated selection of tapes to use for dumping. See the
104 manage_volume_pool mvp command for help on managing volume
105 pools.
106 -no_volume_pool, -no_vp
107 disables use of a volume pool for automatic tape selection.
108
109
110 10/31/1992 GB64 Multics Administration Maintenance and Operations
111 Commands
112 Errata Information for MR12.5
113
114
115 as_who: |
116 |
117 Make the following change for the "as_who" command. |
118 |
119 pg 2-46.1; add the following text to the end of the NOTES section. |
120 |
121 Specification of any User_id will cause the headers to be |
122 suppressed. |
123
124
125 edit_proj: |
126 |
127 Make the following change for the "edit_proj" command. |
128 |
129 2-208.4; under EXAMPLES insert the following before the line |
130 beginning with "Alias:" |
131 |
132 Project Alias: type "." to delete current alias from SAT. |
133
134
135 io_error_summary: |
136 |
137 Make the following change for the "io_error_summary" command. |
138 |
139 pg 2-288; add the new control argument '-channel' and revise the |
140 desciption of the '-cylinders' control argument. |
141 |
142 -channel, -chn |
143 reports per channel status information for each device. |
144 The channel is displayed following the device name. |
145
146
147 -cylinders, -cyl |
148 separates the disk device error by cylinder, head, sector |
149 and record. Only disk control syserr messages can be |
150 separated. |
151
152
153 new_user_$cga: |
154 |
155 Make the following change for the "new_user_$cga" entry point. |
156 |
157 pg 2-357; under "+FLAGS" add the following to "lock". |
158 |
159 The affected user, if logged in when the flag is switched on, |
160 will be immediately bumped. |
161 |
162 pg 2-357-2-357.1; the headers should say "new_user" and not |
163 "list_proc_required". |
164
165
166 print_sys_log: |
167 |
168 Make the following changes for 'print_sys_log': |
169 |
170 pg 2-383; replace the 'log_selector' argument with the following: |
171 |
172 log_selector |
173 is either the pathname of a named log or log family to be |
174 monitored, or one of the 'log selection' control arguments |
175 listed below. |
176
177
178 pg 2-383; add the following to the list of control arguments for |
179 log selection: |
180 |
181 -pathname log_path, -pn log_path |
182 specifies that the named log or log family is to be |
183 examined. |
184
185
186 poll_mpc:
187
188 Make the following change for the "poll_mpc" command.
189
190 pg 2-363; add the following text as the second paragraph in the
191 NOTES section.
192
193 If, when the system is reconfigured to add an MPC, you want
194 that MPC to be polled, you must issue
195
196 poll_mpc mpc-name -start".
197
198
199 complete_volume_dump:
200
201 Make the following changes for the "complete_volume_dump" command.
202
203 pg 7-3; delete the description of the "-incr_skip_count" control
204 argument.
205
206
207 pg 7-4; add the following control arguments.
208
209 -no_purge_volume_log, -npvl
210 specifies that the volume log of each physical volume
211 dumped is NOT to be purged using the values set with the
212 set_volume_log command. Default
213
214 -purge_volume_log, -pvl
215 specifies that the volume log of each physical volume
216 dumped is to be purged using the values set with the
217 set_volume_log command.
218
219
220 consolidated_volume_dump:
221
222 Make the following changes for the "consolidated_volume_dump"
223 command.
224
225 pg 7-6; delete the description of the "-incr_skip_count" control
226 argument.
227
228
229 pg 7-6 to 7-7; add the following control arguments.
230
231 -no_purge_volume_log, -npvl
232 specifies that the volume log of each physical volume
233 dumped is NOT to be purged using the values set with the
234 set_volume_log command. Default
235
236 -purge_volume_log, -pvl
237 specifies that the volume log of each physical volume
238 dumped is to be purged using the values set with the
239 set_volume_log command.
240
241
242 display_pvolog:
243
244 Make the following change for the "display_pvolog" command.
245
246 pg 7-9; add the following control argument.
247
248 -header, -he
249 specifies to display the header Default.
250
251
252 display_volume_log:
253
254 Make the following changes for the "display_volume_log" command.
255
256 pg 7-9; add the following control arguments.
257
258 -all, -a
259 specifies that information about all types of volume
260 dumps, the disk label information recorded at the time of
261 the dump, and processing statistics are to be displayed.
262
263 -header, -he
264 specifies that the dump volumes will be displayed with the
265 output header Default.
266
267
268 -label, -lbl
269 specifies that the disk label information stored at the
270 time of the dump is to be displayed.
271
272 -no_label, -nlbl
273 specifies that the disk label information stored at the
274 time of the dump is not to be displayed.
275
276 -status, -st
277 specifies that processing totals for segments, directories
278 and volumes are to be displayed.
279
280
281 pg 7-9; replace the description of the "-no_header" control argument
282 with the following.
283
284 -no_header, -nhe
285 specifies that the dump volumes will be displayed without
286 the header.
287
288
289 purge_volume_log:
290
291 Make the following changes for the "purge_volume_log" command.
292
293 pg 7-17; delete the description of the "-incr_skip_count" control
294 argument.
295
296 pg 7-17; change the description of the "-test" control argument to read
297 as follows.
298
299 -test
300 runs in test mode and reports what would have been done.
301 No databases are affected except for pvolog locks which
302 are reset.
303
304
305 pg 7-18; replace the NOTES section with the following.
306
307 After purging, two reload groups are left in a volume log
308 unless the number of reload groups has been changed see the
309 set_volume_log command. A reload group consists of the
310 following: all incremental volume dumps not superseded by
311 consolidated volume dumps; all incremental and consolidated
312 volume dumps not superseded by a complete volume dump; and a
313 complete volume dump. By default all consolidated dumps and
314 those incremental dumps which are not superseded by a complete
315 dump are retained. To modify the number of incremental and
316 consolidated dump sets retained see the -incr_sets and
317 -cons_sets control arguments of the set_volume_log command.
318
319
320 set_volume_log:
321
322 Make the following changes for the "set_volume_log" command.
323
324 pg 7-24; replace the CONTROL ARGUMENTS and NOTES sections with the
325 following.
326
327
328 Control arguments:
329 -cons_sets SET_VALUE, -cs SET_VALUE
330 sets the number of consolidated dump volume sets to retain
331 in the volume log whenever it is purged. The value of
332 SET_VALUE may be a non-zero positive integer or the word
333 "all" or the letter "a". A consolidated dump set is
334 defined as all volumes that are used in one cycle of the
335 consolidated volume dumper. By default all consolidated
336 dump volumes are kept for each reload group. The default
337 operation will result if the SET_VALUE is set to "all" or
338 "a". See the "Notes" section for further explanation of
339 the rules on how volume sets are retained or purged.
340
341
342 -incr_sets SET_VALUE, -is SET_VALUE
343 sets the number of incremental dump volume sets to retain
344 in the volume log whenever it is purged. The value of
345 SET_VALUE may be a non-zero positive integer or the word
346 "all" or the letter "a". An incremental dump set is
347 defined as all volumes that are used in all cycles of the
348 incremental volume dumper that take place between cycles
349 of the consolidated volume dumper. By default all
350 incremental dump volumes are kept for each reload group.
351 The default operation will result if the SET_VALUE is set
352 to "all" or "a". See the "Notes" section for further
353 explanation of the rules on how volume sets are retained
354 or purged.
355
356
357 -reload_groups N, -rg N
358 sets the number of reload groups to N, where N>1. The
359 default value, to be set at volume log creation, is 2. A
360 reload group consists of the following: all incremental
361 volume dumps not superseded by consolidated volume dumps;
362 all incremental and consolidated volume dumps not
363 superseded by a complete volume dump; and a complete
364 volume dump.
365
366
367 Notes:
368
369 1) All incremental volume sets are retained by default and are
370 purged when the reload group they are in is purged. This
371 default operation is set up when the volume log is created.
372 This default operation can also be set with the following
373 command line:
374
375 set_volume_log vlname -is all -cs all -reload_groups 2
376
377 When the incr_sets -is value is a non-zero positive
378 integer, then that number of incremental volume sets are
379 retained. All other incremental volume sets are purged,
380 even if they are in the current reload group.
381
382
383 2) All consolidated volume sets are retained by default and
384 are purged when the reload group they are in is purged.
385 This default operation is set up when the volume log is
386 created and can also be set up with the following command
387 line:
388
389 set_volume_log vlname -is all -cs all -reload_groups 2
390
391 No consolidated volume sets are purged in the current
392 reload group. Using the number of consolidated dump sets
393 in all reload groups, consolidated volume sets are purged
394 from previous reload groups to satisfy the value given with
395 the -cons_sets -cs option if this value is a non-zero
396 positive integer.
397
398
399 3) No incremental or consolidated volume set is retained if it
400 exists outside of the configured number of reload groups.
401 If it is desired to keep more consolidated or incremental
402 volumes sets, the number of reload groups must be
403 increased.
404
405
406 Examples:
407
408 1. set_volume_log vlname -is 1 -cs 5 -reload_groups 8
409
410 This will be the result on the Wednesday before the
411 consolidated dump of the eighth week assuming, you are
412 running less incremental runs than consolidated runs,
413 consolidated runs are done once per day M-F, and a
414 complete is run on Saturday.
415
416
417 group SA SN MN TU WD TH FR
418 1 |comp|
419 2 |comp|
420 3 |comp|
421 4 |comp|
422 5 |comp|
423 6 |comp|
424 7 |comp|
425 |cons||cons||cons|
426 8 |comp|
427 |incr||incr...
428 |cons||cons|
429
430
431 2. set_volume_log vlname -incr_sets 5 -cons_sets 10
432 -reload_groups 8
433
434 This will be the result on the Wednesday before the
435 consolidated dump of the eighth week assuming, you are
436 running less incremental runs than consolidated runs,
437 consolidated runs are done once per day M-F, and a
438 complete is run on Saturday.
439
440
441 group SA SN MN TU WD TH FR
442 1 |comp|
443 2 |comp|
444 3 |comp|
445 4 |comp|
446 5 |comp|
447 6 |comp|
448 |cons||cons||cons|
449 7 |comp|
450 |incr||incr||incr|
451 |cons||cons||cons||cons||cons|
452 8 |comp|
453 |------incr------||incr||incr...
454 |cons||cons|
455
456
457 3. set_volume_log vlname -incr_sets 2 -cons_sets 10
458 -reload_groups 2
459
460 This will be the result on the Wednesday before the
461 consolidated dump of the second week. The consolidated
462 runs are done once per day M-F and a complete is run on
463 Saturday.
464
465 group SA SN MN TU WD TH FR
466 1 |comp| |cons||cons||cons||cons||cons|
467 2 |comp|
468 |------incr------||incr||incr...
469 |cons||cons|
470
471
472 Notice that there are only 7 consolidated volume sets at
473 this point in the week. This is restricted by the number
474 of reload groups specified i.e. 2. If a full set of 10
475 consolidated dumps is desired at all times, then 3 reload
476 groups must be configured as in the following example.
477
478
479 4. set_volume_log vlname -incr_sets 2 -cons_sets 10
480 -reload_groups 3
481
482 This will be the result on the Wednesday before the
483 consolidated dump of the second week. Again, consolidated
484 runs are done once per day M-F and a complete is run on
485 Saturday.
486
487 group SA SN MN TU WD TH FR
488 1 |comp| |cons||cons|
489 2 |comp| |cons||cons||cons||cons||cons|
490 3 |comp|
491 |------incr------||incr||incr...
492 |cons||cons|
493
494
495 pg i-24; under Frong-End Network Processor FNP, remove the entry for
496 "new_proj 3-26".
497
498
499 :hcom:
500 /****^ HISTORY COMMENTS:
501 1) change2020-01-31Swenson, approve2020-01-31MCR10073,
502 audit2020-02-01GDixon, install2020-02-01MR12.6g-0038:
503 Remove name "salv" from "salvage_dirs" Initializer command.
504 2) change2022-09-03Swenson, approve2022-09-03MCR10124,
505 audit2022-09-03None, install2022-09-03MR12.8-1034:
506 Fix index entry for Front-End Network Processor" to not include entry for
507 the new_proj command.
508 3) change2022-09-07Swenson, approve2022-09-07MCR10122,
509 audit2022-09-07GDixon, install2022-10-03MR12.8-1039:
510 Update to reflect new default process directory segment quota.
511 END HISTORY COMMENTS */
512
513