CLEAR-APPL-CONTEXT( ) method

Clears the application context for the current session.

Return type: LOGICAL

Applies to: AUDIT-CONTROL system handle

Syntax

CLEAR-APPL-CONTEXT( )

After calling this method, the APPL-CONTEXT-ID attribute is cleared for all connected audit-enabled databases and is no longer recorded in audit event records for this application context.

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

• Call the CLEAR-APPL-CONTEXT( ) method, to clear the current application context, and then call the SET-APPL-CONTEXT( ) method with the new application context.
• Call the SET-APPL-CONTEXT( ) method with the new application context. If there is an existing application context in effect, the AVM clears the existing application context before setting the new application context.

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

APPL-CONTEXT-ID attribute, SET-APPL-CONTEXT( ) method