HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_LU_0_TO_3_RANGE
3.33 DEFINE_LU_0_TO_3_RANGE
The DEFINE_LU_0_TO_3_RANGE verb defines a range of LUs for use with 3270 emulation, RJE or LUA (LUs
of type 0, 1, 2, or 3), and optionally assigns the LUs to an LU pool. This verb cannot be used to modify existing
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.
3.33.1 VCB Structure
typedef struct define_lu_0_to_3_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 base_name[6]; /* Base name */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char min_nau; /* Minimum NAU address */
unsigned char max_nau; /* Maximum NAU address */
unsigned char pool_name[8]; /* LU Pool name */
unsigned char pu_name[8]; /* PU name */
unsigned char priority; /* LU priority */
unsigned char lu_model; /* LU model (type) */
unsigned char sscp_id[6]; /* SSCP ID */
AP_UINT16 timeout; /* Timeout */
unsigned char app_spec_def_data[16]; /* reserved */
unsigned char reserv3[7]; /* reserved */
unsigned char name_attributes; /* Extension type */
unsigned char base_number; /* First extension number */
unsigned char term_method; /* session termination type */
unsigned char reserv4[14]; /* reserved */
} DEFINE_LU_0_TO_3_RANGE;
3.33.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_LU_0_TO_3_RANGE
base_name
Base name for the names of the new LUs. This is a 6-byte type-A EBCDIC string (starting with a letter),
padded on the right with EBCDIC spaces if the base name is less than 6 characters.
• If the name_attributes parameter is set to AP_USE_HEX_IN_NAME, this name may be up to 6 characters
long. SNAplus2 generates the LU name for each LU by appending a 2-digit hexadecimal number to this
name (starting from a base number specified by the base_number parameter).
• Otherwise, this name may be up to 5 characters long. SNAplus2 generates the LU name for each LU by
appending a 3-digit decimal number to this name (taken from the NAU address or from a defined base
number, as specified by the name_attributes parameter).
203