1 02/25/85 make_volume_labels
 2 
 3 Syntax as a command:  make_volume_labels volume_spec {-control_args}
 4 
 5 
 6 Function:  generates data for producing stickers to be attached to
 7 volumes (e.g., tape reels and disk packs).  For each volume name
 8 specified, two labels are prepared.  The first label contains the name
 9 of the resource, and the second label contains a three-character
10 authentication code for the volume.  Any number of volume names may be
11 specified, including volume name series.
12 
13 
14 Arguments:
15 volume_spec
16    is either a single volume name, or the sequence "volume_name1 -to
17    volume_name2".  When the second sequence is specified, both
18    volume_name1 and volume_name2 must end with one or more digits.
19    Label data will be produced for each volume in the sequence
20    specified.  Each volume name may be as long as 32 characters.  A
21    volume name may not contain spaces.
22 
23 
24 Control arguments:
25 -auth_only
26    specifies that labels containing the volume names are not to be
27    generated.  If this argument is specified, only authorization code
28    labels are produced.  The default is to produce both types of
29    labels.
30 -height N
31    specifies that the labels on the stock to be used are N lines in
32    height, measured from the first line of one label to the first line
33    of the next label.  The default for N is 9.  The data produced
34    assumes printing at six lines per inch.
35 
36 
37 -name_only
38    specifies that labels containing authorization codes are not to be
39    generated.  If this argument is specified, only volume name labels
40    are produced.  The default is to produce both types of labels.
41 -output_switch switchname, -osw switchname
42    specifies the name of the I/O switch over which the label data is to
43    be written.  If this control argument is omitted, the data will be
44    written over the I/O switch named "label_stream".
45 -width N
46    specifies that the labels on the stock to be used are N characters
47    across.  The default for N is 50.
48 
49 
50 Notes:  Each sticker will contain data in a 5x5 format (see "Examples"
51 below).  Uppercase characters are distinguished from lowercase
52 characters by additional underscoring.  If the data in 5x5 format
53 cannot be accommodated on the size sticker specified, a warning is
54 printed, the data is truncated, and an indicator is appended to the
55 label to show that the name has been truncated.  However, all stickers
56 always contain a line printed in normal characters, containing both the
57 complete volume name and the authentication.
58 
59 
60 If the sequence "volume_name1 -to volume_name2" is specified, both
61 volume names must contain numeric portions, and the rightmost numeric
62 portion of volume-name2 must not be numerically less than that of
63 volume_name1.  Labels are generated for each volume in the sequence.
64 Only the rightmost numeric portion of the resource name is incremented.
65 Leading zeroes are not generated in the significant numeric portion
66 unless they are explicitly specified as part of volume_name1.
67 
68 The I/O switch on which the labels are to be written is assumed to be
69 attached and opened for stream output before the command is invoked.
70 (See the description of the io_call command in the Multics Commands and
71 Active Functions manual, Order No.  AG92, for information on attaching
72 and detaching I/O switches.)