HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_LS_ROUTING
3.130 QUERY_LS_ROUTING
The QUERY_LS_ROUTING verb returns information for local LUs about the location of a partner LU using a
link station. If information is requested about more than one local LU, the information is returned based on the
Management Information Base (MIB) order of the local LU names, then on the MIB order of partner LU names
associated with each local LU name. Wildcard partner LU names can be interspersed with entries that do not
contain wildcards.
3.130.1 VCB Structure
typedef struct query_ls_routing
{
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; /* buffer pointer */
AP_UINT32 buf_size; /* buffer size */
AP_UINT32 total_buf_size; /* total buffer size */
AP_UINT16 num_entries; /* number of entries */
AP_UINT16 total_num_entries; /* total number of entries */
unsigned char list_options; /* list options */
unsigned char reserv3; /* reserved */
unsigned char lu_name[8]; /* LU Name */
unsigned char lu_alias[8]; /* reserved */
unsigned char fq_partner_lu[17]; /* partner lu name */
unsigned char wildcard_fqplu; /* wildcard partner LU flag */
unsigned char reserv4[2]; /* reserved */
} QUERY_LS_ROUTING;
typedef struct ls_routing_data
{
AP_UINT16 overlay_size;
unsigned char lu_name[8]; /* local LU name */
unsigned char lu_alias[8]; /* reserved */
unsigned char fq_partner_lu[17]; /* partner lu */
unsigned char wildcard_fqplu; /* wildcard partner LU flag */
unsigned char ls_name[8]; /* link to use */
unsigned char reserv3[2]; /* reserved */
} LS_ROUTING_DATA;
3.130.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_LS_ROUTING
num_entries
Maximum number of LS routing entries for which data should be returned. To request data for a specificLS
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
512