1 10/31/92 AG92 Multics Commands and Active Functions
2 Errata Information for MR12.5
3
4
5 pg 3-14.1: for the "add_name" command, add the following under
6 the CONTROL ARGUMENTS section.
7
8 -interpret_as_extended_entry -inaee
9 interprets the selected entry as an extended entry type
10
11 -interpret_as_standard_entry -inase
12 interprets the selected entry as a standard entry type
13
14
15 pg 3-20: for the "alm" command, under ARGUMENTS change the
16 description of "path" to the following.
17
18 path
19 is the pathname of an ALM source program; the alm suffix
20 need not be given. The archive component pathname
21 convention is allowed.
22
23
24 pg 3-101: for the "calc" command, under NOTES ON ASSIGNMENT
25 STATEMENTS replace the second sentence that begins "The
26 name of the variable..." with the following.
27
28 The name of the variable must be from one to eight
29 characters in length and must be made up of letters
30 uppercase and/or lowercase, digits if not at the
31 beginning of the name, and the underscore character _.
32
33
34 pg 3-112: for the "cancel_daemon_request" command, in the NOTES
35 section replace "If the request is already running,...
36 ...are ignored by the system" two paragraphs with the
37 following.
38
39 If the request is already running, the running request will
40 not be stopped and the request's entry will not be removed
41 from the queue. A warning message will be displayed to warn
42 the user of this action.
43
44
45 pg 3-115: for the "cancel_output_request" command, in the NOTES
46 section replace "If the request is already running,...
47 ...are ignored by the system" two paragraphs with the
48 following.
49
50 If the request is already running, the running request will
51 not be stopped and the request's entry will not be removed
52 from the queue. A warning message will be displayed to warn
53 the user of this action.
54
55
56 pg 3-160: for the "copy" command, under NOTES add the paragraph
57 below.
58 pg 3-164; for the "copy_dir" command, under NOTES add the
59 paragraph below.
60 pg 3-585; for the "move" command, under NOTES add the paragraph
61 below.
62 pg 3-591; for the "move_dir" command, under NOTES add the
63 paragraph below.
64
65 If copying a non-empty mailbox requires that the max_length
66 characteristic of the source be applied to the target, then
67 the target max_length value will take on the default value
68 that was given to it when created.
69
70
71 pg 3-242: for the "delete_name" command, add the following under
72 the CONTROL ARGUMENTS section.
73
74 -interpret_as_extended_entry -inaee
75 interprets the selected entry as an extended entry type
76
77 -interpret_as_standard_entry -inase
78 interprets the selected entry as a standard entry type
79
80
81 pg 3-252: add the following two new control arguments to the |
82 "wait" request of the "dial_out" command. |
83 |
84 -inhibit_error, -ihe |
85 specifies that dial_out should not abort after a timeout |
86 has occured. See the '-timeout' control argument. |
87 This control argument is most useful when wait is used |
88 as an active request. |
89 |
90 -no_inhibit_error, -nihe |
91 Specifies that timeouts should result in an abort. This |
92 is the default. |
93
94
95 pg 3-263: add the following new documentation for the
96 "display_forms_info" command.
97
98 Name: display_forms_info, dfi
99
100 SYNTAX AS A COMMAND
101
102 dfi -request_type rqt_name
103
104 FUNCTION
105
106 returns forms information based on a request type. It will
107 take a request type name and display a table showing forms
108 options applicable to the request type.
109
110
111 ARGUMENTS
112
113 rqt_name
114 is the name of the request type for which forms
115 information if any will be displayed.
116
117
118 pg 3-263 to 3-264: replace the documentation for the
119 "display_mailing_address" command with the following.
120
121 SYNTAX AS A COMMAND
122
123 dsmla names -control arguments
124
125
126 FUNCTION
127
128 displays the specified mail table entries, in the format
129 used in message headers displayed by read_mail. The default
130 mailing addresses isare given, and any alias names
131 associated with the mail table entry are displayed. In
132 addition, if the mail table entry specifies an ACS segment
133 to allow other maintainers the mail table entry, the
134 pathname of this segment is also displayed.
135
136
137 ARGUMENTS
138
139 names
140 is are the Person_ids or aliases of the user whose
141 mailing address should be displayed, or the names or
142 aliases of a mail table entry for a forum or mailing
143 list. The command displays the mailing address for each
144 one printing a warning message for those that are
145 invalid. If none are given, the default is the mailing
146 address of the user invoking the dsmla command. The
147 star convention is allowed and the address information
148 of any names matching the starname will be displayed
149 See "Notes on starnames".
150
151
152 CONTROL ARGUMENTS
153
154 -name STR, -nm STR
155 specifies a mail table entry name. By using this
156 control argument, STR may literally contain characters
157 which are starname characters e.g. * ?.
158
159 NOTES ON STARNAMES
160
161 As dsmla is insensitive to the type case of the specified
162 name, the matching of starnames is also performed
163 insensitive to type case. If more than one mail table are
164 equal except for type case and all match the given
165 starname, then all are displayed.
166
167
168 pg 3-271: at the beginning of the page add the following new
169 documentation for the "dm_set_free_area" command.
170
171 Name: dm_set_free_area
172
173 SYNTAX AS A COMMAND
174
175 dm_set_free_area PATH -control_args
176
177 FUNCTION
178
179 Sets the directory in which the dm_free_area is placed.
180 Optionally, if there is an existing dm_free_area known to
181 the process, it can be released.
182
183
184 CONTROL ARGUMENTS
185
186 -area_directory pathname, -adr pathname
187 specifies the pathname of the directory to contain
188 dm_free_area.
189 -release_old_area, -roa
190 releases the existing dm_free_area.
191 -no_release_old_area, -nroa
192 prevents the existing dm_free_area from being released.
193
194
195 pg 3-324: for the "exec_com" command version 2, under LIST OF
196 LITERALS add the following after the description of &NL.
197
198 &CR, &CRN
199 expands to a single carriage return character ASCII
200 015 or to N carriage returns.
201
202
203 pg 3-335: for the "exec_com" command version 2, under LIST OF
204 CONTRUCTS replace the line
205
206 &&NL, &QT, &SP, &VT List of literals
207 with
208 &&NL, &CR, &QT, &SP, &VT List of literals
209
210
211 pg 3-395: for the "fortran" command, under ARGUMENTS change the
212 description of "path" to the following.
213
214 path
215 is the pathname of a FORTRAN source program; you need
216 not give the fortran suffix. The archive component
217 pathname convention is allowed.
218
219
220 pg 3-420: for the "get_pathname" command, under CONTROL
221 ARGUMENTS add a NOTES section with the following.
222
223 NOTES
224
225 Since the pathname is returned in quotes, the command
226 processor treats it as a single argument regardless of
227 special characters in the name.
228
229
230 pg 3-471: for the "kermit" command, under LIST OF MODES
231 AFFECTING FILE TRANSFER, add the following note to the
232 description of the "packet_length N" mode.
233
234 Note: Long packets are selected when the user has
235 explicitly selected N, which is larger than 94 with a SET
236 command. The maximum length of long packets can be up to
237 1500 characters.
238
239
240 pg 3-491: for the "link" command, under CONTROL ARGUMENTS add
241 the following control arguments.
242
243 -chase
244 creates a link to the ultimate target of path1A if
245 path1A is a link. The default is to create a link to
246 path1A itself.
247
248 -no_chase
249 creates a link directly to the target specified.
250 Default
251
252
253 pg 3-492.4: for the "links" command, under CONTROL ARGUMENTS
254 delete the "-chase" and "-no_chase" control arguments and
255 change the "-inhibit_error" and "-no_inhibit_error" control
256 arguments to the following.
257
258 -inhibit_error, -ihe
259 ignores star_names that are invalid or if access to tell
260 of an entry's existance is lacking.
261
262 -no_inhibit_error, -nihe
263 prints an error message if given an invalid star_name or
264 if access to tell of an entry's existence is lacking.
265 Default
266
267
268 pg 3-560: for the "memo" command, under LIST OF MEMO OPTIONS
269 delete the following sentence under the description of the
270 "-repeat_when_processed" control argument.
271
272 This is useful for memos that are only significant within a
273 single process.
274
275
276 pg 3-569: for the "menu_get_choice" command, in the NOTES
277 section replace the last two sentences beginning with "Thus,
278 the string..." with the following.
279
280
281 For example, if the string " ?p q" is specified with the
282 -dfkeys argument, it means that you do not care whether the
283 terminal has a function key 0, or a function key 3, but you
284 wish to use function keys 1, 2, and 4. If any one or more
285 of these three functions keys is not defined for the
286 terminal type, then the -dfkeys string is used to create the
287 function key definitions i.e. esc-? substitutes for F1
288 esc-p substitutes for F2 esc-q substitutes for F4 and no
289 other function keys are available. However, if all three
290 of these function keys are available, then no substitution
291 is made and all the function keys defined for the terminal
292 type are available.
293
294
295 If neither the -fkeys argument nor the -dfkeys control
296 argument is used and the terminal has no function keys, then
297 the default function key string used is "0123456789".
298
299
300 pg 3-616.5: for the "nothing" command, at the end of the NOTES
301 section add the following.
302
303 When the functionality of the command 'nothing' is needed in
304 a program, use the entrypoint 'null_entry_' See AG93
305 Subroutines and I/O Modules.
306
307
308 pg 3-637: for the "pl1" command, under ARGUMENTS change the
309 description of "path" to the following.
310
311 path
312 is the pathname of a PL/I source program; the pl1 suffix
313 need not be given. The archive component pathname
314 convention is allowed.
315
316
317 pg 3-640: for the "pl1" command, add the following to the
318 CONTROL ARGUMENTS section.
319
320 -version
321 requests printing of the current version of the
322 compiler. Default
323
324 -no_version
325 suppresses printing of the current version of the
326 compiler.
327
328
329 pg 3-643: for the "pl1" command, under NOTES ON LISTING, add the
330 following paragraph before the paragraph beginning with "If
331 you select -map...".
332
333 If you select -optimize, the compiler will invoke an extra
334 compiler phase just before code generation to perform
335 certain optimizations, and a different algorithm to keep
336 track of the uses and references of variables. This
337 algorithm can warn users about unexpected programming
338 practices under more general conditions, some of which may
339 not be very obvious to users. For example, both optimized
340 and non-optimized compilation may list different variables
341 that have been referenced but never set.
342
343
344 pg 3-680: for the "print_wdir" command, add the following as the
345 second paragraph to the NOTES section.
346
347 Since the working_dir is returned in quotes, the command
348 processor treats it as a single argument regardless of
349 special characters in the name.
350
351
352 pg 3-682: for the "probe" command, before NOTES ON COBOL, add
353 the following section.
354
355 NOTES ON PL/I
356
357 Probe uses a PL/I-like syntax when the current language is
358 PL/I. Probe communicates with you based on information in
359 the symbol table and the statement map, both which are
360 produced by the PL/I compiler. The limitations of the
361 symbol table sometimes limit the communication with probe.
362 For instance,
363
364
365 1 Probe cannot determine the correct dimension size of an
366 array if the upperbound of the dimension is an element
367 other than the first element of an "external" structure.
368 For example:
369
370 dcl x dim l:struct.e4 fixed bin based pt;
371
372 where "e4" is the fourth element in, and "struct" is the
373 external structure. Probe symbol incorrectly
374 interprets the upperbound of the dimension as the first
375 element instead of the proper element in the external
376 structure.
377
378
379 2 Probe cannot determine the correct value of a variable
380 if the variable has an implicit subscripted base
381 reference. For example:
382
383 dcl x fixed bin based b 3;
384
385 Probe value interprets "x based b 3"
386 as "b1 -> x".
387
388
389 3 Probe cannot determine the correct value of a variable
390 if the address of the variable has an implicit base
391 reference containing the address expression or is a
392 defined reference. For example
393
394 dcl x fixed bin based addr pl;
395 or
396 dcl x fixed bin defined p2;
397
398
399 pg 3-714.1: for the "program_interrupt" command correct the
400 spelling of the word "supports" on the last line of the
401 page.
402
403
404 pg 3-729: for the "query" command, add the following to the
405 CONTROL ARGUMENTS section.
406
407 -no_trim
408 does not trim trailing spaces from the question
409 argument.
410
411 -trim
412 trims trailing spaces from the question argument.
413 Default
414
415
416 pg 3-804: for the "response" command, add the following to the
417 CONTROL ARGUMENTS section.
418
419 -no_trim
420 does not trim trailing spaces from the question
421 argument.
422
423 -trim
424 trims trailing spaces from the question argument.
425 Default
426
427
428 pg 3-876: for the "set_mailing_address" command replace the
429 "-user name" control argument with the two following.
430
431 -entryname
432 specifies the entry whose mailing address is to be
433 updated. Enclose the name in quotes if it contains
434 white space. If name is an alias, its associated
435 regular entry is updated. You can use -entry only if
436 you have rw access to the ACS segment associated with
437 the entry. Default: your own entry
438
439
440 -user address
441 specifies the recipient address. The address can be any
442 address accepted by send_mail. You can specify only one
443 address. Use -user in place of the address field if the
444 address can be interpreted as a control argument. It is
445 incompatible with the -dp argument.
446
447
448 pg 3-920: for the "status" command, replace the description of |
449 the "-author" control argument with the following: |
450 |
451 -author, -at |
452 prints the author of the entry. The author is the name |
453 of the user who created the segment or directory. This |
454 attribute cannot be modified. |
455
456
457 pg 9-921.1: for the "status" command, under LIST OF |
458 TYPE-SPECIFIC CONTROL ARGUMENTS, replace the description of |
459 "-bc_author" with the following: |
460 |
461 -bc_author, -bca |
462 prints the bit count author of the entry. The bit count |
463 author is the name of the user who last set the bit |
464 count of the segment or directory. This attribute is |
465 automatically updated when the bit count is set. Not |
466 valid for DM files. |
467
468
469 pg 3-1009: for the "terminate_refname" command add the following
470 to the CONTROL ARGUMENTS section.
471
472 -brief, -bf
473 suppresses all error messages.
474
475
476 pg 3-1046: under LIST OF KEYS for the "user" command, add |
477 "cutoff_date" after the description of "cpu_secs". |
478 |
479 cutoff_date |
480 returns the cutoff date for your spending. |
481
482
483 pg 3-1057.1: for the "value_list" command, under the "-all"
484 control argument, replace
485
486 If you select -all, the default is to omit data
487 variables.
488
489 with
490
491 If you do not select -all, the default is to omit data
492 variables.
493
494
495 pg 3-1094: for the "working_dir" command, change the description
496 of the -no_header control order to the following.
497
498 -no_header, -nhe
499 suppresses the heading before the stack contents are
500 displayed. default
501
502
503 pg 3-1094: for the "working_dir" command, after CONTORL
504 ARGUMENTS add the following NOTES section.
505
506 NOTES
507
508 Since the working_dir is returned in quotes, the command
509 processor treats it as a single argument regardless of
510 special characters in the name.
511
512
513
514 The current working directory is located at location zero.
515 The most recent prior working directory is at the stack
516 position 1 and the least recent prior working directory is
517 at the Nth last position. If a stack of prior working
518 directories is empty then only the current working directory
519 is printed. For the case when the current working directory
520 has been deleted, an attempt to print it out will display
521 the "directory has been deleted" message in square brackets,
522 separated from the directory pathname by a blank space.
523 This does not apply when one or more prior working
524 directories on the stack have been deleted. See also the
525 change_wdir cwd command for stack features.
526
527
528 Examples: Assume the stack looks like the following:
529
530 0 >udd>m>tai>archive_dev
531 1 >udd>m>tai>abbrev_dev
532 2 XXX >udd>m>tai>cwd_dev
533 3 >udd>m>tai
534
535 then
536
537 ! wd XXX
538 2 XXX >udd>m>tai>cwd_dev
539
540
541 ! wd 2 -he
542 LOC LABEL PATHNAME
543
544 2 XXX >udd>m>tai>cwd_dev
545
546 ! wd f:XXX
547 LOC LABEL PATHNAME
548
549 0 >udd>m>tai>archive_dev
550 1 >udd>m>tai>abbrev_dev
551 2 XXX >udd>m>tai>cwd_dev
552
553 ! string wd XXX
554 >udd>m>tai>cwd_dev
555
556
557 ! string wd 2
558 >udd>m>tai>cwd_dev
559
560 ! string wd a
561 >udd>m>tai>archive_dev >udd>m>tai>abbrev_dev
562 >udd>m>tai>cwd_dev >udd>m>tai
563
564 ! dd >udd>m>tai>archive_dev
565 ! wd a
566
567
568 LOC LABEL PATHNAME
569
570 0 >udd>m>tai>archive_dev directory has been deleted
571 1 >udd>m>tai>abbrev_dev
572 2 XXX >udd>m>tai>cwd_dev
573 3 >udd>m>tai
574
575 ! string wd a
576 >udd>m>tai>archive_dev >udd>m>tai>abbrev_dev
577 >udd>m>tai>cwd_dev >udd>m>tai
578
579