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