rsrcgroup create

Creates and names a resource group.

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

Syntax

rsrcgroup create resource_group_name [–desc description]

Description

You can use a resource group to represent a set of web servers when the sign-on credential for the set of web servers is the same. In this case, web servers are considered resources.

For example, if the user dlucas has the same identity for web servers engwebs01 and engwebs02, these resources can be added to a resource group called webs4807. Use the rsrcgroup modify command to add the resources to the group.

Then, you can create a single sign-on credential for the webs4807 resource group for dlucas. Then, that single sign-on credential can be used to access all the web servers in the webs4807 group.

Options

–desc description: Specifies the description to identify this resource group. This parameter is optional. A valid description is an alphanumeric string that is not case-sensitive. String values are expected to be characters that are part of the local code set. If the description contains a space, ensure that you enclose the description in double quotation marks. (Optional)
Examples of descriptions are "Engineering Web server – Room 4807" and "Printer in room 345, Bldg 2".
resource_group_name: Specifies the name of the resource group. A valid resource group 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 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 creates and names a web resource group IBMprinters:
```
pdadmin sec_master> rsrcgroup create IBMprinters 
```
The following example creates and names a web resource group named webs4807 and provides a description ("Web servers, Room 4807") for that resource:
```
pdadmin sec_master> rsrcgroup create webs4807 –desc "Web servers, Room 4807"
```