rsrccred modify

Changes a single sign-on credential.

Requires authentication (administrator ID and password) to use this command.

Syntax

rsrccred modify resource_name rsrctype {web|group} set [–rsrcuser new_resource_userid [–rsrcpwd new_resource_password]] user user_name

Options

–rsrcpwd new_resource_password

Specifies the new password for a user at the web server. To change or reset the password information, this optional command must be preceded by a dash (-). Specifying this option without specifying the –rsrcpwd option clears both the resource user ID and the resource password from the resource credential. To set the resource password, you must specify both the resource user ID and the resource password. (Optional)

–rsrcuser new_resource_userid

Specifies the new unique user identification (user ID) for the user at the web server. To change or reset the resource user ID of the user, this optional command must be preceded by a dash (-). (Optional)

A valid new resource user ID is an alphanumeric string that is not case-sensitive. String values are expected to be characters that are part of the local code set. Spaces are not allowed.

Examples of user identifications are 4807ws01 and userD4D.

resource_name

Specifies the name that is given to the resource or resource group when the resource was created. The resource or resource group must exist, or an error is displayed.

Examples of resource names are engwebs01 and "Mary Jones Printer".

rsrctype {web|group}

Specifies whether the resource type named is web (resource) or group (resource group) for the single sign-on resource that is associated with the credential. The type of resource must match the resource type that is assigned when the resource or resource group credential was first created.

user user_name

Specifies the name of the user for whom the resource credential information applies. The user must exist, or an error is displayed.

Examples of user names are dlucas, sec_master, and "Mary Jones".

Return codes

0: The command completed successfully.
1: The command failed. When a command fails, the pdadmin command provides a description of the error and an error status code in hexadecimal format (for example, 0x14c012f2). See "Error messages" in the IBM Knowledge Center. This reference provides a list of the Security Verify Access error messages by decimal or hexadecimal codes.

Examples

The following example modifies the password of the user dlucas to newrsrpw for the specified resource engwebs01:

pdadmin sec_master> rsrccred modify engwebs01 rsrctype web set
-rsrcuser 4807ws01 -rsrcpwd newrsrpw user dlucas

The following example, entered as one line, modifies the group resource user ID to user888 for the specified resource printerusers:
```
pdadmin sec_master> rsrccred modify printerusers rsrctype group set 
-rsrcuser user888 user "Mary Jones"
```