HP-UX SNAplus2 R7 APPC Programmer's Guide

Writing Transaction Programs
APPC Verb Summary
2.1.3 TP Server Verbs
UNIX
TP server verbs allow applications to start TPs in response to requests from SNAplus2:
REGISTER_TP_SERVER
UNREGISTER_TP_SERVER
REGISTER_TP
UNREGISTER_TP
QUERY_ATTACH
ACCEPT_ATTACH
REJECT_ATTACH
ABORT_ATTACH
Note
TP server verbs, as described in Chapter 5, TP Server Verbs, must be issued using the
asynchronous entry point APPC_Async, and not the synchronous entry point APPC.
2.2 APPC Verb Summary
This section briefly describes each APPC verb. The APPC verbs are grouped by function. (The total functionality
of a verb may be broader than this summary indicates. For a detailed explanation of a particular verb, see Chapter
3, APPC Control Verbs, or Chapter 4, APPC Conversation Verbs.)
2.2.1 Starting a Conversation
The following verbs are used to start a conversation between two TPs. For more information, see Section 2.9,
Starting TPs.
TP_STARTED
This verb is issued by the invoking TP. It notifies APPC that the invoking TP is starting. Upon successful
execution, this verb returns a TP identifier (tp_id) for the invoking TP.
UNIX
SET_TP_PROPERTIES
This verb is used by a TP to set properties relating to the local TP, which are then used when allocating new
conversations. This enables the TP to specify the following:
• Logical Unit of Work (a transaction between APPC TPs to accomplish a particular task) with which a
conversation is associated
• User ID for use when allocating a new conversation and indicating that the conversation security has
already been verified
MC_ALLOCATE or ALLOCATE
This verb is issued by the invoking TP. It allocates a session between the local LU and a remote LU and
establishes a conversation between the invoking TP and the invoked TP.
45