HP-UX SNAplus2 R7 APPC Programmer's Guide

TP Server Verbs
REGISTER_TP_SERVER
5.1.1 VCB Structure: REGISTER_TP_SERVER
The definition of the VCB structure for the REGISTER_TP_SERVER verb is as follows:
typedef struct register_tp_server
{
AP_UINT16 opcode;
unsigned char rsrvd1; /* Reserved */
unsigned char rsrvd2; /* Reserved */
AP_UINT16 primary_rc;
AP_UINT32 secondary_rc;
AP_UINT32 tps_id;
unsigned char tp_file_updates;
AP_NOTIFY_CB notify_cb;
} REGISTER_TP_SERVER;
typedef void (*AP_NOTIFY_CB) (
unsigned char reason,
unsigned char attach_id[8],
AP_CORR app_corr
);
typedef union ap_corr {
void * corr_p;
AP_UINT32 corr_l;
AP_INT32 corr_i;
} AP_CORR;
5.1.2 Supplied Parameters
The TP supplies the following parameters to APPC:
opcode
AP_REGISTER_TP_SERVER
tp_file_updates
Requests whether the application should be notified when the sna_tps TP configuration file is updated.
Possible values are:
AP_YES
The application requests callbacks to notify it that the sna_tps file has been changed.
AP_NO
The application does not require notification of changes to the sna_tps file.
notify_cb
The address of the notification callback function. APPC uses this function in conjunction with the value of
the app_corr parameter specified on the REGISTER_TP verb to notify a TP server that one of the following
has occurred:
• A suitable Attach is available
• The sna_tps TP configuration file has changed (if the application requested this notification by setting
the tp_file_updates parameter to AP_YES).
For more information on how the notification callback function is used, see Section 5.1.4, Usage Notes.
250