Configuring connection factories for WebSphere Adapters within applications

WebSphere® Adapters can be standalone or embedded within applications. The process of configuring the connection factories depends whether the adapter is within the application. When a WebSphere Adapter is embedded in the application use the following instructions to configure your connection factory.

Before you begin

You must have the necessary permissions to edit the settings on the administrative console in order to perform this task.

Why and when to perform this task

Steps for this task

  1. Indicate the EAR file which contains the RAR file that you wish to upload and install.

    From the top level of the administrative console follow these steps:

    1. Expand Applications.
    2. Select Install New Application.
    3. Browse to the EAR file on the local or remote system.

      Select the radio button associated with the remote or local file system, and then specify a path to the EAR file.

    4. Click Next.
  2. Install the application indicating that you wish to map to a J2C connection factory.

    Select resource ref mapping to a J2C connection factory and click Next.

  3. After the application installs, create and configure a connection factory for the WebSphere Adapter embedded in the newly installed application.

    From the top level of the administrative console follow these steps:

    1. Expand Applications.
    2. Select Enterprise Applications.
    3. Select the newly installed application.
    4. Click Connector Modules under Related Items.
    5. Select the RAR file.
    6. Under Additional Properties, select Resource Adapters.
    7. Click J2C Connection Factories under Additional Properties.
    8. Click New.
    9. Specify any necessary general properties.
    10. Optional: Specify an Authentication alias for XA recovery, or use a component-managed authentication alias. This field is only displayed for resources that support XA transactions.
    11. Optional: Select a Component-managed authentication alias.
      If a desired alias is not available, or you want to define a different one,
      1. Click Apply.
      2. Click J2C Authentication Data Entries under Related Items.
      3. Click New.
      4. Specify general properties.
      5. Click OK to return to the J2C Connection Factories Settings panel.

      Select or define an alias, if any components of your application obtain connections from this connection factory with the empty-argument getConnection() method and with Application or Per connection factory authentication specified in the resource reference.

    12. Complete the creation of your new connection factory. Click OK.
  4. Optional: Change any connection pool properties of your new connection factory.

    From the J2C Connection Factory Collection panel:

    1. Select the connection factory that you just created
    2. Open the Connection Pool settings panel Click Connection pool properties under the Additional Properties heading.
    3. Change the values of any properties by clicking on the property name.
    4. Confirm these changes to the connection pool settings. Click OK.
  5. Optional: Change any custom properties

    From the Connection Factory Settings panel of the new connection factory:

    1. Click Custom Properties under the Additional Properties heading.
    2. Click any property name to change its value.
      Note: UserName and Password, if present, are overridden by the component-managed authentication alias you specified in a previous step.
    3. Click Save.
Related tasks
Configuring J2EE Connector connection factories in the administrative console

Last updated: Wed 06 Dec 2006 07:08:08

(c) Copyright IBM Corporation 2005, 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)