HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_AVAILABLE_TP
primary_rc
AP_FUNCTION_NOT_SUPPORTED
The local node is an end node or LEN node. This verb is valid only at a network node.
3.91.6 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.92 QUERY_AVAILABLE_TP
QUERY_AVAILABLE_TP returns information about active invokable TPs (APPC applications that have issued the
RECEIVE_ALLOCATE verb, or CPI-C applications that have issued the Accept_Conversation or Accept_Incoming
call). This verb can be used to obtain information about a specific TP or about multiple TPs, depending on the
options used. This verb returns information about all such TPs that are running, whether or not they currently have
an APPC verb or CPI-C call outstanding to accept a new incoming conversation.
This verb must be issued to a running node.
3.92.1 VCB Structure
typedef struct query_available_tp
{
AP_UINT16 opcode; /* Verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* Primary return code */
AP_UINT32 secondary_rc; /* Secondary return code */
unsigned char *buf_ptr; /* pointer to buffer */
AP_UINT32 buf_size; /* buffer size */
AP_UINT32 total_buf_size; /* total buffer size required */
AP_UINT16 num_entries; /* number of entries */
AP_UINT16 total_num_entries; /* total number of entries */
unsigned char list_options; /* listing options */
unsigned char reserv3[3]; /* reserved */
unsigned char tp_name[64]; /* TP name */
unsigned char system_name[128]; /* computer name where TP is */
/* running */
} QUERY_AVAILABLE_TP;
typedef struct available_tp_data
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char tp_name[64]; /* TP name */
unsigned char reserv4[4]; /* reserved */
unsigned char system_name[128]; /* computer name where TP is */
/* running */
} AVAILABLE_TP_DATA;
3.92.2 Supplied Parameters
The application supplies the following parameters:
349