Drop Group

Valid in: SQL, ESQL

The Drop Group statement removes the specified group identifiers from the installation. The drop group statement If any of the specified identifiers does not exist, the DBMS Server returns an error but does not abort the statement. Other valid existing group_ids in the statement are deleted.

A group identifier must be empty, that is, have no users in its user list, before it can be dropped. If an attempt is made to drop a group identifier that still has members in its user list, the DBMS Server returns an error and does not delete the identifier. However, the statement is not aborted. Other group identifiers in the list, if they are empty, are deleted. (Use the alter group statement to drop all the users from a group's user list.)

Any session using a group identifier when the identifier is dropped continues to run with the privileges defined for that group.

For more information about group identifiers, see the Database Administrator Guide.

Syntax

The Drop Group statement has the following format:

[EXEC SQL] DROP GROUP group_id {, group_id};

Embedded Usage

In an embedded Drop Group statement, group_id cannot be specified using a host language variable.

Permissions

You must have the maintain_users privilege and be working in a session connected with the iidbdb.

Locking

The Drop Group statement locks pages in the iiusergroup catalog of the iidbdb.

Related Statements

Alter Group

Create Group

Examples: Drop Group

The following are Drop Group statement examples:

1. Drop the group identifier, acct_clerk.

   drop group acct_clerk;

2. In an application, drop the group identifiers, tel_sales and temp_clerk.

   exec sql drop group tel_sales, temp_clerk;