en.help.task-connectorconnectionpoolnew.html Maven / Gradle / Ivy
Show all versions of console-jca-plugin-help
To Create a Connector Connection Pool
Before You Begin
Before creating the pool, deploy the connector module (resource adapter) associated with the
pool. The values that are specified for the new pool depend on the
connector module that is deployed.
- In the navigation tree, expand the Resources node.
- Expand the Connectors node.
- Under the Connectors node, select the Connector Connection Pools node.
The Connector Connection Pools page opens.
- On the Connector Connection Pools page, click New.
The New Connector Connection Pool (Step 1 of 2) page opens.
- In the Name field, enter a unique name for the pool.
Specify this name when creating a connector resource.
- From the Resource Adapter drop-down list, select from the list of deployed resource
adapters (connector modules).
- From the Connection Definition drop-down list, select the connection definition for the connector
connection pool.
The choices in the list depend on the resource adapter you selected. The
connection definition identifies a resource adapter's connection-definition element in thera.xml file.
- Click Next.
The New Connector Connection Pool (Step 2 of 2) page opens.
- In the Description field, type a description of the connection pool.
- In the Initial and Minimum Pool Size field, specify the minimum number of
connections in the pool.
The default value is 8.
- In the Maximum Pool Size field, specify the maximum number of connections in
the pool.
The default value is 32.
- In the Pool Resize Quantity field, specify the number of connections to be
removed when pool idle timeout expires.
The default value is 2.
- In the Idle Timeout field, specify the maximum time in seconds that a
connection can remain idle in the pool.
The default value is 300.
- In the Max Wait Time field, specify the amount of time the
application requesting a connection will wait before getting a connection timeout.
The default value is 60000.
- Select the Connection Validation Required checkbox to enable connection validation.
If the Required checkbox is selected, connections are validated before being given to
the application. If a resource's validation fails, it is destroyed, and a new
resource is created and returned. This option is disabled by default.
- Select the On Any Failure Close All Connections checkbox so the Enterprise
Server will close all connections in the pool and reestablish them if a
single connection fails.
If you do not select the checkbox, individual connections will be reestablished only
when they are used. This option is disabled by default.
- From the Transaction Support drop-down list, select the type of transaction support for
the connection pool.
The chosen transaction support overrides the transaction support attribute in the resource adapter associated
with this connection pool in a downward compatible way. In other words, it
can support a lower transaction level than that specified in the resource adapter,
or the same transaction level as that specified in resource adapter, but it
cannot specify a higher level.
The following options are available in the drop-down list:
- NoTransaction: Indicates that the resource adapter does not support resource manager local or
JTA transactions and does not implement the XAResource or LocalTransaction interfaces.
- LocalTransaction: Indicates that the resource adapter supports local transactions by implementing the LocalTransaction
interface.
Local transactions are managed internal to a resource manager and involve no external
transaction managers.
- XATransaction: Indicates that the resource adapter supports resource manager local and JTA transactions
by implementing the LocalTransaction and XAResource interfaces.
XA transactions are controlled and coordinated by a transaction manager external to a resource
manager.
- (Optional) In the Additional Properties section, specify additional properties for the connector connection pool.
Available properties depend upon the resource adapter for the connector connection pool.
To add a property, click the Add Property button. In the blank
row that appears, type the property name in the Name field, and type
the property value in the Value field.
- Click OK.
See Also