HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_DLUS
Chapter 4652
QUERY_DLUS
QUERY_DLUS returns information about DLUS nodes known to the
DLUR feature of SNAplus2. This verb returns pipe statistics (SSCP-PU
and SSCP-LU session statistics); the QUERY_ISR_SESSION verb may
be used to obtain PLU-SLU session statistics.
This verb can be used to obtain information about a specific DLUS, or
about multiple DLUSs, depending on the options used.
If this verb is issued to an inactive node, it returns information only on
DLUS nodes defined using DEFINE_INTERNAL_PU or
DEFINE_DLUR_DEFAULTS; if it is issued to a running node, it also
returns information about active DLUS nodes. It does not return
information about the backup DLUS that was defined using
DEFINE_DLUR_DEFAULTS, unless this DLUS is active.
VCB Structure
typedef struct query_dlus
{
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 dlus_name[17]; /* fully-qualified DLUS name */
} QUERY_DLUS;
typedef struct dlus_data
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char dlus_name[17]; /* fully qualified DLUS name */
unsigned char is_default; /* is the DLUS the default */
unsigned char is_backup_default; /* is DLUS the backup default */
unsigned char pipe_state; /* state of CPSVRMGR pipe */
AP_UINT16 num_active_pus; /* num of active PUs using pipe */