JDBC Module: Control

Shrinks the database connection pool in the data source to the higher of the current number of reserved connections or the initial size of the connection pool.

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

MBean Attribute:
JDBCDataSourceRuntimeMBean.shrink

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

This method should be used when the data source is in a bad state and needs to be reinitialized.

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

MBean Attribute:
JDBCDataSourceRuntimeMBean.reset

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

MBean Attribute:
JDBCDataSourceRuntimeMBean.clearStatementCache

Disables the data source, suspending all operations on connections from the data source until the data source is re-enabled.

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

MBean Attribute:
JDBCDataSourceRuntimeMBean.suspend

Forcibly disables the data source, suspending all operations on connections from the data source until the data source is re-enabled. All current connection users are forcibly disconnected. All connections currently in use are closed and recreated.

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

MBean Attribute:
JDBCDataSourceRuntimeMBean.forceSuspend

Shuts down the data source. If any connections from the data source are currently in use, the operation will fail.

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

MBean Attribute:
JDBCDataSourceRuntimeMBean.shutdown

Forcibly shuts down the data source. All current connection users are forcibly disconnected.

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

MBean Attribute:
JDBCDataSourceRuntimeMBean.forceShutdown

Restores all access to and operations on a data source that has been suspended (marked as disabled).

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

MBean Attribute:
JDBCDataSourceRuntimeMBean.resume

The server on which the data source instance is deployed.

The current state of the data source.

Possible states are:

• Running

  - the data source is enabled (deployed and not SUSPENDED). This is the normal state of the data source.

• Suspended

  - the data source has been manually disabled.

• Shutdown

  - the data source is shutdown and all database connections have been closed.

• Unhealthy

  - all connections are unavailable (not because they are in use). This state occurs if the database server is unavailable when the data source is created (creation retry must be enabled) or if all connections have failed connection tests (on creation, on reserve, or periodic testing).

• Unknown

  - the data source state is unknown.

MBean Attribute:
JDBCDataSourceRuntimeMBean.State

Status information related to this task.