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