SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-82
Verbs Specific to Tandem Products
Verbs Specific to Tandem Products
The following verbs have been created exclusively for the use of SNAX/APC. There is
no functional equivalent in the IBM option sets.
DISPATCH-TP Verb
The SNAX/APC Dispatcher sends a DISPATCH-TP request to the newly created TP to
inform it of a request for a conversation from a remote TP. A TP server receives the
DISPATCH-TP request from the SNAX/APC Dispatcher through $RECEIVE. The
DISPATCH-TP request indicates to the TP server that the designated SNAX/APC local
LU has received a request from a remote TP to attach this TP.
A TP that receives a DISPATCH-TP request should open the SNAX/APC process named
in the request and send it a TP-READY request using the same TPNAME received in the
DISPATCH-TP request.
The TP should reply to the DISPATCH-TP request only when it has completed its work
and is ready to terminate—the conversation is effectively over.
Request Details
REQ-UOW-CODE
contains the value 3002, which identifies the DISPATCH-TP verb.
DT-DISPATCHING-PROCESS
contains the process name of the SNAX/APC process handling the request for this
TP. The TP should use this name in the OPEN procedure call that opens
Request Format
?SECTION DISPATCH-TP-REQ,TANDEM
01 DISPATCH-TP-REQ.
02 DT-HEADER.
03 REQ-UOW-ID PIC X(2).
03 REQ-UOW-CODE PIC 9(4) COMP.
02 DT-PARAMETERS.
03 DT-DISPATCHING-PROCESS PIC X(6).
03 DT-DISPATCHING-LUNAME PIC X(8).
03 DT-TPNAME PIC X(16).
Reply Format
?SECTION DISPATCH-TP-REP,TANDEM
01 DISPATCH-TP-REP.
02 DTR-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.