1 01/14/87  set_max_length, sml
 2 
 3 Syntax as a command:  sml path length {-control_args}
 4 
 5 
 6 Function:  allows the maximum length of a nondirectory segment to be
 7 set.
 8 
 9 
10 Arguments:
11 path
12    is the pathname of the segment whose maximum length is to be set.
13    If path is a link, the maximum length of the target segment of the
14    link is set.  You can use the star convention.
15 length
16    is the new maximum length expressed in words.  If this length is not
17    a multiple of 1024 words, it is converted to the next higher
18    multiple of 1024 words.
19 
20 
21 Control arguments:
22 -brief, -bf
23    suppresses the warning message that the length argument has been
24    converted to the next multiple of 1024 words.
25 -decimal, -dc
26    specifies that length is a decimal number.  (Default)
27 -interpret_as_extended_entry, -inaee
28    interpret the selected entry as an extended entry type.
29 -interpret_as_standard_entry, -inase
30    interpret the selected entry as a standard entry type.
31 -octal, -oc
32    specifies that length is an octal number.
33 
34 
35 Access required:  You need m permission on the directory containing the
36 segment.
37 
38 
39 Notes:  The maximum length is the maximum size the segment can attain.
40 Currently maximum length must be a multiple of 1024 words (one page).
41 
42 If the new maximum length is less than the current length, you are
43 asked if the segment should be truncated to the maximum length.  If you
44 answer "yes," the truncation takes place and the maximum length of the
45 segment is set; if "no," no action is taken.
46 
47 You can't set the maximum length of a mailbox or message segment unless
48 the segment is empty.