Before you start
Learn what to expect from this tutorial and how to get the most out of it.
Walk through this scenario and others online as part of the Enterprise Modernization Sandbox for System z.
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®.
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.
- Java™ technology
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 184.108.40.206
System software installed on IBM® z/OS®
- IMS Version 10
- IMS Connect Version 10 with XML Adapter configured
- IMS OTMA
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