Setting up the IBM i program call J2C connector for the WebSphere test environment

The following information describes how to install a J2C connector and how to define a connection factory for use with the IBM WebSphere® Application Server test environment in Rational® Developer for Power Systems Software.

Setting up the IBM® i program call J2C connector for testing your applications in the WebSphere Application Server test environment involves the following steps:

  1. Installing the J2C connector, which includes creating a server and server configuration, and installing a RAR file.
  2. Defining the connection factory, which includes creating a JAAS authentication entry, creating a J2C connection factory, and defining the resource properties associated with the connection factory.

Setting up the IBM i program call J2C connector for the WebSphere V6.x and V7.0 test environment

The following information describes how to install a J2C connector and how to define a connection factory for use with the WebSphere Application Server V6.x and V7.0 test environment in Rational Developer for Power Systems Software.

Step 1 - Installing the J2C connector

Create a server and server configuration

  1. Open the Servers view.
  2. In the Servers view, right-click and select New > Server.
  3. Select the server type WebSphere Application Server v6.x or WebSphere Application Server v7.0. Ensure that the selected Server runtime is correct, and then click Next.
  4. Enter a name or use the default value, and then click Next.
  5. Enter User ID and Password if necessary.
  6. Click Finish.
  7. In the Servers view, right-click the server created, and then click Start.

Install a RAR file

  1. In the Servers view, right-click the started server, and then select Administration > Run administrative console.
  2. Enter User ID and Password if necessary.
  3. In the left panel, expandResources > Resource Adapters and click Resource adapters.
  4. Select Node=node name in the Scope list.
  5. Click Install RAR to install a new RAR file.
  6. Click Browse in Local path to locate and select
    Program Files\IBM\SDPShared\plugins\com.ibm.etools.iseries.webtools.ae_version\lib\iseriespgmcall.rar
  7. Click Next.
  8. Change the name to IBM i Program Call Resource Adapter in the Name field, and then click OK.
  9. Click Save to save directly to the master configuration.

Step 2 - Defining the connection factory

Create JAAS authentication entry

  1. In the left panel, expand Security and click Secure administration, applications, and infrastructure.
  2. In the Authentication section, expand Java Authentication and Authorization Service and click J2C authentication data.
  3. Click New to create a new JAAS authentication entry.
  4. Enter a name in the Alias field that represents the alias name of the JAAS login configuration for the role-based authorization for J2EE resources.
  5. Enter an ID for the JAAS login configuration in the User ID field .
  6. Enter a password for the JAAS login configuration in the Password field.
  7. Enter a description for the JAAS login configuration in the Description field.
  8. Click OK.
  9. Click Save to save directly to the master configuration.

The user ID and password that you specify in the JAAS authentication entry are used for signing on to the IBM i system for the program call.

Create a J2C connection factory

  1. In the left panel, expand Resources > Resource Adapters and click Resource adapters.
  2. Click the resource adapter name: IBM i Program Call Resource Adapter you created.
  3. In Additional Properties section, click J2C connection factories.
  4. Click New to create a new J2C connection factory.
  5. Enter a name for the connection factory in the Name field.
  6. Define the JNDI name by entering the name in the JNDI name field. For example, enter a name in the form eis/name.
  7. Select the alias name, which you defined on the Security page in the JAAS Authentication Entries area, from the list for Container-managed authentication alias.
  8. Select the same alias name as in the previous step from the list for Component-managed authentication alias.
  9. Click OK to create the connection factory.
  10. Click Save to save directly to the master configuration.

Define resource properties associated with the connection factory

  1. Click the connection factory name that you created.
  2. In Additional Properties section, click Custom properties. You should see ServerName, UserName, and Password in the Name column of the table. ServerName is a mandatory property. Click the ServerName in the Name column and enter its value in the Value field. UserName and Password are optional properties whose value is provided by the JAAS alias.
  3. Click OK.
  4. Click Save to save directly to the master configuration.

Feedback