DEFINE_LU_LU_PASSWORD

DEFINE_LU_LU_PASSWORD provides a password that is used for session-level verification between a local LU and a partner LU.

VCB Structure

typedef struct define_lu_lu_password
{
   unsigned short  opcode;           /* verb operation code        */
   unsigned char   reserv2;          /* reserved                   */
   unsigned char   format;           /* format                     */
   unsigned short  primary_rc;       /* primary return code        */
   unsigned long   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
                                     /* LULU verification protocol */
   unsigned char   description[RD_LEN];
                                     /* resource description       */
   unsigned char   reserv3[8];       /* reserved                   */
   unsigned char   password[8];      /* password                   */
} DEFINE_LU_LU_PASSWORD;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_DEFINE_LU_LU_PASSWORD
format
Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
lu_name
LU name of the local LU. This name is an 8-byte type-A EBCDIC character string. If this field is set to all zeros, the lu_alias field will be used for determining the local LU.
lu_alias
Local LU alias. This is an 8-byte string in a locally displayable character set. This field is only significant if the lu_name field is set to all zeros, in which case all 8 bytes are significant and must be set. If both the lu_alias and the lu_name are set to all zeros, the verb is forwarded to the LU associated with the control point (the default LU).
fqplu_name
Fully qualified partner LU name. This name is 17 bytes long and is right-padded with EBCDIC spaces. It is composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot. (Each name can have a maximum length of 8 bytes with no embedded spaces.)
verification_protocol
LU-LU verification protocol for use with this partner LU:
AP_BASIC_PROTOCOL
Only the basic protocol will be used with this partner LU.
AP_ENHANCED_PROTOCOL
Only the enhanced protocol will be used with this partner LU.
AP_EITHER_PROTOCOL
Either the basic or the enhanced protocol can be used with this partner LU, subject to the following details:
  • The default setting of this field is AP_EITHER_PROTOCOL.
  • The value AP_EITHER_PROTOCOL is provided to ease migration to the use of the enhanced protocol. The local LU accepts the basic protocol until the partner LU once agrees to run the enhanced protocol. From then on, the basic protocol is not accepted unless a subsequent DEFINE_LU_LU_PASSWORD is issued to allow it.
description
Resource description.
password
Password. This is an 8-byte hexadecimal string. Note that the least significant bit of each byte in the password is not used in session-level verification.

Returned Parameters

If the verb executes successfully, the Program returns the following parameter:
primary_rc
AP_OK
If the verb does not execute because of a parameter error, the Program returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
AP_INVALID_PLU_NAME

AP_INVALID_LU_NAME
AP_INVALID_LU_ALIAS

If the verb does not execute because the node has not yet been started, the Program returns the following parameter:
primary_rc
AP_NODE_NOT_STARTED
If the verb does not execute because the node is stopping, the Program returns the following parameter:
primary_rc
AP_NODE_STOPPING
If the verb does not execute because of a system error, the Program returns the following parameter:
primary_rc
AP_UNEXPECTED_SYSTEM_ERROR