Valid in: SQL, ESQL, OpenAPI, ODBC, JDBC, .NET

The DROP GROUP statement removes the specified group identifiers from the installation. 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.

The DROP GROUP statement has the following format:

In an embedded DROP GROUP statement, group_id cannot be specified using a host language variable.

You must have MAINTAIN_USERS privilege and be connected to the iidbdb database.

The DROP GROUP statement locks pages in the iiusergroup catalog of the iidbdb.