IMS Version 8 Implementation Guide A Technical Overview of the New Features

Chapter 9. Java enhancements for IMS and WebSphere 125

9.6 Configure and deploy an Enterprise Archive

You use a development tool like WebSphere Studio Application Developer to code and

package, as an Enterprise Archive or EAR, the J2EE application components that use JDBC

to access IMS databases. You then follow the WebSphere for z/OS instructions to deploy that

EAR into the server. Today, this is accomplished by importing the EAR (the tool also supports

importing the just the EJB jar) into the WebSphere for z/OS Application Assembly tool to

create a resolved EAR, suitable for deployment into a WebSphere of z/OS server. Finally, you

use the WebSphere for z/OS Administration tool to install the EAR into one or more

WebSphere for z/OS J2EE servers.

When installing the EAR with the Administration tool, you will be required to bind references

in your EJB to the IMS JDBC Resource Adapter to specific instances of the resource adapter

you deployed in the J2EE Server. In the Reference and Resource Resolution window, the

Administration application displays the JDBCDataSource resource references that are

defined in the Enterprise beans or servlets in your application. For each resource reference

that needs to be an IMSJDBCDataSource, associate that resource reference with the

IMSJDBCDataSource J2EE resource instance that you defined in the previous step.

9.7 IVP for WebSphere for z/OS

The IMS Java IVP program for the WebSphere environment consists of a Web Application

(servlet and a set of JSPs) that execute an EJB Session bean in a J2EE server region.

To install the IVP application in a WebSphere for z/OS server region, do the following:

򐂰 Untar the Enterprise Archive, imsjavaIVP.ear, from the IMS Java sample program tar file.

򐂰 Configure an IMS JDBC Resource Adapter instance for use by the IVP EJB program.

򐂰 Assembly the IVP Application.

򐂰 Deploy and configure the Enterprise Archive (imsjavaIVP.ear) containing the IVP EJB jar

(IMSJdbcIVPEJB.jar) and the IVP Web Archive (IMSJdbcIVPWeb.war) using the

WebSphere for z/OS Administration tool.

򐂰 Update the HTTP server for access to the IVP Web Application

򐂰 Test the IVP program

9.7.1 Untar the IVP Enterprise Archive

Follow the directions in /usr/lpp/ims/imsjava81/samples/Readme file to decompress the

samples.tar file to obtain the Enterprise Archive, imsjavaIVP.ear, for the IVP program.

Basically what you should do, is the following:

򐂰 Set the directory into which you want the “untarred” output to be placed: CD <path>

򐂰 Decompress the samples.tar file by using the command:

tar -xvf /usr/lpp/ims/imsjava81/samples.tar

The 'ear' file can then be found in the directory:

<path>/samples/ivp/was/imsjavaIVP.ear

/usr/lpp/ims/imsjava81 is the default path name for IMS Java. If you have changed the path

name during the installation, use your own specified path name when locating IMS Java files.

Note: Detailed instructions for using the WebSphere for z/OS System Administration tool

to deploy an instance of the J2EE Resource Adapter for the IVP EJB program, and to

deploy the IVP EJB that uses that resource adapter instance, are included in the following

section “IVP for WebSphere for z/OS”.