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

basic.rewind

Statement/BASIC Program, Releases: AP and R83

Rewinds magnetic media.

Syntax

rewind [then | else | onerr statement.block]

Description

rewinds the currently attached magnetic media unit to the 'beginning' of the media.

If the tape is not attached or not on-line, the 'else' or 'onerr' clause, if present, is executed. Otherwise the 'then' clause is executed. In addition, the 'onerr' statement can be used to check for a 'tape unit not ready' error.

Either 'else' or 'onerr' may be specified, but not both. See the 'then/else construct' for an explanation on the use of 'then' and 'else' clauses in statements that allow or require them.

Example

execute 't-att'
rewind else
crt 'cannot rewind the tape'
stop
end

See Also

Command Name Type Description
basic.then/else.construct Definition provide program flow change based upon a boolean condition.
basic.onerr Definition Takes 'error' path when media error encountered.
basic.statements Definition Definition of statements and functions.
basic.readt Statement Reads one tape record.
basic.readtl Statement Reads label from magnetic media.
basic.readtx Statement Reads one tape record and displays in hexadecimal.
basic.weof Statement Writes an end-of-file mark to tape.
tcl.t-att Verb: Access Attaches magnetic media unit to current process.
tcl.t-rew Verb: Access Rewinds magnetic media.
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'.
basic.if Statement Initiates logical expression.
basic.system Function Displays status of system-controlled variables.
basic.ifr Statement Initiates a multi-attribute logical expression.

User Comments

What do you think?

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

Login to leave your comments.