gtpg2m4zGeneral Macros

TSYNC-Synchronize Tape

This general macro synchronizes a real-time or general tape. Tape synchronization ensures that the position of the tape, as detected by the device, is the same as detected by the application. This eliminates any discrepancies introduced by buffering; either logical (that is, tapes mounted in blocked mode) or physical (that is, tapes mounted on a device operating in buffered mode).

Format




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

NAME
Specifies the symbolic general or real-time tape name. It can be:

ccc
A 3-character string representing a symbolic general or real time tape name. The first 2 characters must be alphabetic, and the third character must be alphabetic or numeric.

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

AUTO=NO|YES
An optional keyword parameter may be specified indicating whether a tape switch is to occur on a synchronize error. If specified, this parameter must be coded as YES if tape switch is to occur or as NO if tape switch is not to occur. If the tape is blocked, this parameter is forced to YES, even if it was coded as NO or omitted. If the tape is not blocked and the parameter is omitted, a default of NO 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 tape name must be specified as the first parameter.

AUTO=NO|YES
An optional keyword parameter may be specified indicating whether a tape switch is to occur on a synchronize error. If specified, this parameter must be coded as YES if tape switch is to occur or as NO if tape switch is not to occur. If the tape is blocked, this parameter is forced to YES, even if it was coded as NO or omitted. If the tape is not blocked and the parameter is omitted, a default of NO is assumed.

Entry Requirements

Return Conditions

Programming Considerations

Examples

None.