HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_LU_LU_PASSWORD
3.33.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.34 DEFINE_LU_LU_PASSWORD
DEFINE_LU_LU_PASSWORD provides a password which is used for session-level security verification between
a local LU and a partner LU.
3.34.1 VCB Structure
typedef struct define_lu_lu_password
{
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 lu_name[8]; /* local LU name */
unsigned char lu_alias[8]; /* local LU alias */
unsigned char fqplu_name[17]; /* fully qualified partner */
/* LU name */
unsigned char verification_protocol; /* verification protocol */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char reserv3[8]; /* reserved */
unsigned char password[8]; /* password */
} DEFINE_LU_LU_PASSWORD;
3.34.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_LU_LU_PASSWORD
lu_name
LU name of the local LU, as defined to SNAplus2. This is an 8-byte type-A EBCDIC string, padded on the
right with spaces if the name is shorter than 8 bytes. To indicate that the LU is defined by its LU alias instead
of its LU name, set this parameter to 8 binary zeros.
lu_alias
LU alias of the local LU, as defined to SNAplus2. This is an 8-byte ASCII string, using any locally displayable
characters, padded on the right with spaces if the name is shorter than 8 bytes. It is used only if lu_name is
set to zeros.
To indicate the LU associated with the CP (the default LU), set both lu_name and lu_alias to 8 binary zeros.
fqplu_name
Fully qualified LU name for the partner LU, as defined to SNAplus2. The name is a 17-byte EBCDIC string,
right-padded with EBCDIC spaces. It consists of a network ID of up to 8 A-string characters, an EBCDIC
dot (period) character, and a network name of up to 8 A-string characters.
207