Entering content frame

ALTER USERGROUP Statement (alter_usergroup_statement) 

The ALTER USERGROUP statement (alter_usergroup_statement) alters the properties assigned to a user group.

Syntax

<alter_usergroup_statement> ::= ALTER USERGROUP <usergroup_name> [<usergroup_mode>]
[TIMEOUT <unsigned_integer> | TIMEOUT NULL]
[COSTWARNING <unsigned_integer> | COSTWARNING NULL] [COSTLIMIT <unsigned_integer> | COSTLIMIT NULL]
[DEFAULT ROLE ALL [EXCEPT <role_name>] | DEFAULT ROLE NONE
| DEFAULT ROLE <role_name> [IDENTIFIED BY <password>]]
[[NOT] EXCLUSIVE] [DEFAULTCODE <ASCII | UNICODE>]

usergroup_name, usergroup_mode, unsigned_integer, role_name, password

Explanation

At least one of the optional clauses must be specified.

The specified user group must identify a defined user group.

The current user must have owner authorization over the user group whose properties are to be altered.

The members of the specified user group must not be logged onto the database system when the ALTER USERGROUP statement is executed.

Database user class of the user group (usergroup mode)

·        RESOURCE: specifies that the user group is to be assigned to the database user class RESOURCE.

·        STANDARD: specifies that the user group is removed from the current user class and loses the right to create base tables. All the base tables created by the user group are dropped.

·        No user class: if no user class is specified, the user class remains unchanged.

NULL

If the NULL value is specified, the value defined previously is cancelled.

DEFAULT ROLE

DEFAULT ROLE defines which of the roles assigned to the user group is activated automatically when a session is opened by a group member.

·        ALL: all the roles assigned to the user group are activated when a session is opened. EXCEPT can be used to exclude specified roles from activation.

·        NONE: none of the roles is activated when a session is opened by a member of the user group.

·        Role name specified: the roles specified here must exist and be assigned to the user group. They are automatically activated when a session of a group member is opened.

See also:

Role concept

For a description of TIMEOUT, COSTWARNING, COSTLIMIT, [NOT] EXCLUSIVE, and DEFAULTCODE, see CREATE USERGROUP statement.

 

Leaving content frame