1 :Info: list_tape_contents: ltc:  1985-10-31  list_tape_contents, ltc
  2 
  3 Syntax as a command:
  4   ltc vol1 {-comment COMMENT_STRING} ... volN {-com COMMENT_STRING}
  5              {-attach_args} {-control_args}
  6 
  7 
  8 Function: prints information about files recorded on 9-track magnetic
  9 tape in either ANSI standard labeled or IBM standard labeled format.
 10 
 11 
 12 Arguments:
 13 vol(i) {-comment COMMENT_STRING}
 14    specifies the name of the tape volume set to be listed.
 15    (See "Notes on volume selection" below for more information.).
 16 -comment COMMENT_STRING, -com COMMENT_STRING
 17    displays comment_string on the operator's console when the
 18    volume_name immediately preceding -comment is mounted.
 19 -attach_args
 20    mtape_ attach control arguments.  (See "Notes on attachment" below
 21    for more information.).
 22 
 23 
 24 Control arguments:
 25 -volume_type type, -vt type
 26    specifies the format type of volume set being processed.  The value
 27    of type may be "ibm" or "ansi".  When -volume_type is omitted the
 28    tape format type defaults to "ansi".
 29 -brief, -bf
 30    prints the identifier and sequence number of each file selected from
 31    the volume set.
 32 -long, -lg
 33    prints detailed information about each file selected from the
 34    volume set.
 35 
 36 
 37 -from N
 38    starts output of information with file number N
 39    where: 0 < N < 10000
 40 -to N
 41    stops processing the volume set after file number N
 42    where: 0 < N <10000
 43 
 44 
 45 Notes on volume selection:
 46 When specifying the volume identifier, The -volume (-vol) control
 47 argument must proceed any volume identifier which begins with a hyphen.
 48 
 49 If the volume set to be listed was created on Multics, only the first
 50 volume identifier of the volume set must be input.  The remainder of
 51 the identifiers are retieved automatically from the volume set.
 52 
 53 If the volume set to be listed was NOT created on Multics, each volume
 54 identifer must be given.
 55 
 56 Up to 64 volumes may be selected.
 57 
 58 
 59 Notes on volume set information:
 60 The information printed by this command is extracted from the tape
 61 labels and printed in various amounts according to the control
 62 arguments supplied.  The information available for each level of
 63 control is shown below.  Where information is not obtainable from the
 64 label, the value "****" is printed as the item entry.
 65 
 66 
 67 Notes on output control arguments:
 68 File information displayed by list_tape_contents changes when -brief
 69 or -long control arguments are used, as shown in the table below.
 70 
 71 Id:         <file identifier>                   | -brief |           |
 72 Number:     <file sequence number>              |    -bf |           |
 73 Format:     <record format>                              |           |
 74 Blksize:    <physical block size in characters>          | (default) |
 75 Lrecl:      <logical record length in characters>        |           |
 76 Mode:       <encoding mode>                              |           | -long
 77 Created:    <file creation date>                         |           |   -lg
 78 Expires:    <file expiration date>                       |           |
 79 Section:    <file set section number>                                |
 80 Version:    <file generation version number>                         |
 81 Generation: <file generation number>                                 |
 82 
 83 
 84 Notes on attachment:
 85 A complete attach description is created for processing the volume set.
 86 It is composed of the string:
 87 
 88   "mtape_ -volume_type ansi -no_display -density 1600 -track 9
 89           -error -device 1 -label -no_system -no_wait "
 90 
 91 or
 92 
 93   "mtape_ -volume_type ibm  -no_display -density 1600 -track 9
 94           -error -device 1 -label -no_system -no_wait "
 95 
 96 Any mtape_ attach control arguments supplied to ltc are added to the
 97 end of the attach description and passed to mtape_.
 98 
 99 
100 Notes on mtape_ setup operation defaults:
101 To avoid unexpected results, ltc supplies complete open, close and
102 detach descriptions to mtape_.  These arguments will override any
103 default values that may have been established by the mtape_set_defaults
104 command.
105 
106 
107 Examples:
108 
109 ltc m9999
110 Mounting volume "m9999" with no write ring
111 Mounted ANSI volume "m9999" (recorded at 1600 BPI), on device tapa_07
112 
113 ID       Number   Format   Blksize   Lrecl    Mode   Created   Expires
114 
115 FILE0001      1     SB        8192 1044480   BINARY  09/30/85  12/31/99
116 FILE0002      2     SB        2048 1044480   BINARY  09/30/85  12/31/99
117 
118    --------------------
119 
120 
121 ltc m9999 -bf -from 2 -to 4 -vt ansi
122 Mounting volume "m9999" with no write ring
123 Mounted ANSI volume "m9999" (recorded at 1600 BPI), on device tapa_07
124 
125 ID                                Number
126 
127 FILE0002                               2
128 FILE0003                               3
129 FILE0004                               4
130 
131    --------------------
132 
133 
134 ltc m9999 -lg
135 Mounting volume "m9999" with no write ring
136 Mounted ANSI volume "m9999" (recorded at 1600 BPI), on device tapa_03
137 
138 ID: ATTRIBUTEFILE0001                  Number:        1  Section:        1
139 Created: 10/21/85  Expires: 12/31/99   Generation:    1  Version:        0
140 Format:  SB        Mode:    BINARY     Blksize:    8192  Lrecl:    1044480
141 
142 ID: ATTRIBUTEFILE0002                  Number:        2
143 
144 ID: ATTRIBUTEFILE0003                  Number:        3
145 
146 Displayed characteristics for the last 3 files are identical.
147 
148    --------------------
149 
150 
151 ltc m9999 -long -comment "message to console" -vt ibm
152 
153 
154 :hcom:
155 
156 
157 
158 /****^  HISTORY COMMENTS:
159   1) change(2020-12-15,GDixon), approve(2021-02-22,MCR10088),
160      audit(2021-05-27,Swenson), install(2021-05-27,MR12.6g-0056):
161       A) Change "Syntax:" to "Syntax as a command:" in command info seg
162          last changed after 1984.
163       B) Fix other errors reported by the verify_info command.
164                                                    END HISTORY COMMENTS */
165 
166 
167