B UCP Exception Error Codes

This appendix contains a list of useful oracle.ucp.UniversalConnectionPoolException error codes.
/*
 * Universal Connection Pool error code range is 45000 - 45499 in RDBMS.
 * An error number is an offset from the base error code 45000.
 *
 * The error numbers are organized first by package; and then within
 * each package, by main components.  These are indicated with the
 * use of particular sub strings within the error numbers' field names.
 *
 * When adding a new error number, if it needs to be mapped to a
 * specific pool exception subclass, define the error number to be
 * smaller than UCP_RANGED_MAPPING_BASE.  Otherwise, define it to be
 * larger than UCP_RANGED_MAPPING_BASE, so that it can be mapped to
 * a generic UniversalConnectionPoolException.
 */
public static final int UCP_ERROR_CODE_BASE = 45000;
public static final int UCP_MAX_ERRORS = 500;
 
public static final int UCP_SUCCESS = 0;
public static final int UCP_GENERIC_ERROR = 1;
 
// Error numbers that are mapped to specific pool exceptions
public static final int UCP_NO_AVAILABLE_CONNECTIONS = 2;
public static final int UCP_POOL_ALREADY_EXISTS = 3;
public static final int UCP_INVALID_RETRIEVAL_CREDENTIALS = 4;
public static final int UCP_CALLBACK_ALREADY_REGISTERED = 5;
public static final int UCP_INVALID_POOL_CONFIGURATION = 6;
 
/*
 * All error numbers >= this number will be mapped to a generic
 * UniversalConnectionPoolException.  Error numbers smaller than this
 * have specific mappings to a UniversalConnectionPoolException subclass.
 */
public static final int UCP_RANGED_MAPPING_BASE = 50;
 
// POOL (oracle.ucp.common) - use _COMMON_POOL_
 
// Error number 50 is available for use
public static final int UCP_COMMON_POOL_INACTIVE_TIMER_SCHEDULE = 51;
public static final int UCP_COMMON_POOL_ABANDONED_TIMER_SCHEDULE = 52;
public static final int UCP_COMMON_POOL_TTL_TIMER_SCHEDULE = 53;
public static final int UCP_COMMON_POOL_NULL = 54;
public static final int UCP_COMMON_POOL_RM_AVAIL_CONN = 55;
public static final int UCP_COMMON_POOL_NO_VALID_CONNECTION = 56;
public static final int UCP_COMMON_POOL_AVAILABLECONNECTIONS_NULL = 57;
public static final int UCP_COMMON_POOL_FAILOVERABLE_NULL = 58;
public static final int UCP_COMMON_POOL_NOCONNECTIONS = 59;
public static final int UCP_COMMON_POOL_INVALID_LIFECYCLE_STATE = 60;
public static final int UCP_COMMON_POOL_NOTSTARTED = 61;
public static final int UCP_COMMON_POOL_SETAVAILABLECONNECTIONS = 62;
public static final int UCP_COMMON_POOL_SHUTDOWN = 63;
public static final int UCP_COMMON_POOL_ALLCONNECTIONS_INUSE = 64;
public static final int UCP_COMMON_POOL_ABOUT_TO_SHUTDOWN = 65;
public static final int UCP_COMMON_POOL_INSUFFICIENT_INITIAL_CONNECTIONS = 66;
public static final int UCP_COMMON_POOL_UNABLE_TO_CREATE_CONNECTION = 67;
public static final int SQL_AC_INIT_CALLBACK_ERROR = 68;
// Error numbers 69 - 90 are available for use
public static final int UCP_COMMON_POOL_LABELING_CBK_REGISTERED = 91;
public static final int UCP_COMMON_POOL_NO_LABELING_CBK = 92;
public static final int UCP_COMMON_POOL_LABEL_BORROW_MISMATCH = 93;
// Error numbers 94 - 96 are available for use
public static final int UCP_COMMON_POOL_HARVEST_TIMER_SCHEDULE = 97;
 
// Connection factory adapter - use _COMMON_CFA_
public static final int UCP_COMMON_CFA_RETURNED_NULL = 100;
// Error numbers 101 - 102 are available for use
public static final int UCP_COMMON_CFA_INSTANCE_ERROR1 = 103;
public static final int UCP_COMMON_CFA_NULL = 104;
public static final int UCP_COMMON_CFA_INSTANCE_ERROR2 = 105;
public static final int UCP_COMMON_CFA_INSTANCE_ERROR3 = 106;
 
// Universal pooled connection - use _COMMON_UPC_
public static final int UCP_COMMON_UPC_NULL = 150;
public static final int UCP_COMMON_UPC_WRONG_SQL = 151;
public static final int UCP_COMMON_UPC_STATUS_NULL = 152;
public static final int UCP_COMMON_UPC_LABEL_KEY_EMPTY = 153;
public static final int UCP_COMMON_UPC_CLOSED = 154;
public static final int UCP_COMMON_UPC_HARVESTING_CBK_REGISTERED = 155;
public static final int UCP_COMMON_UPC_ABANDONED_CBK_REGISTERED = 156;
public static final int UCP_COMMON_UPC_TTL_CBK_REGISTERED = 157;
public static final int UCP_COMMON_UPC_BAD = 158;
 
