SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-99
TP-READY Verb
Sync Point Support in the TP-READY Verb
With the addition of sync point support, SNAX/APC has added three new attributes and
a new IPC header version code to the TP-READY verb.
The new attributes are:
•
SYNCSUPPORT - this TP-READY request attribute specifies whether the
Transaction Program requires sync point support for its transactions. The possible
values for this attribute are: SYNCSUPPORT { Y | N }
•
LUWID - this TP-READY reply attribute contains the newly generated, unique
LUWID that supports sync point operation. An LUWID is returned in a TP-
READY reply only if the SYNCSUPPORT parameter in the TP-READY request
was set to ‘Y’.
•
TR-MAX-DATA-LENGTH
The new IPC header version is (S5) is supported by SNAX/APC for sync point support.
The user-supplied sync point routines should specify the VERSION-CODE field in the
IPC header as follows:
•
S5 indicates that the TP-READY verb UOW contains the SYNCSUPPORT
parameter.
Request Format (IPC Version Code S1, S2, or S3)
?SECTION TP-READY-REQ,TANDEM
01 TP-READY-REQ.
02 TR-HEADER.
03 REQ-UOW-ID PIC X(2).
03 REQ-UOW-CODE PIC 9(4) COMP.
02 TR-PARAMETERS.
03 TR-LOCAL-ATTACH-INDICATOR PIC X(1).
03 TR-DISPATCHED-INDICATOR PIC X(1).
03 TR-APC-LUNAME PIC X(8).
03 TR-LOCAL-TPNAME PIC X(16).
Reply Format (IPC Version Code S1, S2, or S3)
?SECTION TP-READY-REP,TANDEM
01 TP-READY-REP.
02 TRR-HEADER.
03 REP-UOW-ID PIC X(2).
03 REP-VERB-CODE PIC 9(4) COMP.
03 REP-RETURN-CODE PIC S9(4) COMP.
03 REP-RETURN-CODE-DETAIL PIC S9(4) COMP.
02 TRR-PARAMETERS.
03 RESERVED-2 PIC X(2).