group modify

Changes an existing group by adding or changing a group description, adding members to the group, or removing members from the group.

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

Syntax

group modify group_name add user

group modify group_name add (user_1 user_2 [... user_n])

group modify group_name description description

group modify group_name remove user

group modify group_name remove (user_1 user_2 [... user_n])

Options

add user or add (user_1 user_2 [... user_n])

Adds a user or a list of users to the group. For a single user, do not include the user name in parentheses. For multiple users, the format of the user list is a parenthesized list of user names, which are separated by spaces.

The following list shows examples of user names:

dlucas
"Bob Smith"
(dlucas "Mary Jones" mlucaser)

description description

Changes the description for the specified group. 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. Spaces are allowed. If the description contains a space, ensure that you enclose the description in double quotation marks. You can specify an empty string ("") to clear an existing description. For example, you can specify "Credit, Dept HCUS" as the description.

group_name

Specifies the name of the group. The group must exist, or an error is displayed.

Examples of group names are Credit, Sales, and Test-group.

remove user or remove (user_1 user_2 [... user_n])

Removes a user or a list of users from the group. For a single user, do not include the user name in parentheses. For multiple users, the format of the user list is a parenthesized list of user names, which are separated by spaces. The following list shows examples of user names:

dlucas
"Bob Smith"
(dlucas "Mary Jones" mlucaser)

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 a user dlucas to the engineering group:
```
pdadmin sec_master> group modify engineering add dlucas
```

The following example adds three new users to the engineering group:

pdadmin sec_master> group modify engineering add ("Mary Jones" dsmith mlucaser)

The following example deletes three existing users from the engineering group:

pdadmin sec_master> group modify engineering remove ("Mary Jones"
dlucas mlucaser)

The following example changes the description of the credit group:

pdadmin sec_master> group modify credit description "Credit, Dept HCUS"