Managing JCA Connection Factories

You use this procedure to view connection definitions and manage their connection pooling and configuration properties. JCA Connection Factories are defined by an outbound resource adapter. To view the defining adapter, choose the Antecedent JCA Resources tab.

Note Note

Changing property values may significantly alter the function of the resource adapter, which may also affect other applications that use it. Therefore, you must be careful when modifying the CF properties.

End of the note.

Prerequisites

You are in the Configuration Management Infrastructure Application Resources function.

Procedure

Cloning Connection Factories

Choose Show JCA Resources .
Select the JCA Resource with the JCA Connection Factory you wish to clone from the Resource List.
Choose the Dependent JCA Connection Factories tab.
Select the JCA Connection Factory to be cloned.
Choose Copy and Add New JCA Connection Factory.

The New JCA Connection Factory Creationarea opens.
Choose the Namespace tab, then enter an arbitrary name fort he CF in the JNDI Name field.
(Optional) If you want to add aliases for the CF, choose Add New Alias and enter an arbitrary name for the alias in the Alias Name field.
To add/remove or modify configuration properties, choose the Configuration Properties tab.
- To add a new property, choose Add New Property, then specify the values in the Name, Type, Value, and Description fields as necessary.
- To change an existing property, select the property, then modify the values in the Name, Type, Value, and Description fields as necessary.
- To remove a property, select the property, then choose Remove Property.
To set connection pooling parameters, choose the Connection Pooling tab.
1. Specify the following values:
  - Maximum Connections - maximum connections that are kept in the pool
  - Maximum Time to Wait for Connection
    
    When the maximum number of supported connections is reached and there are no free connections in the pool, the client waits for the specified interval to obtain a connection. If the system does not return a connection to the pool during the interval, an exception is thrown.
To save the cloned Connection Factory, choose Save.
To view the newly created Connection Factory, choose Show JCA Connection Factories .

Configuring JCA Connection Factories

To modify a Connection Factory configuration at runtime, choose Show JCA Connection Factories .

Select a Connection Factory from the Resources List.

Task	Steps
Delete a Connection Factory	Choose Delete Selected Resource.
Manage Connection Pooling	Choose the Connection Pooling tab in the Resource Detailsarea. Specify the following parameters: Maximum Connections - maximum connections that are kept in the pool Maximum Time to Wait for Connection When the maximum number of supported connections is reached and there are no free connections in the pool, the client waits for the specified interval to obtain a connection. If the system does not return a connection to the pool during the interval, an exception is thrown. Expiration - enables the parameters for connection life control - that is, Cleanup Intervaland Connection Lifetime. By default, this option is disabled.
Add/Remove an Alias	Choose the Namespace tab. To add an alias: Choose Add New Alias. A blank new line appears at the top of the list of aliases. Enter an arbitrary name for the alias and choose the Save button in the Resource Details area. To remove an alias, select the alias and choose Remove Selected Alias.