HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Control Verbs
TP_ENDED
APPC does not return secondary return codes with these primary return codes.
3.1.5 State When Issued
TP_STARTED must be the first APPC verb issued by the invoking TP. Consequently, no conversations are active
and no conversation state exists.
A single APPC program can issue more than one TP_STARTED verb. Each verb creates a logically different APPC
TP, although they are all executing in the same process.
3.1.6 State Change
Not applicable (no conversations have been started, so there is no conversation state).
3.2 TP_ENDED
The TP_ENDED verb is issued by both the invoking and the invoked TPs. It notifies APPC that the TP is ending.
In response to this verb, APPC frees the resources used by the TP.
If an APPC conversation is still in progress, TP_ENDED performs the function of the [MC_]DEALLOCATE verb
with
dealloc_type set to AP_ABEND (for a mapped conversation) or AP_ABEND_PROG (for a basic conversation).
After this verb executes, the TP identifier and conversation identifier are no longer valid; the TP cannot issue any
more APPC verbs for the conversation.
3.2.1 VCB Structure: TP_ENDED
UNIX
The definition of the VCB structure for the TP_ENDED verb is as follows:
typedef struct tp_ended
{
AP_UINT16 opcode;
unsigned char opext; /* Reserved */
unsigned char format; /* Reserved */
AP_UINT16 primary_rc;
AP_UINT32 secondary_rc;
unsigned char tp_id[8];
unsigned char type;
} TP_ENDED;
3.2.2 VCB Structure: TP_ENDED (Windows)
WINDOWS
The definition of the VCB structure for the TP_ENDED verb is as follows:
typedef struct tp_ended
{
unsigned short opcode;
81