Managing JCA Connection Factories

Use

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 Resource Adapter tab.

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.

Prerequisites

You are in the Start of the navigation path Configuration Next navigation step Infrastructure Application Resources End of the navigation path 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 Related JCA Connection Factories tab.
Select the JCA Connection Factory to be cloned.
Choose Copy & Add New JCA Connection Factory .

The New JCA Connection Factory Creation screen opens .
Choose the Name Space tab, then enter an arbitrary name for the new connection factory in the JNDI Name field.
(Optional) If you want to add aliases for the connection factory, 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 the Add New Property pushbutton. If it is inactive, there are no new properties available for the particular connection factory.
  - If the connection factory is started, the SAP NetWeaver Administrator opens a dropdown list of the available properties.
    1. Choose the property you want to add from the dropdown list.
    2. Specify Value and Description of the property.
  - If the connection factory is stopped, choose Add , and then specify the Name , Type , Value , and Description of the new property.
- 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 .
If you want to set connection pooling parameters, refer to the relevant description in the “Configuring JCA Connection Factories” section below.
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 Details area. 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. Cleanup Interval - connection life control parameter Connection Lifetime - connection life control parameter
Add or remove an alias	Choose the Name Space 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 .