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.
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. We can specify an empty string ("") to clear an existing description. For example, we can specify "Credit, Dept HCUS" as the description.
- group_name
- 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 ISAM 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"
See also
group create
group importParent topic: pdadmin commands