SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-102
TP-READY Verb
INST-NUM
For sync support only, this component of the LUWID contains the a transaction
instance number that is unique to the LU that created it.
SEQ-NUM
For sync support only, this component of the LUWID contains a sequence number
that starts at 1 and is incremented by 1 following each commit or backout operation.
Return Codes
The following return codes can be returned in REP-RETURN-CODE of
TRR-HEADER:
RC-OK
RC-PARAMETER-ERROR
The REP-RETURN-CODE-DETAIL is not set in a TP-READY reply.
Considerations
•
If the IPC reply code for the TP-READY UOW indicates INVALID-UOW-
HEADER and the IPC return code contains INVALID-HEADER, the RETURN-
CODE-DETAIL field indicates what is in error.
•
If an unauthorized TP issues a general TP-READY UOW, the RETURN-CODE-
DETAIL field contains INVALID-TPN.
•
It is illegal to send a TP-READY request in which TR-LOCAL-ATTACH-
INDICATOR contains Y and TR-DISPATCHED-INDICATOR contains Y.
Table 3-1 illustrates the possible combinations of the LOCAL-ATTACH indicator
and the DISPATCHED indicator.
•
If a TP-READY verb is processing when SNAX/APC receives a CANCEL system
message from the application program, SNAX/APC replies to the cancelled IPC
immediately and removes the TP-READY request from its internal queues. In the
case of a remote TP-READY, that TP-READY is no longer available to service
incoming attaches.
Table 3-1. Combinations of the LOCAL-ATTACH and DISPATCHED Indicators
LOCAL ATTACH=Yes LOCAL ATTACH = No
DISPATCHED = Yes invalid DISPATCHED
DISPATCHED = No LOCAL-ATTACH READY-FOR-REMOTE