HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Control Verbs
TP_ENDED
unsigned char opext;
unsigned char reserv2;
unsigned short primary_rc;
unsigned long secondary_rc;
unsigned char tp_id[8];
unsigned char type;
} TP_ENDED;
3.2.3 Supplied Parameters
The TP supplies the following parameters to APPC:
opcode
AP_TP_ENDED
tp_id
Identifier for the local TP.
The value of this parameter was returned by the TP_STARTED verb for the invoking TP or by the
RECEIVE_ALLOCATE verb for the invoked TP.
type
Specifies how to end the TP. Possible values are:
AP_SOFT
If any APPC conversations are active, APPC performs the function of the [MC_]DEALLOCATE verb for
each conversation, in order to inform the partner TP that the conversation has ended. The TP_ENDED
verb does not return until [MC_]DEALLOCATE has completed.
AP_HARD
APPC closes all sessions used by the TP, and TP_ENDED returns immediately.
3.2.4 Returned Parameters
After the verb executes, APPC returns parameters to indicate whether the execution was successful and, if not, to
indicate the reason the execution was not successful.
Successful Execution
If the verb executes successfully, APPC returns the following parameter:
primary_rc
AP_OK
APPC does not return a secondary_rc when the verb executes successfully.
Unsuccessful Execution
If the verb does not execute successfully, APPC returns a primary return code parameter to indicate the type of
error and a secondary return code parameter to provide specific details about the reason for unsuccessful execution.
Parameter Check
If the verb does not execute because of a parameter error, APPC returns the following parameters:
primary_rc
82