Level: Intermediate Evgueni Liakhovitch (evgueni@us.ibm.com), Software Developer,
IBM
Yee-Rong Lai (ylai@us.ibm.com), Information Developer,
IBM
Shahin Mohammadi-Rashedi (shahin@us.ibm.com), IMS SOA Demonstration Team Lead,
IBM
15 Jul 2008 This tutorial takes you through the steps of using the
J2EE™ Connector (J2C) component of the IBM® Rational® Developer for System z™ Version 7.1.1.1, and IBM® IMS™ TM Resource Adapter Version 10 to access IMS transactions through a J2C Java bean.. Once the J2C bean is created, it can easily be consumed by a Web application (JavaServer Pages component, or JSP), Web service, or Enterprise JavaBeans™ (EJB) component.
Before you start
Learn what to expect from this tutorial, and how to get the most out of it.
About this series
Walk through this scenario and others online as part of the Enterprise
Modernization Sandbox for System z.
About this tutorial
This tutorial will take you through the steps of using the J2EE Connector (J2C) component of the IBM® Rational® Developer for System z™, version 7.1.1.1 and IBM® IMS™ TM Resource Adapter Version 10.
Many customers have invested heavily in IMS to perform critical transactions for their businesses. The J2C tools available in Rational Developer for System z can expose the interaction specification properties of the IMS TM Resource Adapter and generate a Java™ class that accesses IMS transactions. Once the J2C bean is created, it can easily be consumed by a Web application (Java™Server Page component, or JSP), Web service, or Enterprise Java™Beans (EJB) component.
This tutorial will help to familiarize you with the Java Platform, Enterprise Edition (Java EE, previously known as J2EE) development environment and the J2C. In this tutorial, you will be working with the sample Phonebook IMS transaction (IVTNO), which is one of the IMS installation verification programs shipped with IMS. As an optional exercise you will also experiment with creating a Web service from the generated J2C bean class, and testing that Web service with the Web Services Explorer provided with Rational Developer for System z.
Rational Developer for System z is a superset of IBM® Rational® Application Developer, Therefore, the J2EE perspective, J2C wizard, and Web tools that are offered in Rational Application Developer are also available in Rational Developer for System z and other IDEs that also include Rational Application Developer, such as IBM® Rational® Software Architect and IBM® WebSphere® Integration Developer. The tutorial instructions also apply to these IDEs, with perhaps minor naming and interface differences.
Objectives
To understand and gain hands on experience extending IMS applications to Web as a part of Web pages or Web services. Software tools that are part of Rational Developer for System z and IMS TM Resource Adapter make the transformation processes easy, as the tutorial will demonstrate. The total cost of ownership for customers, therefore, is reduced.
Upon completion of this study, you will be able to:
-
Use Rational Developer for System z and its built-in J2C tools.
-
Configure IMS TM Resource Adapter connection factory
-
Enable IMS applications as JSP components and Web services
Prerequisites
You should be familiar with IMS, Java, and navigating the World Wide Web
System requirements for the tutorial:
-
Software installed on Windows
-
Rational Developer for System z Version 7.1.1.1
-
System software installed on IBM® z/OS®
-
IMS Version 9 or Version 10
-
IMS Connect Version 9 or Version 10 with XML Adapter configured
-
OTMA
-
TCP/IP
Checklist for the first time implementation
You may find it helpful to have the following checklist available before proceeding with your own implementation for the first time.
A tutorial checklist is provided for this exercise.
|
Your environment
|
This tutorial:
| |
COBOL copybook
|
This can be obtained from IMS application programmers.
|
C:\IMS PhoneBook\IMSPHBK.cpy
| |
IMS Connect host name (or IP address) and port number.
|
This can be obtained from IMS system programmers.
|
Host name: ZSERVEROS.DFW.IBM.COM
Port number: 9999
| |
IMS Data store.
|
This can be obtained from IMS system programmers.
|
IMSC
| |
Workspace directory and project name will be used by
Rational Developer for System z when generating artifacts.
|
A naming standard is recommended.
|
Workspace directory: C:\Workspaces\RDZv7
Project name: J2CPhoneBook
|
Overview of development tasks
To complete this tutorial you will perform the following tasks:
-
Task 1. Install and configure the IMS TM Resource Adapter. Import the IMS TM
Resource Adapter from the file system.
-
Task 2. Use the J2C Java Bean wizard to create a bean that executes a transaction in IMS. Use the J2C Java Bean wizard to set up the J2EE project, Java interface, and implementations. Create sample JSP client for testing.
-
Task 3. Deploy and test the sample application. Deploy and test the sample application within the IBM® WebSphere® Application Server.
-
Task 4. (Optional) Generate Web Service implementation. Use Rational Developer for System z to generate a Web service implementation from the sample application and test it by using the Web services explorer.
Figure 1 shows how these tools interact to help you accomplish the tutorial tasks.
Figure 1. Using Rational Developer for System z to accomplish lab objectives
| 
