Level: Intermediate Chao-Lin Liu (cliu@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
24 Jun 2008 This tutorial takes you through a series of intensive hands-on
exercises to transform an Information Management System™ (IMS) application to a Web service by using IBM® Rational® Developer for System z and IMS SOAP Gateway.
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 takes you through a series of intensive hands-on exercises
designed to transform an IMS application to a Web service by using IBM® Rational® Developer for System z and
IMS SOAP Gateway. IMS SOAP Gateway is a Web service solution that integrates
IMS assets in a service-oriented architecture (SOA) environment. It enables IMS
applications as Web services through easy deployment and configuration
processes. The IMS SOAP Gateway solution integrates with the IMS
Connect XML adapter function, which provides XML conversion support. This
enables users to send and receive XML data without modification of existing IMS
applications. Through the tooling in Rational Developer for System z, Web service
artifacts can be easily generated. Artifacts include a Web Services Description
Language (WSDL) file, the correlator file, and the XML converter. Rational
Developer for System z generates the XML converter from COBOL copybooks to be
used by the IMS Connect XML adapter. The IMS SOAP Gateway deployment utility
completes the backend IMS connection configurations. IMS SOAP Gateway runs on
multiple platforms, including z/OS (IMS SOAP Gateway V10.1), Microsoft
®Windows® XP, Microsoft Windows 2000, IBM® AIX®, and
zLinux®.
 |
Objectives
To help you understand and gain hands-on experience in extending IMS
applications to the Web as a part of Web services. This tutorial demonstrates
how using Rational Developer for System z and the SOAP Gateway utility makes the
transformation processes easy. Upon completion of this tutorial, you will be
able to:
- Use Rational Developer for System z.
- Use the IMS SOAP Gateway deployment utility to deploy an IMS application
as a Web service.
Prerequisites
Knowledge of:
System requirements
Software installed on the Microsoft Windows operating system:
- IMS SOAP Gateway Version 10.1 with fix pack V101 iFix1
- Rational Developer for System z Version 7.1.1.1
System software installed on IBM® z/OS®
- IMS Version 10
- IMS Connect Version 10 with XML Adapter configured
- IMS OTMA
- TCP/IP
Checklist for first-time implementation
of a Web service
We recommend that you have the checklist in Table 1 available when you are planning for your own Web service implementation the first time. It includes a checklist
for this tutorial.
Table 1. Checklist for first-time implementation of a Web service
| Information or resource | Your environment | For this tutorial |
|---|
| COBOL copybook | Get from IMS application programmers | C:\IMS PhoneBook\IMSPHBK.cpy |
|---|
| IMS SOAP Gateway host name (or IP address) and
port number | Get from IMS application programmers | Host name: localhost
Port number: 8080 |
|---|
| IMS Connect host name (or IP address) and port
number | Get from IMS application programmers | Host name: ZSERVEROS.DFW.IBM.COM
Port number: 9999 |
|---|
| IMS data source (IMS ID) | Get from IMS application programmers | IMSC |
|---|
| IMS SOAP Gateway installation directory | Get from the support team that installed IMS SOAP Gateway | C:\Program Files\IBM\IMS SOAP Gateway V10.1 |
|---|
| Workspace directory and project name to be used
by Rational Developer for System z when generating artifacts | A naming standard is recommended | Workspace directory: C:\Workspaces\RDZv7
Project name:
IMSPhoneBook |
|---|
| 
