This general macro positions the specified general tape at the beginning of
its initial data record.
Format
- label
- A symbolic name can be assigned to the macro statement.
- NAME
- Specifies the symbolic general tape name. It can be:
- yyy
- A 3-character string representing a symbolic general tape name. The
first 2 characters must be alphabetic, and the third character must be
alphabetic or numeric. For general tapes, the first 2 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-7, 14, or
15.
- 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 to indicate whether
fallback to the first volume of a multivolume file is to be allowed.
- 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.
- error
- The label of an operational program error routine within the current
program segment must be specified as the second parameter.
- F
- An optional keyword parameter can be specified to indicate whether
fallback to the first volume of a multivolume file is to be allowed.
- YES
- Fallback is to be allowed.
- NO
- Fallback is to be inhibited.
If omitted, a default of YES is assumed.
Entry Requirements
- R9 must contain the address of the ECB being processed.
- The general tape specified by this macro must be open when this macro is
issued.
Return Conditions
- If no I/O hardware errors or unusual conditions have occurred, control is
returned to the next sequential instruction (NSI). Otherwise control is
transferred to the address specified by this macro.
- The contents of R14 and R15 are unknown. The contents of all other
registers are preserved across this macro call.
- All pending I/O operations, including this request, are complete for this
ECB.
- For I/O hardware errors, the system error routine has taken a storage dump
and informed CRAS.
Programming Considerations
- This macro can be executed on any I-stream.
- Both keyword and positional parameters may be used in the same macro
call. This practice is not recommended.
- If any I/O hardware errors have occurred, detailed information has been
stored in the ECB.
Examples
None.