HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_CN_PORT
3.98 QUERY_CN_PORT
QUERY_CN_PORT returns information about ports defined on an adjacent Connection Network.
This verb can be used to obtain information about a specific port, or about multiple ports, depending on the options
used. It can be issued only at a network node or an end node; it is not valid at a LEN node.
3.98.1 VCB Structure
typedef struct query_cn_port
{
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 fqcn_name[17]; /* Name of Connection Network */
unsigned char port_name[8]; /* port name */
} QUERY_CN_PORT;
typedef struct cn_port_data
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char fqcn_name[17]; /* Name of Connection Network */
unsigned char port_name[8]; /* name of port */
unsigned char tg_num; /* transmission group number */
unsigned char reserva[20]; /* reserved */
} CN_PORT_DATA;
3.98.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_CN_PORT
buf_ptr
A pointer to a data buffer that SNAplus2 will use to return the requested information.
buf_size
Size of the supplied data buffer.
num_entries
Maximum number of ports for which data should be returned. To request data for a specific port rather than
a range, specify the value 1. To return as many entries as possible, specify zero; in this case, SNAplus2 will
return the maximum number of entries that can be accommodated in the supplied data buffer.
list_options
363