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 (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');

Related Topics
AS_REPLAY
Built-in Functions
Built-in Packages
DBMS_APP_CONT
DBMS_APP_PRVT
DBMS_APP_CONT_REPORT
DBMS_WORKLOAD_CAPTURE
DBMS_WORKLOAD_REPLAY
DBMS_WRR_INTERNAL
What's New In 21c
What's New In 23c

Morgan's Library Page Footer
This site is maintained by Dan Morgan. Last Updated: This site is protected by copyright and trademark laws under U.S. and International law. © 1998-2023 Daniel A. Morgan All Rights Reserved
  DBSecWorx