SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-96
TP-END Verb
TP-END Verb
The TP-END verb releases all resources allocated under one TP-READY, essentially
canceling the TP-READY. When a TP successfully issues a TP-READY request, it
associates the TP with a SNAX/APC LU. A TP-END verb request breaks this
association.
When a local TP issues a TP-READY request, SNAX/APC allocates a transaction
control block (TCB) to that TP. The TCB associates the TP with the SNAX/APC LU.
The TP-END verb request deallocates the TCB. SNAX/APC returns the deallocated
TCB to a pool from which it can be allocated to another TP at a later time. The TP-
END verb request is the only verb that can release a TCB.
A local TP must issue a TP-END verb request when it has completed its conversation
associated with a TP-READY. (TCBs, although not limited, are a finite resource. Their
release is important.) The TP can issue TP-END anytime after a TP-READY. However,
if a conversation is active when the TP issues TP-END, SNAX/APC deallocates that
conversation abnormally (REP-RETURN-CODE contains RC-DEALLOCATE-
ABEND-PROG and REP-RETURN-CODE-DETAIL contains RCD-ABEND-TP-
LOCAL).
Request Details
REQ-UOW-CODE
must contain the value 3006, which identifies the TP-END verb.
Considerations
•
To identify the correct TP-READY, the IPC header must contain the last resource ID
received from the conversation active under that TP-READY.
•
If the resource ID returned from a previous request contains 0 (zero), do not issue
TP-END. A zero resource ID means that the resources for the current conversation
do not exist. Issuing TP-END causes an error.
Request Format
?SECTION TP-END-REQ,TANDEM
01 TP-END-REQ.
02 TE-HEADER.
03 REQ-UOW-ID PIC X(2).
03 REQ-UOW-CODE PIC 9(4) COMP.
Reply Format
?SECTION TP-END-REP,TANDEM
01 TP-END-REP.
02 TER-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.