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:
- Installing the J2C connector, which includes creating a server
and server configuration, and installing a RAR file.
- 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
- Open the Servers view.
- In the Servers view, right-click and select .
- 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.
- Enter a name or use the default value, and then click Next.
- Enter User ID and Password if necessary.
- Click Finish.
- In the Servers view, right-click the server created, and then
click Start.
Install a RAR file
- In the Servers view, right-click the started server, and then
select .
- Enter User ID and Password if necessary.
- In the left panel, expand and click Resource
adapters.
- Select Node=node name in the Scope list.
- Click Install RAR to install a new RAR
file.
- Click Browse in Local path to locate and
select
Program Files\IBM\SDPShared\plugins\com.ibm.etools.iseries.webtools.ae_version\lib\iseriespgmcall.rar
- Click Next.
- Change the name to IBM i Program
Call Resource Adapter in the Name field, and then click OK.
- Click Save to save directly to the master
configuration.
Step 2 - Defining the connection factory
Create
JAAS authentication entry
- In the left panel, expand Security and
click Secure administration, applications, and infrastructure.
- In the Authentication section, expand Java
Authentication and Authorization Service and click J2C
authentication data.
- Click New to create a new JAAS authentication
entry.
- 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.
- Enter an ID for the JAAS login configuration in the User
ID field .
- Enter a password for the JAAS login configuration in the Password field.
- Enter a description for the JAAS login configuration in the Description field.
- Click OK.
- 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
- In the left panel, expand and click Resource
adapters.
- Click the resource adapter name: IBM i Program
Call Resource Adapter you created.
- In Additional Properties section, click J2C
connection factories.
- Click New to create a new J2C connection
factory.
- Enter a name for the connection factory in the Name field.
- Define the JNDI name by entering the name in the JNDI
name field. For example, enter a name in the form eis/name.
- 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.
- Select the same alias name as in the previous step from the list
for Component-managed authentication alias.
- Click OK to create the connection factory.
- Click Save to save directly to the master
configuration.
Define resource properties associated with the connection
factory
- Click the connection factory name that you created.
- 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.
- Click OK.
- Click Save to save directly to the master
configuration.