IMS Enterprise Suite Version 1.1 SOAP Gateway (Fix Pack 2) for Windows IMS Phonebook sample: Enabling an IMS application as a web service provider

Product documentation


Abstract

This sample takes you through the steps to enable an IMS™ application as a web service by using the IMS Phonebook sample application (IVTNO) in two scenarios-- with Web services security (WS-Security) enabled as well as disabled. This sample also demonstrates how to create a client application to access the web service that is deployed on the SOAP Gateway server. This sample is based on Fix Pack 2 and is written for the Windows™ platform.

Content

When WS-Security is enabled, user authentication is performed on a per-message basis. When WS-Security is disabled, user authentication is performed on a per-web service basis.

This sample walks you through the steps to enable an IMS application as a web service by using the IMS Phonebook sample application (IVTNO), with both scenarios where WS-Security is enabled and disabled. This sample also demonstrates how to create a client application to access the web service that is deployed on the SOAP Gateway server.

This sample demonstrates the following steps:

  1. Enabling an IMS application as a web service
    • Generating the web service artifacts by using the Rational® Developer for System z®
    • Deploying the web service artifacts to SOAP Gateway
  2. Creating a Java™ client to access the web service


Requirements
  • IMS Enterprise Suite Version 1.1 SOAP Gateway Fix Pack 2 installed on a Windows system
  • IMS Version 11 with integrated IMS Connect
  • The IMS Phonebook sample files (included in attached zip file)
  • IBM® Rational Developer for System z Version 8.0.1 or later

Contents in this downloaded sample zip file

The zip file that you downloaded includes the COBOL copybook for the Phonebook sample application to be enabled as a web service. The zip file also includes the generated files from Rational Developer for System z and the IMS Enterprise Suite SOAP Gateway deployment utility for your reference in case you do not have access to Rational Developer for System z Version 8.0.1.

File name
Description
Phonebook copybook and files that are generated by Rational Developer for System z
Two sets of the following files are provided in two separate directories, one for WS-Security disabled scenario, and the other for the WS-Security enabled scenario.
IMSPHBK.cpy The IMS Phonebook application copybook
IMSPHBK.wsdl The WSDL file
IMSPHBK.xml The correlator file
IMSPHBKD.cbl The XML converters file
Sample Java application
IMSPHBKClient.java Sample Java application that uses the client proxy Java code generated by the IMS Enterprise Suite SOAP Gateway Deployment utility.
Documentation
IMSEnterpriseSuite_SOAP_Provider.pdf This document

Known download issue: For some versions of Microsoft™ Internet Explorer, there is a known issue that the zip file appears as a docview.wss file after it is downloaded. The workaround is to rename the file to a .zip file after it is downloaded. You will then be able to extract the files. You can also find the latest fixpack for Internet Explorer at http://support.microsoft.com/default.aspx?scid=kb;EN-US;303750.

IMSEnterpriseSuite_SOAP_Provider_Windows.zip

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

IMS Enterprise Suite
SOAP Gateway

Software version:

1.1

Operating system(s):

Windows

Reference #:

7017112

Modified date:

2011-07-01

Translate my page

Machine Translation

Content navigation