HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_ADJACENT_NN
3.91 QUERY_ADJACENT_NN
The QUERY_ADJACENT_NN verb returns information about adjacent network nodes (the network nodes to which
CP-CP sessions are active or have been active at some time). It can be used only if the SNAplus2 node is a network
node, and is not valid if it is an end node or LEN node.
This verb can be used to obtain information about a specific adjacent network node, or about multiple adjacent
network nodes, depending on the options used.
This verb must be issued to a running node.
3.91.1 VCB Structure
typedef struct query_adjacent_nn
{
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 adj_nncp_name[17]; /* CP name of adjacent Network Node */
} QUERY_ADJACENT_NN;
typedef struct adj_nncp_data
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char adj_nncp_name[17]; /* CP name of adjacent network node */
unsigned char cp_cp_sess_status; /* CP-CP session status */
AP_UINT32 out_of_seq_tdus; /* out of sequence TDUs */
AP_UINT32 last_frsn_sent; /* last FRSN sent */
AP_UINT32 last_frsn_rcvd; /* last FRSN received */
unsigned char reserva[20]; /* reserved */
} ADJ_NNCP_DATA;
3.91.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_ADJACENT_NN
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
346