HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_LU_POOL
3.34.5 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.35 DEFINE_LU_POOL
This verb is used to define an LU pool and assign LUs to it, or to assign additional LUs to an existing pool. The
LUs must be defined before adding them to the pool. You can also define a pool by specifying the pool name when
defining an LU; for more information, see Section 3.32, DEFINE_LU_0_TO_3.
This verb cannot be used to modify an existing pool by removing LUs from it; the DELETE_LU_POOL verb is
used to do this.
3.35.1 VCB Structure
typedef struct define_lu_pool
{
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 pool_name[8]; /* LU pool name */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char reserv3[4]; /* reserved */
AP_UINT16 num_lus; /* number of LUs to add */
unsigned char lu_names[10][8]; /* LU names */
} DEFINE_LU_POOL;
3.35.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_LU_POOL
pool_name
Name of the LU pool. This is an 8-byte type-A EBCDIC string, padded on the right with EBCDIC spaces if
the name is shorter than 8 bytes. If a pool of this name is not already defined, SNAplus2 creates it.
description
A null-terminated text string (0–31 characters followed by a null character) describing the pool. This string
is for information only; it is stored in the node’s configuration file and returned on the QUERY_LU_POOL
verb, but SNAplus2 does not make any other use of it.
num_lus
Number of LUs to be added to the pool. This can be zero to define the pool without adding any LUs, or
1–10. To create a pool containing more than 10 LUs, issue multiple DEFINE_LU_POOL verbs for the same
pool name.
lu_names
209