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.
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:
- 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
- Creating a Java™ client to access the web service
- 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.
|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.|
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.