group delete

Deletes the specified Security Access Manager group. Optionally deletes the information of the group, from the user registry. ACL entries that are associated with the group are also deleted.

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

Syntax

group delete [–registry] group_name

Options

–registry: Deletes the entire group object from the user registry. (Optional)
group_name: Specifies the name of the Security Access Manager group to be deleted. The group must exist, or an error is displayed.
Examples of group names are Credit, Sales, and Test-group.

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 deletes the existing engineering group:
```
pdadmin sec_master> group delete engineering
```
The following example deletes the group object from the user registry and also deletes the existing Test-group group:
```
pdadmin sec_master> group delete -registry Test-group
```