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:
/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”.