Oracle | DBMS_APP_CONT

Oracle DBMS_APP_CONT_ADMIN Version 21c

General Information

Library Note

Morgan's Library Page Header

ACE Director Alum Daniel Morgan, founder of Morgan's Library, is scheduling complimentary technical Workshops on Database Security for the first 30 Oracle Database customers located anywhere in North America, EMEA, LATAM, or APAC that send an email to asra_us@oracle.com. Request a Workshop for your organization today.

Purpose Administration support package for application continuity that allows an application to manage transaction monitoring and replay for select-only transactions.

All of its functionality with the exception of a single object was split out from DBMS_APP_CONT and the documentation was not update to reflect the change in location. This looks like more of the work of Oracle's Executive VP of Product Renaming.

AUTHID DEFINER

Constants

Name	Data Type	Value
Planned Maintenance test types
ENDREQUEST_TEST	BINARY_INTEGER	2
PING_TEST	BINARY_INTEGER	1
SQL_TEST	BINARY_INTEGER	0

Dependencies

ALL_SERVICES	DBMS_OUTPUT	DBMS_STANDARD
DBMS_APP_CONT_PMT_LIB	DBMS_SERVICE	DBMS_SYS_ERROR

Documented Yes: Packages and Types Reference

Exceptions

Error Code	Reason
ORA-65159	Invalid service name specified

First Available 19c

Security Model Owned by SYS with EXECUTE granted to the DBA role

Source {ORACLE_HOME}/rdbms/admin/dbmsappcont.sql

Subprograms

ACCHK_SET	DISABLE_LTXID_TABLE_LOCK	ENABLE_TAC
ADD_SQL_CONNECTION_TEST	ENABLE_AC	ENABLE_TAF
DELETE_SQL_CONNECTION_TEST	ENABLE_CONNECTION_TEST	ENABLE_TG
DISABLE_CONNECTION_TEST	ENABLE_LTXID_TABLE_LOCK	SET_DRAINING
DISABLE_FAILOVER	ENABLE_RESET_STATE	SET_LOAD_BALANCING_GOAL

ACCHK_SET (new 21c)

. dbms_app_cont_admin.acchk_set( enabled IN BOOLEAN, service_name IN VARCHAR2 DEFAULT NULL); PRAGMA SUPPLEMENTAL_LOG_DATA(ACCHK_SET, READ_ONLY);

exec dbms_app_cont_admin.acchk_set(TRUE);

      

      ACCHK is enabled

      

      PL/SQL procedure successfully completed.

ADD_SQL_CONNECTION_TEST

Adds a SQL connection test with or without a service name. These tests will be used by the server to drain sessions during planned maintenance. dbms_app_cont_admin.add_sql_connection_test( connection_test IN VARCHAR2, service_name IN VARCHAR2 DEFAULT '');

exec dbms_app_cont_admin.add_sql_connection_test('UWCNXTESTS', 'PDBDEV');

DELETE_SQL_CONNECTION_TEST

Removes a SQL connection test with or without a service name dbms_app_cont_admin.delete_sql_connection_test( connection_test IN VARCHAR2, service_name IN VARCHAR2 DEFAULT '');

exec dbms_app_cont_admin.delete_sql_connection_test(dbms_app_cont_admin.sql_test);

DISABLE_CONNECTION_TEST

Disable a connection test dbms_app_cont_admin.disable_connection_test( connection_test_type IN BINARY_INTEGER, connection_test IN VARCHAR2, service_name IN VARCHAR2);

exec dbms_app_cont_admin.disable_connection_test(dbms_app_cont_admin.endrequest_test);

DISABLE_FAILOVER

Disables failover features on the given service dbms_app_cont_admin.disable_failover(service_name IN VARCHAR2);

exec dbms_app_cont_admin.disable_failover('PDBDEVRPT');

DISABLE_LTXID_TABLE_LOCK (new 21c)

Disables table lock on ltxid_trans table dbms_app_cont_admin.

exec dbms_app_cont_admin.disable_ltxid_table_lock;

ENABLE_AC

Enables Application Continuity (AC) for the named service dbms_app_cont_admin.enable_ac( service_name IN VARCHAR2, failover_restore IN VARCHAR2 DEFAULT 'LEVEL1');

exec dbms_app_cont_admin.enable_ac('PDBDEVRPT', 'LEVEL1');

ENABLE_CONNECTION_TEST

Enables a connection test dbms_app_cont_admin.enable_connection_test( connection_test_type IN BINARY_INTEGER, connection_test IN VARCHAR2, service_name IN VARCHAR2);

exec dbms_app_cont_admin.enable_connection_test(dbms_app_cont_admin.ping_test, 'UWCNXTEST', 'PDBDEVRPT');

ENABLE_LTXID_TABLE_LOCK (new 21c)

Enables table lock on ltxid_trans table dbms_app_cont_admin.enable_ltxid_table_lock;

exec dbms_app_cont_admin.enable_ltxid_table_lock;

ENABLE_RESET_STATE (new 21c)

Enables reset_state for the named service. To use this interface the service must have FAILOVER_TYPE TRANSACTION or AUTO dbms_app_cont_admin.enable_reset_state( service_name IN VARCHAR2, level IN VARCHAR2 DEFAULT 'NONE');

exec dbms_app_cont_admin.enable_reset_state('PDBDEVRPT');

ENABLE_TAC

Enables Transparent Application Continuity (TAC) for the named service dbms_app_cont_admin.enable_tac( service_name IN VARCHAR2, failover_restore IN VARCHAR2);

exec dbms_app_cont_admin.enable_tac('PDBDEVRPT', 'AUTO');

ENABLE_TAF

Enables Transparent Application Failover for the named service dbms_app_cont_admin.enable_taf( service_name IN VARCHAR2, failover_type IN VARCHAR2, failover_restore IN VARCHAR2);

exec dbms_app_cont_admin.enable_taf('PDBDEVRPT', 'SESSION');

ENABLE_TG

enables Transaction Guard (TG) on the given service dbms_app_cont_admin.enable_tg(service_name IN VARCHAR2);

exec dbms_app_cont_admin.enable_tg('PDBDEVRPT');

SET_DRAINING (new 21c)

Sets the session drain timeout and stop_option for the given service dbms_app_cont_admin.set_draining( service_name IN VARCHAR2, drain_timeout IN BINARY_INTEGER DEFAULT NULL, stop_option IN VARCHAR2 DEFAULT NULL);

exec dbms_app_cont_admin.set_draining('PDBDEVRPT');

SET_LOAD_BALANCING_GOAL

Sets Runtime Load Balancing (RLB) goal for the given service dbms_app_cont.set_load_balancing_goal( service_name IN VARCHAR2, goal IN VARCHAR2 DEFAULT 'NONE');

exec dbms_app_cont_admin.set_load_balancing_goal('PDBDEVRPT', 'CLB_GOAL_SHORT');