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:
- Installing the JCA connector, which includes importing a RAR file, creating
a server and server configuration, and creating a J2C resource adapter.
- 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
- Switch to the J2EE perspective.
- Select .
- Select RAR file and click Next to open the
Connector Import window.
- 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.
- Click Open to populate the Connector
file field with location of the RAR file, and to populate the Connector
project field with iseriespgmcallConnector.
- Click Finish.
Create a server and server configuration
- Open the Server perspective.
- In the Server Configuration view, right-click Servers and select .
- Enter a name in the Server name field.
- Expand WebSphere version 5.1 and select Test Environment.
- Click Finish.
Create a J2C resource adapter
- In the Server Configuration view, double-click the server name you created
to open the server settings.
- In the editor view, click the J2C tab to view the J2C Options page.
- 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
- 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.
- In the editor view, click the Security tab to view the Security Options page.
- Click Add under JAAS Authentication Entries to
open the Add JAAS Authentication Entry window.
- 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.
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
- In the editor view for the server settings, click the J2C tab
to view the J2C Options page.
- In the J2C Resource Adapters table under Node Settings, select the resource
adapter name you created.
- Click Add under J2C Connection Factories table
to open the Add Connection Factory window.
- 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 above from the list for Component-managed
authentication alias.
- Click OK to create the connection factory.
Define resource properties associated with the connection factory
- 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.
- 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.
- 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
- Switch to the J2EE perspective.
- Select .
- Select RAR file and click Next to open the
Connector Import window.
- 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.
- Click Open to populate the Connector
file field with location of the RAR file, and to populate the Connector
project field with iseriespgmcall.
- Click Finish.
Create a server and server configuration
- Open the Servers view.
- In the Servers view, right-click and select .
- Select the server type WebSphere v6.0 Server and click Next.
- Enter a name or click Next to use the default value.
- Click Next.
- 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.
- Click Finish.
Create a J2C resource adapter
- In the Navigator view, double-click the application.xml file in the META-INF
folder of your connector EAR project.
- In the editor view, click the Deployment.
- Click the J2C Options section to expand it.
- 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
- In the Navigator view, double-click the application.xml file in the META-INF
folder of your connector EAR project.
- In the editor view, click the Deployment.
- Click the Authentication section to expand it.
- Click Add under JAAS authentication list to open
the Add JAAS Authentication Entry window.
- 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.
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
- In the editor view, click the J2C Options section
to expand it.
- In the J2C Resource Adapters table, select the resource adapter name you
created.
- Click Add next to the J2C Connection Factories
table to open the Add Connection Factory window.
- 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 above from the list for Component-managed
authentication alias.
- Click OK to create the connection factory.
Define resource properties associated with the connection factory
- 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.
- 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.
- Close the application.xml file and save your changes when prompted.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.