HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_AVAILABLE_TP
Chapter 4 525
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.
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; /* reserved */
unsigned char tp_name[64]; /* TP name */
unsigned char system_name[64]; /* 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 system_name[64]; /* computer name where TP is */
/* running */
} AVAILABLE_TP_DATA;