Home > MultiValue Central > Online D3 Reference > BASIC Program > basic.readtl

basic.readtl

Statement/BASIC Program, Releases: AP

Reads label from magnetic media.

Syntax

readtl variable [then | else | onerr statement.block]

Description

reads a tape label and initializes the internal label storage area.

The 'then' clause is taken if the operation is successful.

Either 'else' or 'onerr' can be specified, but not both. If the tape unit has not been attached or if an end-of-file (EOF) mark is read, the 'else' or 'onerr' clause, if present, is executed. In addition, the 'onerr' statement can be used to check for end-of-tape (EOT), tape unit not ready, parity error, or block transfer error. See the system(0) function.

See the 'then/else construct' for an explanation on the use of 'then' and 'else' clauses in statements that allow or require them.

See Also

Command Name Type Description
basic.then/else.construct Definition provide program flow change based upon a boolean condition.
basic.readtx Statement Reads one tape record and displays in hexadecimal.
basic.readt Statement Reads one tape record.
tcl.set-device Verb: Access Attaches device (sct/floppy/half) on AIX.
basic.onerr Definition Takes 'error' path when media error encountered.
statement.block Definition one or more statements that follow a Pick/BASIC decision-path related token such as, but not limited to, 'then', 'else', 'locked' and 'onerr'.
tcl.t-att Verb: Access Attaches magnetic media unit to current process.
tape.label Definition Description of Pick tape labels.
basic.rewind Statement Rewinds magnetic media.
tcl.t-rdlbl Verb: Access Reads label from magnetic media.
basic.statements Definition Definition of statements and functions.
basic.system Function Displays status of system-controlled variables.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.