rsrcgroup modify

Adds or removes a single sign-on resource to or from a single sign-on resource group.

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

Syntax

rsrcgroup modify resource_group_name add rsrcname resource_name

rsrcgroup modify resource_group_name remove rsrcname resource_name

Options

add rsrcname resource_name

Adds a single sign-on resource to the specified single sign-on resource group.

A valid resource name is an alphanumeric string that is not case-sensitive. If the resource is a GSO resource, certain characters are not allowed. See Characters disallowed for GSO names for the list of these characters.

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

remove rsrcname resource_name

Removes a single sign-on resource from the specified single sign-on resource group.

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

Note: Depending on the LDAP server in your environment, any attempt to remove a non-existing resource from a group, might generate an error.

resource_group_name

Specifies the name of the resource group to be modified. The resource group must exist, or an error is displayed.

Examples of resource group names are webs4807, engwebs01, and IBMprinters.

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 Access Manager error messages by decimal or hexadecimal codes.

Examples

The following example adds the resource named engwebs02 to the existing web resource group webs4807:
```
pdadmin sec_master> rsrcgroup modify webs4807 add rsrcname engwebs02
```
The following example deletes the resource named engwebs02 from the existing web resource group webs4807:
```
pdadmin sec_master> rsrcgroup modify webs4807 remove rsrcname engwebs02
```