This general macro attaches the TPF Application Requester (TPFAR) feature
Structured Query Language Transaction Profile (STP) and
associated blocks to an entry control block (ECB). This database
support structure must have been detached from this or another ECB using the
DBSDC macro. See DBSDC-Detach TPF Application Requester Database Support Structure for additional information.
Format
- label
- A symbolic name can be assigned to the macro statement.
- ID
- Specify one of the following:
- area
- The symbolic name of a fullword area that contains the address of an
8-byte identifier for the TPFAR database support structure to attach.
The TPFAR database support structure identifier must have been returned by
DBSDC.
- reg
- A register, R0-R5, containing the address of a fullword area that
contains the address of the identifier for the 8-byte TPFAR database support
structure to attach. The TPFAR database support structure identifier
must have been returned by DBSDC.
If the ID parameter is omitted or invalid, R1 is the default.
Entry Requirements
- R9 must contain the address of the ECB being processed.
- A TPFAR database support structure must have been detached using the DBSDC
macro.
- A TPFAR database support structure is not already attached to the
ECB.
Return Conditions
- Control is returned to the next sequential instruction.
- R6 contains one of the following return conditions:
- 0 - DBSAC_SUCCESSFUL
- Completed successfully.
- 1 - DBSAC_INUSE
- A TPFAR database support structure is already attached to the current
ECB.
- 3 - DBSAC_DBSFINDERR
- Unable to find the TPFAR database support structure.
- 4 - DBSAC_CCAFINDERR
- Unable to find a file record associated with a cursor control area (CCA)
entry.
- The contents of R7, 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.
- A TPFAR database structure must have been released using the DBSDC
macro.
- A system error with return results if an invalid TPFAR database structure
identifier is specified.
- When the TPFAR database structure is reattached to the ECB, the TPFAR
database structure identifier is no longer valid and must not be
reused.
Examples
None.