HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_DSPU_TEMPLATE
3.118.5 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_support
and dlur_support parameters on the DEFINE_NODE verb.
3.118.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.119 QUERY_DSPU_TEMPLATE
The QUERY_DSPU_TEMPLATE verb returns information about defined downstream PU templates used for PU
concentration over implicit links.
This verb can be used to obtain information about a specific downstream PU template, or about a number of
downstream PU templates, depending on the options used. To obtain information about a specific downstream PU
template or multiple downstream PU templates, set the template_name parameter. The template_name parameter is
ignored if the list_options parameter is set to
AP_FIRST_IN_LIST.
3.119.1 VCB Structure
typedef struct query_dspu_template
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv1; /* 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 template_name[8]; /* name of DSPU template */
} QUERY_DSPU_TEMPLATE;
typedef struct dspu_template_data
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char template_name[8]; /* name of DSPU template */
unsigned char description[32]; /* resource description */
unsigned char reserv2[16]; /* reserved */
unsigned char reserv1[12]; /* reserved */
AP_UINT16 max_instance; /* max active template instance */
AP_UINT16 active_instance; /* current active instances */
unsigned char num_of_dslu_templates; /* number of DSLU templates */
446