Configure connection factories for resource adapters within applications

To access an enterprise information system (EIS), configure connection factories, which instantiate resource adapter classes for establishing and maintaining resource connections.

An application component uses a connection factory to access a connection instance, which the component then uses to connect to the underlying enterprise information system (EIS). Examples of connections include database connections, Java Message Service connections, and SAP R/3 connections.

1. Optional: Install the application if it is not already installed on the application server.

   1. Click Applications > Install New Application.

   2. Browse to find the appropriate EAR file, which contains an RAR file.

   3. Click Next.

   4. Select Resource ref mapping to a J2C Connection Factory, then click Next.

   5. In Step 2: Map module to servers, select the resource adapters with which to associate the application and click Next.

   6. Complete the installation process for the application. For more information on installing applications, refer to the topic, Installing enterprise application files with the console.

2. Select the application to configure.

3. Click Modules > Manage Modules.

4. Select the name of the RAR file in the Manage Modules panel.

5. Click Resource Adapter under the Additional Properties heading.

6. Under the Additional Properties heading, click J2C connection factories.

   1. Click New.

   2. Specify any properties for the connection factory in the General Properties panel.

   3. Select the authentication preference.

   4. Select an alias for Component-managed authentication if any application components with Application or Per connection factory authentication specified in the resource reference are going to be getting connections from this connection factory using the empty-argument getConnection() method. For resources that support XA, we can specify an Authentication alias for XA recovery. If there are no aliases that are available, or to define a different alias:

      1. Click Apply to save the current settings.

      2. Click JAAS - J2C authentication data under the Related Items heading.

      3. Click New.

      4. Define the properties for the alias in General Properties.

      5. Click OK.

   5. Click OK.

7. Click the name of the J2C connection factory created.

8. Under the Additional Properties heading, click Connection pool properties.

   1. Change any values by clicking on the property name. For more information on the settings for connection pools, refer to the topic, Tuning connection pools, or the topic, Connection pool properties.

   1. Click OK.

9. Click Custom properties under the Additional Properties heading.

   1. Click any property name to change its value. If the UserName and Password properties are defined, they will be overridden by a component-managed authentication alias that we might have configured.

   2. Click Save.

Related concepts

Relational resource adapters and JCA

Connection pooling

Related tasks

Configure new J2C connection factories

Tune connection pools

Install enterprise application files with the console

Connection pool properties

CMP connection factories collection

Java EE resource provider or connection factory custom properties collection

J2C Connection Factories collection