DEFINE_USERID_PASSWORD

DEFINE_USERID_PASSWORD defines a password associated with a user ID.

VCB Structure

define_userid_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 short  define_type;         /* what the define type is    */
   unsigned char   user_id[10];         /* user id                    */
   unsigned char   reserv3[8];          /* reserved                   */
   USERID_PASSWORD_CHARS password_chars;
                                        /* password characteristics   */
} DEFINE_USERID_PASSWORD;
typedef struct userid_password_chars
{
   unsigned char   description[RD_LEN];
                                        /* resource description       */
   unsigned short  profile_count;       /* number of profiles         */
   unsigned short  reserv1;             /* reserved                   */
   unsigned char   password[10];        /* password                   */
   unsigned char   profiles[10][10];    /* profiles                   */
} USERID_PASSWORD_CHARS;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_DEFINE_USERID_PASSWORD
format
Identifies the format of the VCB. This field is set to zero to specify the version of the VCB listed above.
define_type
Specifies the type of user password being defined:
AP_ADD_USER
Specifies a new user, or change of password for an existing user.
AP_ADD_PROFILES
Specifies an addition to the profiles for an existing user.
user_id
User identifier. This is a 10-byte type-AE EBCDIC character string, padded to the right with EBCDIC spaces.
password_chars.description
Resource description. This is a 16-byte string in a locally displayable character set. All 16 bytes are significant.
password_chars.profile_count
Number of profiles.
password_chars.password
User's password. This is a 10-byte type-AE EBCDIC character string, padded to the right with EBCDIC spaces.
password_chars.profiles
Profiles associated with user. Each of these is a 10-byte type-AE EBCDIC character string, padded to the right with EBCDIC spaces.

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_NO_PROFILES

AP_UNKNOWN_USER
AP_INVALID_UPDATE_TYPE
AP_TOO_MANY_PROFILES
AP_INVALID_USERID
AP_INVALID_PROFILE
AP_INVALID_PASSWORD

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