Overview of development tasks
IMS applications can be enabled as Web services running in IMS SOAP Gateway without the need for a full-fledged application server, such as IBM® WebSphere® Application Server. Different types of client applications, such as Microsoft® .NET, Java, and third-party applications, can send SOAP requests into IMS to drive the business logic of your IMS applications.
This tutorial uses the IMS phonebook application (IVTNO) as an example to demonstrate how to make it accessible as a Web service. The client application (a Java™ application) for accessing the Web service is provided here.
To complete this tutorial, you will go through the steps of enabling an IMS application as a Web service by using IBM Rational Developer for System z to generate the necessary artifacts and then complete the deployment processes by using the IMS SOAP Gateway deployment utility.
To complete this tutorial, you will perform the following five tasks:
- Generate the artifacts by using Rational Developer for System z (see
the diagram in Figure 1).
Key steps in this task:
- Import the COBOL copybook.
- Specify the input and output data structure.
- Set the IMS SOAP Gateway host name and port number.
- Set the IMS transaction code and connection information.
- Specify the converter names.
Figure 1. Input and output when using Rational Developer for System z
- Transfer the generated XML converter to IBM z/OS. Compile and link the converter for the IMS Connect XML adapter (Figure 2).
Figure 2. Deploying the XML converter to IMS Connect
- Enable the IMS application as a Web service. Deploy the generated
WSDL file and configuring the correlation properties by using the IMS SOAP
Gateway V10.1 Deployment Utility (Figure 3).
- Provide the WSDL file that is generated by Rational Developer for System z.
- Set the connection information to connect to IMS.
- Set the IMS Connect host name and port number.
- Set the IMS data store name (IMS ID).
- Provide the correlator file path.
Figure 3. Deploy the correlator file and WSDL file by using the IMS SOAP Gateway deployment utility
- Deploy a client application to access the IMS PhoneBook Web service. Write or modify an existing Java application to access the IMS application that has been deployed as a Web service.
- Invoke the Java application that accesses the IMS application.