IMS Connectivity in an On Demand Environment: A Practical Guide to IMS Connectivity

448 IMS Connectivity in an On Demand Environment: A Practical Guide to IMS Connectivity

21.5.4 Step 4: Setting up application server for distributed platforms

environment

In this section, we introduce how we set up the WebSphere Application Server for distributed

platforms environment.

Step 4-1: Installing the IMS distributed JDBC resource adapter

Before deploying applications, you must first set up WebSphere Application Server on the

non-z/OS client side by installing the IMS distributed JDBC resource adapter. WebSphere

Application Server on the client side requires only the IMS distributed JDBC resource

adapter,

imsjavaRDS.rar.

We install the IMS distributed JDBC resource adapter by performing the following steps:

1. From the client-side WebSphere Application Server administrative console, click

Resources, and then click Resource Adapters. This displays a list of resource adapters,

as shown in Figure 21-42.

Figure 21-42 List of resource adapters in WebSphere Application Server for distributed platforms

2. Click Install RAR. A panel for installing the resource adapter opens, as shown in

Figure 21-43. Then, enter the Local path to the imsjavaRDS.rar file. Click

Next.

Figure 21-43 Install RAR File panel

Chapter 21. IMS Remote Database Services 449

3. A configuration panel opens, as shown in Figure 21-44. Click Next.

Figure 21-44 Configuration panel

4. The IMS distributed JDBC resource adapter is listed, as shown in Figure 21-45.

Figure 21-45 List of resource adapters with IMS distributed JDBC resource adapter

5. Click Save to Master Configuration. The Save page opens. Under Save to Master

Configuration, click

Save.

Step 4-2: Installing the data source for the client application

Our client application will use the data source on the WebSphere Application Server for

distributed side to connect the WebSphere Application Server for z/OS and make the specific

ODBA connection with the PSB. The J2C properties on the WebSphere Application Server

for distributed platforms will be propagated to an instance of the IMS RDS data source

definition on the WebSphere Application Server for z/OS side. We install the data source for

our client application by performing the following steps:

1. In the left frame of the client-side WebSphere Application Server administrative console,

click

Resources, and then click Resource Adapters. This displays a list of resource

adapters.

450 IMS Connectivity in an On Demand Environment: A Practical Guide to IMS Connectivity

2. Click IMS Distributed JDBC RA. A configuration panel opens, as shown in Figure 21-46.

Under Additional Properties, click

J2C connection factories.

Figure 21-46 Configuration panel

3. Click New. A configuration panel opens, as shown in Figure 21-47. Enter the following

information:

– Name: Display name of the J2C connection factory, in our case, imsjavaRDSRedBook

– JNDI name: JNDI name of the J2C connection factory, in our case, imsjavaRDSRedBook

Click

OK.

Figure 21-47 Configuration panel for the J2C connection factory

Tip: To avoid the messages J2CA0107I and J2CA0114W, both of which can be

ignored, set the default values for the component-managed authentication alias and

container-managed authentication alias.