Use this system macro to add, delete, or locate a transaction manager
control record (TMCR) in the transaction anchor table (TANC).
Required Authorizations
|
Key0
| Restricted
| System
| Common Storage
|
| X
|
|
|
Format
- ACTION
- Defines the type of action requested. This parameter is
required. The following actions are valid:
- ADD
- To add a TMCR pointer to the TANC.
- DELETE
- To remove a TMCR pointer from the TANC.
- LOCATE
- To locate a TMCR pointer for a given transaction ID (TID).
- TMCR=Rx
- A register (R0-R7, R15) that contains the address of a TMCR.
This is a required input parameter when ADD or DELETE are specified, and is
also a required output parameter when LOCATE is specified.
- TID=Ry
- A register (R0-R7, R15) that contains the address of the TID that
is used to locate the TMCR pointer in the TANC. This parameter is
required only when locating a TMCR pointer.
Entry Requirements
- When adding or deleting a TMCR pointer, the register must point to the
TMCR that will be added to or removed from the TANC.
- When locating a TMCR pointer, the register must point to the TID that will
be used to locate the TMCR in the TANC. R9 must point to a valid entry
control block (ECB).
Return Conditions
- Control is returned to the next sequential instruction (NSI).
- The contents of R0-R7 are preserved across this macro call.
- The condition code (CC) is not preserved across the macro call.
- The macro service routine will set R14 to contain a hexadecimal return
code that can be used by the calling program.
- R14=00
- Request is completed successfully.
- R14=-2
- Input TMCR parameter is 0.
- R14=-3
- Input TID parameter is 0.
- R14=-4
- Adding a TMCR pointer was not successful because the TID in the input TMCR
already exists.
- R14=-5
- Deleting or locating a TMCR pointer was not successful because no matching
TID exists in the TANC.
Programming Considerations
Examples
The following example shows how to add a TMCR into the TANC.
TANCC ACTION=ADD,TMCR=R2