HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_DLUS
primary_rc
AP_FUNCTION_NOT_SUPPORTED
The local node does not support DLUR; this is defined by the dlur_support parameter on the
DEFINE_NODE verb.
3.114.6 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.115 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 DE-
FINE_INTERNAL_PU or DEFINE_DLUR_DEFAULTS; if it is issued to a running node, it also returns infor-
mation 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.
3.115.1 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 */
PIPE_STATS pipe_stats; /* pipe statistics */
unsigned char persistent_pipe_support; /* reserved */
427