// Connection retrieval info - use _CRI_
 
// Error number 200 is available for use
public static final int UCP_COMMON_CRI_LABEL_KEY_EMPTY = 201;
public static final int UCP_COMMON_CRI_NOLABEL_CLONE_FAILURE = 202;
public static final int UCP_COMMON_CRI_NULL = 203;
public static final int UCP_COMMON_SERVICE_MISMATCH = 204;
 
// JDBC POOL (oracle.ucp.jdbc) - use _JDBC_
 
// Error number 250 is available for use
public static final int UCP_JDBC_CONNECTIONPOOLDATASOURCE_NULL = 251;
public static final int UCP_JDBC_INVALID_CONNECTIONRETRIEVALINFO_OBJECT = 252;
public static final int UCP_JDBC_CONNECTIONPOOLDATASOURCE_SQLEXCEPTION = 253;
public static final int UCP_JDBC_INVALID_CONNECTIONTYPE = 254;
public static final int UCP_JDBC_CONNECTIONCLOSE_EXCEPTION = 255;
public static final int UCP_JDBC_DATASOURCE_NULL = 256;
public static final int UCP_JDBC_GETCONNECTION_EXCEPTION = 257;
public static final int UCP_JDBC_INVALID_PROXY_CONNECTIONTYPE = 258;
public static final int UCP_JDBC_PROXY_CONNECTION_EXCEPTION = 259;
public static final int UCP_JDBC_NOT_XADATASOURCE_NULL = 260;
public static final int UCP_JDBC_XADATASOURCE_SQLEXCEPTION = 261;
public static final int UCP_JDBC_INVALID_XACONNECTIONTYPE = 262;
public static final int UCP_JDBC_XACONNECTIONCLOSE_EXCEPTION = 263;
public static final int UCP_JDBC_CONNECTION_NULL = 264;
public static final int UCP_JDBC_PROXY_STATEMENT_EXCEPTION = 265;
public static final int UCP_JDBC_PROXY_RESULTSET_EXCEPTION = 266;
public static final int UCP_JDBC_PROXY_XACONNECTION_EXCEPTION = 267;
public static final int UCP_JDBC_DRIVER_NULL = 268;
public static final int UCP_JDBC_URL_NULL = 269;
public static final int UCP_JDBC_POOL_INIT_CBK_REGISTERED = 270;
public static final int UCP_JDBC_POOL_INIT_CBK_FAILURE = 271;
public static final int UCP_JDBC_INVALID_USE_OF_SHARED_POOL = 272;
public static final int UCP_JDBC_NON_SHARED_POOL_INVALID_CONFIG_EXCEPTION = 273;
public static final int UCP_JDBC_UNABLE_TO_SET_QUERY_TIMEOUT = 274;
public static final int UCP_JDBC_DUPLICATE_POOL_NAME = 275;
public static final int UCP_JDBC_DUPLICATE_DATASOURCE_NAME = 276;
public static final int UCP_JDBC_MISSING_SHARD_KEY_CONNECTION_REQUEST = 277;
public static final int UCP_JDBC_INVALID_CONNECTION_REQUEST_PARAMETER = 278;
public static final int UCP_JDBC_CANNOT_RECONFIGURE_MAX_PER_SERVICE = 279;
public static final int UCP_JDBC_INVALID_GLOBAL_SERVICE_NAME = 280;
 
// Oracle JDBC POOL (oracle.ucp.jdbc.oracle) - use _JDBC_ORACLE_
 
// Error number 300 is available for use
public static final int UCP_JDBC_ORACLE_FOVR_CONN_NULL = 301;
public static final int UCP_JDBC_ORACLE_FOVR_CONN_QUERY = 302;
public static final int UCP_JDBC_ORACLE_FOVR_CONN_SQLEXC = 303;
public static final int UCP_JDBC_ORACLE_EVENTTYPE_NULL = 304;
public static final int UCP_JDBC_ORACLE_INVALID_EVENTTYPE = 305;
public static final int UCP_JDBC_ORACLE_INVALID_FAILOVER_EVENTTYPE = 306;
public static final int UCP_JDBC_ORACLE_INVALID_AFFINITY_CXT = 307;
public static final int UCP_JDBC_ORACLE_REMOTE_ONS_PRIVILEGE = 308;
public static final int UCP_JDBC_ORACLE_BEGINREQUEST_FAILURE = 309;
public static final int UCP_JDBC_ORACLE_ENDREQUEST_FAILURE = 310;
public static final int UCP_JDBC_ORACLE_NO_AVAIL_CONN_FOR_STRICT_AFFINITY = 311;
public static final int UCP_JDBC_ORACLE_REMOTE_ONS_INIT = 312;
public static final int UCP_JDBC_ORACLE_AUTO_ONS_CONFIG = 313;
public static final int UCP_JDBC_ORACLE_INVALID_RAC_DATA_AFFINITY_CONFIG = 314;
 
