1 06/12/87  list_tape_contents, ltc
 2 
 3 Syntax: list_tape_contents {-long} {-label}, ltc {-lg} {-lbl}
 4 
 5 
 6 Function:  displays information about each record on the tape.
 7 The tape is positioned to BOT and each record is read in.  If
 8 the tape is one of the five known standard types, the current
 9 record is inspected to determine if it is a valid label or
10 trailer record; if so, information pertinent to that particular
11 label or trailer record is displayed, in interpreted format.
12 
13 
14 Control arguments:
15 -long, -lg
16    The contents of the label record is displayed (in ASCII) as
17    well.  Otherwise, the length of the current record is
18    compared to the length of the last record read.  If the
19    lengths are the same, a tally of the number of records with
20    the same length is incremented.  If the length of the
21    current record is different from that of the last record,
22    or if an end of file mark is detected, a message is
23    displayed that includes:  the number of records of equal
24    length, and the record length in bits, words, 8-bit bytes,
25    9-bit bytes, and 6-bit characters.
26 
27 
28 -label, -lbl
29    only displays the label records.  This operation continues
30    until the logical end of tape is reached (two end of file
31    marks in succession or an end of volume trailer record,
32    followed by an end of file mark).  The tape is repositioned
33    to BOT after the list_tape_contents request is complete.
34    Use of the -label argument with unlabeled tapes is treated
35    as an error.
36