END-EVENT-GROUP( ) method

Indicates the end of a group of related events in the current session.

Return type: LOGICAL

Applies to: AUDIT-CONTROL system handle

Syntax

END-EVENT-GROUP( )

After calling this method, the EVENT-GROUP-ID attribute is cleared for all connected audit-enabled databases and is no longer recorded in audit event records for this event group.

There can be only one active event group per session at any one point in time. To set a different event group for the session, you can:

• Call the END-EVENT-GROUP( ) method, to end the current event group, and then call the BEGIN-EVENT-GROUP( ) method to begin the new event group.
• Call the BEGIN-EVENT-GROUP( ) method to begin the new event group. If there is an existing event group in effect, the AVM ends the existing event group before beginning the new event group.

Calling this method does not generate an audit event or an audit record.

If successful, this method returns TRUE. Otherwise, it returns FALSE.

See also

BEGIN-EVENT-GROUP( ) method, EVENT-GROUP-ID attribute