JDBCDataSourceRuntimeMBean


Overview  |   Related MBeans  |   Attributes  |   Operations

Overview

This class is used for monitoring a WebLogic JDBC Data Source and its associated connection pool.

           
Since9.0.0.0
Fully Qualified Interface NameIf you use the getMBeanInfo operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name:
weblogic.management.runtime.JDBCDataSourceRuntimeMBean
Factory Methods No factory methods. Instances of this MBean are created automatically.
Subtypes The following MBeans extend or implement this MBean type:


    Related MBeans

    This section describes attributes that provide access to other MBeans.


    JDBCDriverRuntime

    Gets the JDBCDriverRuntimeMBean associated with this data source.

           
    Privileges Read/Write
    TypeJDBCDriverRuntimeMBean
    Relationship type: Reference.
    Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

    LastTask

           
    Factory Methods No explicit creator method. The child shares the lifecycle of its parent.
    Privileges Read only
    TypeJDBCDataSourceTaskRuntimeMBean
    Relationship type: Containment.

    WorkManagerRuntimes

    Get the runtime mbeans for all work managers defined in this component

           
    Privileges Read only
    TypeWorkManagerRuntimeMBean[]
    Relationship type: Reference.


    Attributes

    This section describes the following attributes:


    ActiveConnectionsAverageCount

    Average number of active connections in this instance of the data source.

    Active connections are connections in use by an application. This value is only valid if the resource is configured to allow shrinking.

           
    Privileges Read only
    Typeint

    ActiveConnectionsCurrentCount

    The number of connections currently in use by applications.

           
    Privileges Read only
    Typeint

    ActiveConnectionsHighCount

    Highest number of active database connections in this instance of the data source since the data source was instantiated.

    Active connections are connections in use by an application.

           
    Privileges Read only
    Typeint

    CachingDisabled

    Private property that disables caching in proxies.

           
    Privileges Read only
    Typeboolean

    ConnectionDelayTime

    The average amount of time, in milliseconds, that it takes to create a physical connection to the database.

    The value is calculated as summary of all times to connect divided by the total number of connections.

           
    Privileges Read only
    Typeint

    ConnectionsTotalCount

    The cumulative total number of database connections created in this data source since the data source was deployed.

           
    Privileges Read only
    Typeint

    CurrCapacity

    The current count of JDBC connections in the connection pool in the data source.

           
    Privileges Read only
    Typeint

    CurrCapacityHighCount

    Highest number of database connections available or in use (current capacity) in this instance of the data source since the data source was deployed.

           
    Privileges Read only
    Typeint

    DatabaseProductName

    The product name of the database that this data source is connected to.

           
    Privileges Read only
    Typejava.lang.String

    DatabaseProductVersion

    The product version of the database that this data source is connected to.

           
    Privileges Read only
    Typejava.lang.String

    DeploymentState

    The current deployment state of the module.

    A module can be in one and only one of the following states. State can be changed via deployment or administrator console.

    - UNPREPARED. State indicating at this module is neither prepared or active.

    - PREPARED. State indicating at this module of this application is prepared, but not active. The classes have been loaded and the module has been validated.

    - ACTIVATED. State indicating at this module is currently active.

    - NEW. State indicating this module has just been created and is being initialized.

    For more information, see:

           
    Privileges Read only
    Typeint

    DriverName

    The product name of the JDBC driver that this data source is configured to use.

           
    Privileges Read only
    Typejava.lang.String

    DriverVersion

    The version of the JDBC driver that this data source is configured to use.

           
    Privileges Read only
    Typejava.lang.String

    Enabled

    Indicates whether the data source is enabled or disabled:

           
    Privileges Read only
    Typeboolean

    FailedReserveRequestCount

    The cumulative, running count of requests for a connection from this data source that could not be fulfilled.

           
    Privileges Read only
    Typelong

    FailuresToReconnectCount

    The number of times that the data source attempted to refresh a database connection and failed.

    Failures may occur when the database is unavailable or when the network connection to the database is interrupted.

           
    Privileges Read only
    Typeint

    HighestNumAvailable

    Highest number of database connections that were idle and available to be used by an application at any time in this instance of the data source since the data source was deployed.

           
    Privileges Read only
    Typeint

    HighestNumUnavailable

    Highest number of database connections that were in use by applications or being tested by the system in this instance of the data source since the data source was deployed.

           
    Privileges Read only
    Typeint

    LeakedConnectionCount

    The number of leaked connections. A leaked connection is a connection that was reserved from the data source but was not returned to the data source by calling close().

           
    Privileges Read only
    Typeint

    MBeanInfo

    Returns the MBean info for this MBean.

    Deprecated.

           
    Privileges Read only
    Typejavax.management.MBeanInfo

    ModuleId

    Returns the identifier for this Component. The identifier is unique within the application.

    Typical modules will use the URI for their id. Web Modules will return their context-root since the web-uri may not be unique within an EAR.

           
    Privileges Read only
    Typejava.lang.String

    Name

    The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration.

           
    Privileges Read only
    Typejava.lang.String

    NumAvailable

    The number of database connections that are currently idle and available to be used by applications in this instance of the data source.

           
    Privileges Read only
    Typeint

    NumUnavailable

    The number of connections currently in use by applications or being tested in this instance of the data source.

           
    Privileges Read only
    Typeint

    ObjectName

    Returns the ObjectName under which this MBean is registered in the MBean server.

    Deprecated.

           
    Privileges Read only
    Typeweblogic.management.WebLogicObjectName

    Parent

    Return the immediate parent for this MBean

           
    Privileges Read/Write
    Type

    PrepStmtCacheAccessCount

    The cumulative, running count of the number of times that the statement cache was accessed.

           
    Privileges Read only
    Typelong

    PrepStmtCacheAddCount

    The cumulative, running count of the number of statements added to the statement cache.

    Each connection in the connection pool has its own cache of statements. This number is the sum of the number of statements added to the caches for all connections in the connection pool.

           
    Privileges Read only
    Typelong

    PrepStmtCacheCurrentSize

    The number of prepared and callable statements currently cached in the statement cache.

    Each connection in the connection pool has its own cache of statements. This number is the sum of the number of statements in the caches for all connections in the connection pool.

           
    Privileges Read only
    Typeint

    PrepStmtCacheDeleteCount

    The cumulative, running count of statements discarded from the cache.

    Each connection in the connection pool has its own cache of statements. This number is the sum of the number of statements that were discarded from the caches for all connections in the connection pool.

           
    Privileges Read only
    Typelong

    PrepStmtCacheHitCount

    The cumulative, running count of the number of times that statements from the cache were used.

           
    Privileges Read only
    Typeint

    PrepStmtCacheMissCount

    The number of times that a statement request could not be satisfied with a statement from the cache.

           
    Privileges Read only
    Typeint

    Properties

    The list of properties for a data source that are passed to the JDBC driver when creating database connections.

    This is a privileged operation that can only be invoked by an authorized user.

           
    Privileges Read only
    Typejava.util.Properties

    Registered

    Returns false if the MBean represented by this object has been unregistered.

    Deprecated.

           
    Privileges Read only
    Typeboolean

    ReserveRequestCount

    The cumulative, running count of requests for a connection from this data source.

           
    Privileges Read only
    Typelong

    State

    The current state of the data source.

    Possible states are:

           
    Privileges Read only
    Typejava.lang.String

    Type

    Returns the type of the MBean.

           
    Privileges Read only
    Typejava.lang.String

    VersionJDBCDriver

    The driver class name of the JDBC driver used to create database connections.

           
    Privileges Read only
    Typejava.lang.String

    WaitingForConnectionCurrentCount

    The number of connection requests waiting for a database connection.

           
    Privileges Read only
    Typeint

    WaitingForConnectionFailureTotal

    The cumulative, running count of requests for a connection from this data source that had to wait before getting a connection and eventually failed to get a connection.

    Waiting connection requests can fail for a variety of reasons, including waiting for longer than the ConnectionReserveTimeoutSeconds.

    For more information, see:

           
    Privileges Read only
    Typelong

    WaitingForConnectionHighCount

    Highest number of application requests concurrently waiting for a connection from this instance of the data source.

           
    Privileges Read only
    Typeint

    WaitingForConnectionSuccessTotal

    The cumulative, running count of requests for a connection from this data source that had to wait before getting a connection and eventually succeeded in getting a connection.

           
    Privileges Read only
    Typelong

    WaitingForConnectionTotal

    The cumulative, running count of requests for a connection from this data source that had to wait before getting a connection, including those that eventually got a connection and those that did not get a connection.

           
    Privileges Read only
    Typelong

    WaitSecondsHighCount

    The highest number of seconds that an application waited for a connection (the longest connection reserve wait time) from this instance of the connection pool since the connection pool was instantiated.

    This value is updated when a completed getConnection request takes longer to return a connection than any previous request.

           
    Privileges Read only
    Typeint


    Operations

    This section describes the following operations:


    clearStatementCache

    For each connection in the connection pool, clears the statement cache of Prepared and Callable Statements.

       
    Operation Name"clearStatementCache"
    Parametersnull
    Signaturenull
    Returns void
    Exceptions
    • java.lang.Exception

    dumpPool

    Prints out information about all the connections in the connection pool in the data source.

       
    Operation Name"dumpPool"
    Parametersnull
    Signaturenull
    Returns void
    Exceptions
    • java.lang.Exception

    dumpPoolProfile

    Prints out profile information about the data source.

       
    Operation Name"dumpPoolProfile"
    Parametersnull
    Signaturenull
    Returns void
    Exceptions
    • java.lang.Exception

    forceShutdown

    Shuts down a data source that has a health state of Running, including forcing the disconnection of all current connection users.

    If successful, the health state is set to Shutdown.

    This is a privileged operation that can only be invoked by an authorized user.

       
    Operation Name"forceShutdown"
    Parametersnull
    Signaturenull
    Returns void
    Exceptions
    • java.lang.Exception

    forceSuspend

    Suspends a data source that has the health state of Running, including disconnecting all current connection users. All current connections are closed and recreated.

    If successful, the health state is set to Suspended.

    This is a privileged operation that can only be invoked by an authorized user.

       
    Operation Name"forceSuspend"
    Parametersnull
    Signaturenull
    Returns void
    Exceptions
    • java.lang.Exception

    poolExists

    Specifies whether a data source with the given name exists.

    This is a privileged operation that can only be invoked by an authorized user.

       
    Operation Name"poolExists"
    ParametersObject [] {  name }

    where:

    • name is an object of type java.lang.String that specifies:

      Name of the pool being looked for

    SignatureString [] { "java.lang.String" }
    Returns boolean
    Exceptions
    • java.lang.Exception

    preDeregister

       
    Operation Name"preDeregister"
    Parametersnull
    Signaturenull
    Returns void
    Exceptions
    • java.lang.Exception

    reset

    Resets the connection pool in the data source by shutting down and recreating all available database connections in the pool.

    Use when a data source is in the health state of Unhealthy and needs to be reinitialized.

    This is a privileged operation that can only be invoked by an authorized user.

       
    Operation Name"reset"
    Parametersnull
    Signaturenull
    Returns void
    Exceptions
    • java.lang.Exception

    resume

    Restores all access to and operations on a data source that has a health state of Suspended.

    If successful, the health state is set to Running.

    This is a privileged operation that can only be invoked by an authorized user.

       
    Operation Name"resume"
    Parametersnull
    Signaturenull
    Returns void
    Exceptions
    • java.lang.Exception

    shrink

    Shrinks the database connection pool in the data source to either the current number of reserved connections or the initial size of the connection pool, which ever is greater.

    This is a privileged operation that can only be invoked by an authorized user.

       
    Operation Name"shrink"
    Parametersnull
    Signaturenull
    Returns void
    Exceptions
    • java.lang.Exception

    shutdown

    Shuts down a data source that has a health state of Running. If any connections from the data source are currently in use, the operation fails and the health state remains Running.

    If successful, the health state is set to Shutdown.

    This is a privileged operation that can only be invoked by an authorized user.

       
    Operation Name"shutdown"
    Parametersnull
    Signaturenull
    Returns void
    Exceptions
    • java.lang.Exception

    start

    Starts a data source that has a health state of Shutdown.

    If successful, the health state is set to Running.

    This is a privileged operation that can only be invoked by an authorized user.

       
    Operation Name"start"
    Parametersnull
    Signaturenull
    Returns void
    Exceptions
    • java.lang.Exception

    suspend

    Suspends a data source has the health state of Running and disables existing connections. If any connections from the data source are currently in use, the operation fails and the health state remains Running.

    If successful, the health state is set to Suspended.

    This is a privileged operation that can only be invoked by an authorized user.

       
    Operation Name"suspend"
    Parametersnull
    Signaturenull
    Returns void
    Exceptions
    • java.lang.Exception

    testPool

    Tests the connection pool in the data source by reserving and releasing a connection from it.

    If the pool configuration attribute TestConnectionsOnReserve is enabled, the acquired connection is also tested as part of the reserve operation.

    For more information, see:

       
    Operation Name"testPool"
    Parametersnull
    Signaturenull
    ReturnsString