HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_NN_TOPOLOGY_TG
unsigned char intersubnet_tg; /* TG between subnets */
unsigned char cp_cp_session_active; /* Are CP-CP sessions active? */
unsigned char branch_tg; /* TG branch aware? */
unsigned char multilink_tg; /* reserved */
unsigned char appended_data_format; /* format of appended data */
unsigned char appended_data_len; /* length of appended data */
unsigned char reserva[9]; /* reserved */
} TOPOLOGY_TG_DETAIL;
typedef struct link_address
{
unsigned char format; /* type of link address */
unsigned char reserve1; /* reserved */
AP_UINT16 length; /* length */
unsigned char address[32]; /* address */
} LINK_ADDRESS;
For details of the
TG_DEFINED_CHARS structure, see Section 3.29, DEFINE_LS.
If the frsn field is set to a non-zero value then only node entries with that FRSN or greater will be returned. If it
is set to zero then all node entries are returned.
If the list_options parameter specifies detailed information, a TG Descriptor CV may be appended to the
returned information. See the descriptions of the parameters topology_tg_detail.appended_data_format and
topology_tg_detail.appended_data_len for more information.
3.143.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_NN_TOPOLOGY_TG
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 TGs for which data should be returned. To request data for a specific TG 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
The position in the list from which SNAplus2 should begin to return data, and the level of information required
for each entry. Specify the level of information with one of the following values:
AP_SUMMARY
Summary information only.
AP_DETAIL
Detailed information.
Combine this value using a logical OR operation with one of the following values:
AP_FIRST_IN_LIST
570