This general macro writes a record from a storage block to the specified
general tape. The block of storage containing the record is detached
from the ECB and returned to the appropriate pool.
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.
- LEVEL=Dx
- A symbolic data level (D0-DF) must be specified.
The following macro format is still supported:
- label
- A symbolic name can be assigned to the macro statement.
- name
- A 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.
Entry Requirements
- R9 must contain the address of the ECB being processed.
- A storage block must be held by the ECB on the data level specified by
LEVEL.
- 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.
- The file address reference word on the data level specified by
LEVEL is unchanged.
- The core block reference word on the data level specified by
LEVEL is updated to indicate that the storage block is no longer held
by the ECB.
- When a condition such as End-of-Volume (EOV) or permanent error occurs, a
tape switch will automatically occur. For the TWRTC macro, AUTO=YES is
implied. (See TDCTC macro in TPF System
Macros or TSYNC-Synchronize Tape for more information about the AUTO parameter).
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.
- The control program checks to ensure that the ECB is holding a storage
block on the data level specified by this macro and that the general tape name
specified by this macro is open. If either condition is not met,
control is transferred to the system error routine.
- The status of the Write operation can never be determined by the
operational program.
- The operational program may use the request level specified by this macro
immediately upon return from the control program.
- The contents of the entire storage block are written to tape.
- When writing to an unblocked general tape mounted on a buffered device,
the mode of operation (buffered or Tape Write Immediate) is determined by the
setting of the tertiary status byte in the tape status table.
Examples
None.