T-READ

Displays or prints the contents of a tape.

Syntax

T-READ {channel} {(options}

Command Class

TCL-I command.

Syntax Elements

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.

Options

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.

Comments

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

Examples

: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.