This macro returns a specified general tape to the system.
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.
- D=YES|NO
- An optional parameter can be coded to indicate if a dismount is to be
performed for this tape, which would remove the tape name from the tape status
table. If specified, this parameter must be coded as YES or NO.
If omitted, a default of YES is assumed.
- R=YES|NO
- An optional parameter can be coded to indicate whether a rewind is to be
performed for this tape. If specified, this parameter must be coded as
YES or NO. If omitted, a default of YES is assumed.
- U=YES|NO
- An optional parameter can be coded to indicate whether an unload is to be
performed for this tape. If specified, this parameter must be coded as
YES or NO. If omitted, a default of YES is assumed.
- EXIT=YES
- This parameter is a special interface for EXITC processing. This
interface will allow tape close processing to force the tape to be closed and
bypass any resulting dumps. This parameter is only valid for the EXITC
service routine.
The following positional parameters are still supported:
- name
- A 3-character symbolic general tape name must be specified as the first
parameter.
The remaining parameters are described in the preceding list.
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
- Control is returned to the next sequential instruction.
- The contents of R14 and R15 are unknown. The contents of all other
registers are preserved across this macro call.
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.
- General tapes that are closed are no longer available to the operational
program.
- If the rewind parameter (R) is coded as NO, the tape is closed and
positioned before the tape mark which precedes the trailer labels on the
current volume of the dataset. If the rewind parameter (R) is coded as
YES and the unload parameter (U) is coded as NO, the tape is closed and
positioned after the tape mark which follows the header labels on the first
volume of the dataset.
- A TCLSC macro or TRSVC macro must be issued for all open tapes prior to
issuing an EXITC macro.
- A TCLSC macro performs the equivalent of a TSYNC macro before closing the
tape to ensure that all data from a tape buffer is physically written to the
tape. (Refer to TSYNC-Synchronize Tape for a description of synchronization processing.)
Examples
None.