Displays or prints the contents of a tape.
T-READ {channel} {(options}
TCL-I command.
channel Optional. The channel to which the required tape units have been attached using the ASSIGN command. If omitted, the tape units attached to the default channel are used.
N Inhibits automatic paging of output to the terminal.
P Dumps to the printer.
X Dumps in hexadecimal instead of character format.
n{-m} Dumps records n to m counting from the current position of the tape. If m is omitted, n records are output starting from the current position. If the entire n-m option is omitted, all records up to an EOF mark are dumped.
Before using T-READ, you must attach the required tape units to the port.
The T-READ operation finishes when the specified number of records have been dumped, or when an EOF is detected. The operation can be terminated prematurely by typing CTRL+E instead of RETURN, provided that you do not specify the N or P options.
If a T-READ is performed on a tape which has no label (type 0), it displays:
LABEL = NO LABEL
:
T-READ (4-6
The first three records are bypassed and the 4th, 5th and 6th are dumped; the tape is positioned at the beginning of the 7th record.
:
T-READ (P4-6
Does the same as the first example, but dumps to a printer.
:
T-READ B (X
The contents of the tape, up to EOF, are dumped in hexadecimal format.