HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_LS
If you are using central logging, the choice of succinct or full logging for messages from all computers is
determined by the setting of this parameter on the server acting as the central logger; this setting may either
be from the SET_GLOBAL_LOG_TYPE verb, or from a SET_LOG_TYPE verb issued to that server to
override the default.
succinct_errors
This parameter indicates whether succinct logging or full logging is used in the error log file; this applies
to both exception logs and problem logs. The possible values and their meanings are the same as for the
succinct_audits parameter.
3.128.4 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.129 QUERY_LS
QUERY_LS returns a list of information about the link stations defined at the node. This information is structured
as “determined data” (data gathered dynamically during execution, returned only if the node is active) and “defined
data” (data supplied on DEFINE_LS).
This verb can be used to obtain either summary or detailed information, about a specific LS or about multiple LSs,
depending on the options used.
3.129.1 VCB Structure
typedef struct query_ls
{
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 ls_name[8]; /* name of link station */
unsigned char port_name[8]; /* port used by link station */
} QUERY_LS;
typedef struct ls_summary
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char ls_name[8]; /* link station name */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char dlc_type; /* DLC type */
unsigned char state; /* link station state */
AP_UINT16 act_sess_count; /* currently active sessions */
/* count */
489