Setting up the iSeries program call JCA connector for the WebSphere test environment

Information for the Advanced edition of the product This function is available only in WebSphere Development Studio Client Advanced Edition for iSeries, V5.0 or later.

The following information describes how to install a JCA connector and how to define a connection factory for use with the WebSphere Application Server V5.1 test environment in Development Studio Client for iSeries. (See the WebSphere Application Server installation and configuration documentation for information about installing the JCA connector for use with WebSphere Application Server V5.0 on an iSeries host.)

Setting up the iSeries program call JCA connector for testing your applications in the WebSphere Application Server V5.1 test environment involves the following steps:

  1. Installing the JCA connector, which includes importing a RAR file, creating a server and server configuration, and creating a J2C resource adapter.
  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.

If you are testing your applications in the WebSphere Application Server V6.0 test environment, skip to the next section in this document.

Step 1 - Installing the JCA connector

Import a RAR file

  1. Switch to the J2EE perspective.
  2. Select File > Import.
  3. Select RAR file and click Next to open the Connector Import window.
  4. Click Browse to locate and select Program Files\IBM\Rational\SDP\6.0\radi_prod\eclipse\plugins\com.ibm.etools.iseries.webtools.ae_version\lib\iseriespgmcall.rar.
  5. Click Open to populate the Connector file field with location of the RAR file, and to populate the Connector project field with iseriespgmcallConnector.
  6. Click Finish.

Create a server and server configuration

  1. Open the Server perspective.
  2. In the Server Configuration view, right-click Servers and select New > Server and Server Configuration.
  3. Enter a name in the Server name field.
  4. Expand WebSphere version 5.1 and select Test Environment.
  5. Click Finish.

Create a J2C resource adapter

  1. In the Server Configuration view, double-click the server name you created to open the server settings.
  2. In the editor view, click the J2C tab to view the J2C Options page.
  3. Under Node Settings, click Add for J2C Resource Adapters. If the RAR file you imported does not appear in the Resource Adapter Name field, select it from the list and click OK to create the J2C server adapter.

Step 2 - Defining the connection factory

Create JAAS authentication entry

  1. If the server settings for the server name that you created is not open in the editor view, double-click the server name in the Server Configuration view.
  2. In the editor view, click the Security tab to view the Security Options page.
  3. Click Add under JAAS Authentication Entries to open the Add JAAS Authentication Entry window.
  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.

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

Create a J2C connection factory

  1. In the editor view for the server settings, click the J2C tab to view the J2C Options page.
  2. In the J2C Resource Adapters table under Node Settings, select the resource adapter name you created.
  3. Click Add under J2C Connection Factories table to open the Add Connection Factory window.
  4. Enter a name for the connection factory in the Name field.
  5. Define the JNDI name by entering the name in the JNDI name field. For example, enter a name in the form eis/name.
  6. 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.
  7. Select the same alias name as above from the list for Component-managed authentication alias.
  8. Click OK to create the connection factory.

Define resource properties associated with the connection factory

  1. In the J2C Resource Adapters table, ensure that you select the resource adapter name that you created, and in the J2C Connection Factories table, ensure that you select the connection factory name that you created, so that the resource properties you are about to define are associated with that resource adapter and its J2C connection factory.
  2. In the Resource Properties area you should see ServerName, UserName, and Password in the Name column of the table. ServerName is a mandatory property. Click the Value field for ServerName, enter its value and press Enter. UserName and Password are optional properties whose value is provided by the JAAS alias.
  3. Close the Server options file and save your changes when prompted.

Setting up the iSeries program call JCA connector for the WebSphere V6.0 test environment

The following information describes how to install a JCA connector and how to define a connection factory for use with the WebSphere Application Server V6.0 test environment in Development Studio Client for iSeries.

Step 1 - Installing the JCA connector

Import a RAR file

  1. Switch to the J2EE perspective.
  2. Select File > Import.
  3. Select RAR file and click Next to open the Connector Import window.
  4. Click Browse to locate and select Program Files\IBM\Rational\SDP\6.0\radi_prod\eclipse\plugins\com.ibm.etools.iseries.webtools.ae_version\lib\iseriespgmcall.rar.
  5. Click Open to populate the Connector file field with location of the RAR file, and to populate the Connector project field with iseriespgmcall.
  6. Click Finish.

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 v6.0 Server and click Next.
  4. Enter a name or click Next to use the default value.
  5. Click Next.
  6. On the Add and Remove Projects page, select the connector EAR project created in the section above, and with any other projects to configure for this server and click Add.
  7. Click Finish.

Create a J2C resource adapter

  1. In the Navigator view, double-click the application.xml file in the META-INF folder of your connector EAR project.
  2. In the editor view, click the Deployment.
  3. Click the J2C Options section to expand it.
  4. Click Add next to the J2C Resource Adapters table. If the RAR file you imported does not appear in the Resource Adapter Name field, select it from the list and click OK to create the J2C server adapter.

Step 2 - Defining the connection factory

Create JAAS authentication entry

  1. In the Navigator view, double-click the application.xml file in the META-INF folder of your connector EAR project.
  2. In the editor view, click the Deployment.
  3. Click the Authentication section to expand it.
  4. Click Add under JAAS authentication list to open the Add JAAS Authentication Entry window.
  5. 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.
  6. Enter an ID for the JAAS login configuration in the User ID field .
  7. Enter a password for the JAAS login configuration in the Password field.
  8. Enter a description for the JAAS login configuration in the Description field.

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

Create a J2C connection factory

  1. In the editor view, click the J2C Options section to expand it.
  2. In the J2C Resource Adapters table, select the resource adapter name you created.
  3. Click Add next to the J2C Connection Factories table to open the Add Connection Factory window.
  4. Enter a name for the connection factory in the Name field.
  5. Define the JNDI name by entering the name in the JNDI name field. For example, enter a name in the form eis/name.
  6. 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.
  7. Select the same alias name as above from the list for Component-managed authentication alias.
  8. Click OK to create the connection factory.

Define resource properties associated with the connection factory

  1. In the J2C Resource Adapters table, ensure that you select the resource adapter name that you created, and in the J2C Connection Factories table, ensure that you select the connection factory name that you created, so that the resource properties you are about to define are associated with that resource adapter and its J2C connection factory.
  2. In the Resource Properties area you should see ServerName, UserName, and Password in the Name column of the table. ServerName is a mandatory property. Click the Value field for ServerName, enter its value and press Enter. UserName and Password are optional properties whose value is provided by the JAAS alias.
  3. Close the application.xml file and save your changes when prompted.