HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_DOWNSTREAM_LU_RANGE
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_STATE_CHECK
, which
are common to all NOF verbs.
3.22.6 Returned Parameters: Function Not Supported
If the verb does not execute successfully because the local node’s configuration does not support it, SNAplus2
returns the following parameters:
primary_rc
AP_FUNCTION_NOT_SUPPORTED
The local node does not support PU concentration; this is defined by the pu_conc_support parameter
on the DEFINE_NODE verb.
3.22.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.23 DEFINE_DOWNSTREAM_LU_RANGE
DEFINE_DOWNSTREAM_LU_RANGE defines a new range of downstream LUs, and maps them to an upstream
host LU or LU pool (defined using DEFINE_LU_0_TO_3 or DEFINE_LU_POOL). This allows the downstream
LUs to access the host computer using the PU concentration feature of SNAplus2. This verb cannot be used to
modify existing downstream LUs.
The supplied parameters to this verb include a base name for the new LUs and the range of NAU addresses. The
new LU names are generated by combining the base name with the NAU addresses. For example, a base name of
LUNME combined with a NAU range of 11 to 14 would define the LUs LUNME011, LUNME012, LUNME013
and LUNME014.
DEFINE_DOWNSTREAM_LU_RANGE can also be used to define downstream LUs used by applications that
communicate with a SNAplus2 Primary RUI application. For more information about Primary RUI, see HP-UX
SNAplus2 LUA Programmer’s Guide.
3.23.1 VCB Structure
typedef struct define_downstream_lu_range
{
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 dslu_base_name[5]; /* Downstream LU base name */
unsigned char reserv3; /* reserved */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char min_nau; /* Minimum NAU address in range */
unsigned char max_nau; /* Maximum NAU address in range */
unsigned char dspu_name[8]; /* Downstream PU name */
unsigned char host_lu_name[8]; /* Host LU or Pool name */
unsigned char allow_timeout; /* Allow timeout of host LU? */
143