HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_LS
Chapter 4730
QUERY_LS
QUERY_LS returns a list of information about the link stations defined
at the node. This information is structured as “determined data” (data
gathered dynamically during execution, returned only if the node is
active) and “defined data” (data supplied on DEFINE_LS).
This verb can be used to obtain either summary or detailed information,
about a specific LS or about multiple LSs, depending on the options used.
VCB Structure
typedef struct query_ls
{
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 ls_name[8]; /* name of link station */
unsigned char port_name[8]; /* port used by link station */
} QUERY_LS;
typedef struct ls_summary
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char ls_name[8]; /* link station name */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char dlc_type; /* DLC type */
unsigned char state; /* link station state */
AP_UINT16 act_sess_count; /* currently active sessions */
/* count */
unsigned char det_adj_cp_name[17]; /* determined adjacent CP name */
unsigned char det_adj_cp_type; /* determined adjacent node type*/
unsigned char port_name[8]; /* port name */
unsigned char adj_cp_name[17]; /* adjacent CP name */