This general macro makes the specified general tape available to the
operational program.
Format
- label
- A symbolic name can be assigned to the macro statement.
- NAME
- Specifies the symbolic general tape name. It can be:
- ccc
- 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 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.
- STATUS=I|O
- The input or output status must be specified. This parameter must
be coded as either I or O.
- BUF
- An optional keyword parameter can be specified indicating the output mode
to be used when writing to buffered devices.
- YES
- Buffered mode is to be used.
- NO
- Tape Write Immediate (TWI) mode is to be used.
If omitted, a default of BUF=NO is assumed. This parameter has
meaning only when the tape is mounted on a buffered device. It is
ignored when the tape is mounted on a nonbuffered device.
The following macro format is still supported:
Notes:
- status
- 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.
- status
- The input or output status must be specified as the second
parameter. This parameter must be coded as either I or O.
- BUF
- An optional keyword parameter can be specified indicating the output mode
to be used when writing to buffered devices.
- YES
- Buffered mode is to be used.
- NO
- Tape Write Immediate (TWI) mode is to be used.
If omitted, a default of BUF=NO is assumed. This parameter has
meaning only when the tape is mounted on a buffered device. It is
ignored when the tape is mounted on a nonbuffered device.
Entry Requirements
- R9 must contain the address of the ECB being processed.
- The general tape specified by this macro must not 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.
- Control is returned to the operational program when the specified tape is
ready for use.
- The positioning of the specified tape is unchanged. (Refer to TCLSC-Close a General Tape for more information on tape positioning after a tape is
closed.)
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.
- A TCLSC macro or TRSVC macro must be issued for all open tapes prior to
issuing an EXITC macro.
- If the tape is mounted on a nonbuffered device, the buffered mode keyword
parameter (BUF) is ignored.
- If the tape is opened as an output tape and is mounted in blocked mode,
the buffered mode keyword parameter (BUF) causes the appropriate indicator to
be set in the tape status table entry. However, this indicator will be
ignored for subsequent writes to the tape, and all write operations will be
performed in buffered mode.
- If this macro is issued prior to the end of tape restart, the ECB is
exited and a system error issued.
Examples
None.