Adding an unlisted Resource Adapter

You can add a resource adapter into your project that is not listed in the Resource Adapters page. Only newer versions of CICS® and IMS™ resource adapters are supported by this function.

About this task

Important: The J2C bean wizard fully supports JCA 1.0 and JCA 1.5 resource adapters. For JCA 1.6 resource adapters, we only provide toleration support as follows: If the JCA 1.6 resource adapter has a deployment descriptor ra.xml that is metadata-complete, you can still import it into the J2C bean wizard, and all the artifacts are generates as if it is a JCA 1.5 adapter. Any new JCA 1.6 annotations or attributes defined are ignored by the J2C wizard.

If the JCA 1.6 resource adapter does not have a deployment descriptor ra.xml , or it has a non-metadata complete deployment descriptor ra.xml, the J2C bean wizard will reject it with an error message: Unsupported resource adapter: the deployment descriptor (ra.xml) is missing, or it contains incomplete meta-data, for example, an unsupported enterprise information system type or specification version.

After you select your Resource Adapter in the Resource Adapter Selection page, you need to provide connection information. Connection parameters include:

Procedure

  1. Click File > Import > Java EE > RAR file to create the connector project for any JCA 1.6 adapters.
  2. For Managed Connection In the Connection Properties page, provide the JNDI name of the connection factory. You need to specify this entry if you intend to use JNDI to make your connection.
  3. For Non-Managed Connection In the Connection Properties page, enter all the required connection information. Required fields are indicated by an asterisk (*).
    1. Connection class name (Required): Specify the connection class name for this connection. Since more than one connection class can be created for a single resource adapter, and each connection class has different connection properties, you need to select the relevant Connection Class name for the connection you want to use.

Example

If your resource adapter requires other fields to be provided (server name, user name and password, for example), you need to supply this information.

Feedback