HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_DOWNSTREAM_PU
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_STATE_CHECK
, which
are common to all NOF verbs.
3.117.6 Returned Parameters: Function Not Supported
If the verb does not execute successfully because the local node configuration does not support it, SNAplus2 returns
the following parameters:
primary_rc
AP_FUNCTION_NOT_SUPPORTED
The local node does not support PU concentration or DLUR; this is defined by the pu_conc_supportand
dlur_support parameters on the DEFINE_NODE verb.
3.117.7 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.118 QUERY_DOWNSTREAM_PU
QUERY_DOWNSTREAM_PU returns information about downstream PUs that use PU concentration or DLUR or
both. This verb can be used to obtain information about a specific PU or about multiple PUs, depending on the
options used.
This verb must be issued to a running node.
3.118.1 VCB Structure
typedef struct query_downstream_pu
{
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 dspu_name[8]; /* Downstream PU name filter */
unsigned char dspu_services; /* services provided to PU */
} QUERY_DOWNSTREAM_PU;
typedef struct downstream_pu_data
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char dspu_name[8]; /* PU name */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char ls_name[8]; /* Link name */
441