DELETE_USERID_PASSWORD
DELETE_USERID_PASSWORD deletes a password associated with a user ID.
VCB Structure
typedef struct delete_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 delete_type; /* type of delete */
unsigned char user_id[10]; /* user id */
USERID_PASSWORD_CHARS password_chars;
/* password characteristics */
} DELETE_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_DELETE_USERID_PASSWORD
- format
- Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
- delete_type
- Specifies the type of delete:
- AP_REMOVE_USER
- Deletes the user password, and all associated profiles.
- AP_REMOVE_PROFILES
- Deletes the specified profiles.
- user_id
- User identifier. This is a 10-byte type-AE EBCDIC character string, padded to the right with EBCDIC spaces.
- password_chars.description
- This field is ignored when processing this verb.
- password_chars.profile_count
- Number of profiles.
- password_chars.password
- This field is ignored when processing this verb.
- 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
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