gtpg2m44General Macros

TBSPC-Backspace General Tape and Wait

This macro moves the specified general tape backward over a specified number of physical blocks.

Format




label
A symbolic name can be assigned to the macro statement.

NAME
Specifies the symbolic general tape name. It can be:

yyy
A three-character string representing a symbolic general tape name. The first two characters must be alphabetic, and the third character must be alphabetic or numeric. For general tapes, the first two characters cannot be RT.

(Rn)
The number of a register containing a pointer to the symbolic real-time tape name. n must be a decimal number from 0 through 7, 14, or 15.

LEVEL=Dx
A symbolic data level (D0-DF) must be specified.

ERROR=label
The label of an operational program error routine within the current program segment must be specified.

F
An optional keyword parameter can be specified indicating whether fallback to a previous volume is to be allowed when processing multivolume files. This will occur when an attempt is made to backspace a tape past the load point.

YES
Fallback is to be allowed.

NO
Fallback is to be inhibited.

If omitted, a default of YES is assumed.

The following macro format is still supported:



label
A symbolic name can be assigned to the macro statement.

name
A 3-character symbolic general tape name must be specified as the first parameter.

Dx
A symbolic data level (D0-DF) must be specified as the second parameter.

error_branch
The label of an operational program error routine within the current program segment must be specified as the third parameter.

F
An optional keyword parameter can be specified indicating whether fallback to a previous volume is to be allowed when processing multivolume files. This will occur when an attempt is made to backspace a tape past the load point.

YES
Fallback is to be allowed.

NO
Fallback is to be inhibited.

If omitted, a default of YES is assumed.

Entry Requirements

Return Conditions

Programming Considerations

Examples

None.