HP-UX SNAplus2 R7 APPC Programmer's Guide

TP Server Verbs
REGISTER_TP_SERVER
5.1.3 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
tps_id
A unique identifier for this TP server. After an application registers itself as a TP server, the value of the
tps_id parameter is valid for that process only. The value of the tps_id parameter is not valid across process
boundaries. If another application tries to use this value of the tps_id parameter on another verb, that verb is
rejected with a primary_rc value of
AP_PARAMETER_CHECK
and a secondary_rc value of
AP_BAD_TPS_ID.
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
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_INVALID_CALLBACK
The callback function address was not valid.
Register Failure
If the application cannot be registered as a TP server, APPC returns the following parameters:
primary_rc
AP_REGISTER_FAIL
Other Conditions
If the verb does not execute because other conditions exist, APPC returns the following primary return code. For a
list of return codes common to all verbs, see Appendix B, Common Return Codes.
primary_rc
AP_UNEXPECTED_SYSTEM_ERROR
5.1.4 Usage Notes
This section provides additional usage information about the callback routine.
Callback Routine
The application supplies a pointer to a callback routine as one of the parameters to the VCB. This section describes
how SNAplus2 uses this routine and the functions that it must perform.
The callback routine is defined as follows:
251