rm_appcontext

Description

Removes a specific application context, or all application contexts. rm_appcontext is a function provided by the Application Context Facility (ACF). For more information about ACF, see "Row Level Access Control," in the System Administration Guide.

Syntax

rm_appcontext (“context_name”, “attribute_name”)

Parameters

context_name

is a row specifying an application context name. It is saved as datatype char(30).

attribute_name

is a row specifying an application context attribute name. It is saved as datatype char(30).

Examples

Example 1

These examples show how to remove an application context by specifying some or all attributes.

select rm_appcontext("CONTEXT1", "*")

----------
0

select rm_appcontext("*", "*")

----------
0

select rm_appcontext("NON_EXISTING_CTX","ATTR")

---------
-1

Example 2

This example shows the result when a user without appropriate permissions attempts to remove an application context.

select rm_appcontext("CONTEXT1","ATTR2")

----------

-1

Usage

Standards

SQL92 – Compliance level: Transact-SQL extension.

Permissions

Permissions depend on the user profile and the application profile, which are stored by ACF.

See also

Functions get_appcontext, set_appcontext, list_appcontext