// Admin (oracle.ucp.admin) - use _ADMIN_
public static final int UCP_ADMIN_MGR_POOL_ALREADY_EXISTS = 350;
public static final int UCP_ADMIN_MGR_POOL_DOESNOT_EXIST = 351;
public static final int UCP_ADMIN_MGR_CANNOT_GETINSTANCE = 352;
public static final int UCP_ADMIN_MGRMBEAN_CANNOT_GETINSTANCE = 353;
public static final int UCP_ADMIN_MBEAN_MALFORM_OBJECTNAME = 354;
public static final int UCP_ADMIN_MBEAN_REG_UNREG_EXCEPTION = 355;
public static final int UCP_ADMIN_MBEAN_INSTANCE_EXISTS = 356;
public static final int UCP_ADMIN_MBEAN_NOT_COMPLIANT = 357;
public static final int UCP_ADMIN_MBEAN_INSTANCE_NOTFOUND = 358;
public static final int UCP_ADMIN_MBEAN_INVALID_TARGET = 359;
public static final int UCP_ADMIN_MGRMBEAN_DESCRIPTOR_EXCEPTION = 360;
public static final int UCP_ADMIN_MGRMBEAN_MBEANINFO_EXCEPTION = 361;
public static final int UCP_ADMIN_MGRMBEAN_CONINFO_EXCEPTION = 362;
public static final int UCP_ADMIN_MGRMBEAN_ATTRINFO_EXCEPTION = 363;
public static final int UCP_ADMIN_MGRMBEAN_OPERINFO_EXCEPTION = 364;
public static final int UCP_ADMIN_JDBCPOOLMBEAN_INSTANCE = 365;
public static final int UCP_ADMIN_JDBCPOOLMBEAN_DESCRIPTOR_EXCEPTION = 366;
public static final int UCP_ADMIN_JDBCPOOLMBEAN_MBEANINFO_EXCEPTION = 367;
public static final int UCP_ADMIN_JDBCPOOLMBEAN_CONINFO_EXCEPTION = 368;
public static final int UCP_ADMIN_JDBCPOOLMBEAN_ATTRINFO_EXCEPTION = 369;
public static final int UCP_ADMIN_JDBCPOOLMBEAN_OPERINFO_EXCEPTION = 370;
public static final int UCP_ADMIN_COMMONPOOLMBEAN_ATTRINFO_EXCEPTION = 371;
public static final int UCP_ADMIN_COMMONPOOLMBEAN_OPERINFO_EXCEPTION = 372;
public static final int UCP_ADMIN_COMMONPOOLMBEAN_DESCRIPTOR_EXCEPTION = 373;
public static final int UCP_ADMIN_COMMONPOOLMBEAN_MBEANINFO_EXCEPTION = 374;
public static final int UCP_ADMIN_STOP_METRIC_COLLECTION = 375;
public static final int UCP_ADMIN_METRIC_UPDATE_TIMER = 376;
public static final int UCP_ADMIN_METRIC_UPDATE_SENSORS = 377;
public static final int UCP_ADMIN_JDBCPOOLMBEAN_ORACLEPOOL_NULL = 378;
public static final int UCP_ADMIN_COMMONPOOLMBEAN_CANNOT_SET_POOLNAME = 379;
public static final int UCP_ADMIN_MBEAN_NULL = 380;
public static final int UCP_ADMIN_MBEAN_OBJNAME_NULL = 381;
public static final int UCP_ADMIN_MBEAN_DISPLAYNAME_NULL = 382;
public static final int UCP_ADMIN_MGR_INVALID_ADAPTER = 383;
public static final int UCP_ADMIN_MGRMBEAN_INVALID_ADAPTER = 384;
public static final int UCP_ADMIN_MGR_POOL_CREATION = 385;
public static final int UCP_ADMIN_MGRMBEAN_POOL_CREATION = 386;
 
public static final int UCP_POOL_CONFIGURATION_INVALID_XML = 387;
public static final int UCP_POOL_RECONFIGURATION_INVALID_XML = 388;
public static final int UCP_POOL_MAX_PER_SHARD_LIMIT_EXCEEDED = 389;
 
 
// Utilities (oracle.ucp.util) - use _UTIL_ or _WTP_
 
// Utilities - Worker Thread Pool (WTP) - use _WTP_
 
// Error number 400 is available for use
public static final int UCP_WTP_MIN_WAITING_THREADS_NEGATIVE = 401;
public static final int UCP_WTP_MAX_WAITING_THREADS_NEGATIVE = 402;
public static final int UCP_WTP_MAX_TOTAL_THREADS_NEGATIVE = 403;
public static final int UCP_WTP_QUEUE_POLL_TIMEOUT_NEGATIVE = 404;
public static final int UCP_WTP_WAITING_THREADS_MIN_GT_MAX = 405;
public static final int UCP_WTP_TOTAL_THREADS_LT_WAITING = 406;
 
public static final int UCP_UTIL_ERROR_OUT_OF_RANGE = 407;
public static final int UCP_UTIL_NULL_LOGGER = 408;
 
// Error numbers for WLS JTA support
public static final int UCP_WLS_XA_AFFINITY_VIOLATION = 420;