This sample takes you through the steps to enable an IMS™ application as a web service. 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 IMS Enterprise Suite 2.2 SOAP Gateway and is written for the Windows™ platform.
A new IMS Enterprise Suite 2.1 SOAP Gateway example is available: Enabling an IMS application as a web service provider with or without WS-Security (SAML 1.1 unsigned security tokens)
This end-to-end sample demonstrates the steps to enable an
IMS™ application as a web service. You can choose the path to follow,
either without WS-Security, or with Security Assertion Markup Language
(SAML) 1.1 unsigned sender-vouches tokens. This sample also demonstrates
how to create a client application that sends messages through secure
HTTPS communications to the IMS Phonebook web service that is deployed
on the SOAP Gateway server.
Abstract: This document’s goal is to enable easy and quick setup and test of the Open Database solution. It clearly mentions the pre-requisites and other required information before starting, lists all the jobs/tasks required and the order to be run. It also provides screenshots of all the jobs/tasks for easier understanding of a person even if not familiar with the IVP application.
DavidHanson 270002MTAW 1,661 Views
Starting with the IMS Enterprise Suite V2.2, SOAP Gateway installation on the z/OS platform requires the use of IBM Installation Manager for z/OS. In addition, a three-part installation architecture is introduced to enhance the server’s security and the ability to add more disk space without interrupting server operations when demands for web services increase. This installation architecture and the installation process is generally the same in IMS Enterprise Suite V3.1.
If you are new to SOAP Gateway, you can watch the IMS Enterprise Suite V2.2 SOAP Gateway installation on z/OS video series to get acquainted with the general process. The video series is available on YouTube: http://www.youtube.com/watch?v=uiOZKtyXJ8c&feature=plcp&list=PLeVzecbkl8Bwu9R-JV_Z-GokxgZD1_VSs
The following sections describe what the videos cover and point out the differences between V2.2 and V3.1 installation steps.
Video 1: IMS Enterprise Suite V2.2 SOAP Gateway: Installation using IBM Installation Manager for z/OS
You can download the video transcript here: https://www.ibm.com/developerworks/mydeveloperworks/files/app/person/270002MTAW/file/e0a1074b-5683-42bb-9ba3-fdbe374d7974
Video 2: IMS Enterprise Suite V2.2 SOAP Gateway installation series, Part II: Installing IBM Installation Manager for z/OS
This video demonstrates how to install IBM Installation Manager for z/OS, which is required before you can install SOAP Gateway. The same version of IBM Installation Manager for z/OS is included IMS Enterprise Suite V3.1, so the installation process described in this video is the same for V3.1.
You can download the video transcript here:
Video 3: IMS Enterprise Suite V2.2 SOAP Gateway installation series, Part III: Installing SOAP Gateway
This video demonstrates how to install SOAP Gateway using IBM Installation Manager. This general process applies to IMS Enterprise Suite 3.1, although the actual FMIDs and the provided sample JCLs for installation and configuration are somewhat different between Version 3.1 and Version2.2.
For IMS Enterprise Suite 3.1, several of the sample installation jobs have changed. While you can watch the video to get a general idea of the steps involved, ensure that you follow the steps described in the following topics in the SOAP Gateway documentation instead:
For an overall installation roadmap that covers different installation scenarios and other potential configuration steps, see the Installing SOAP Gateway on z/OS topic here: http://publib.boulder.ibm.com/infocenter/dzichelp/v2r2/topic/com.ibm.ims.soap31.doc/sgw_install_z31.htm
DavidHanson 270002MTAW 1,263 Views
The IMS Universal JDBC driver is normally used to provide an interface for an application program to make SQL queries to get IMS data. However, you can also cast to DL/I objects from the JDBC interface. You might want to use this approach if you want to reuse a known-good DL/I call in a new application context, or if you want to obtain maximum performance for a simple query.
This example demonstrates how to make the cast to the DL/I driver and obtain data. This example accesses a JDBC connection from a JNDI datasource that was created in a JEE server with the IMS Universal Database Resource Adapter.
DavidHanson 270002MTAW 1,178 Views
A new set of pre-generated sample artifacts has been made available so that the callout application with SAML security tutorial (located at http://www-01.ibm.com/support/docview.wss?uid=swg27036434) can be used with the latest version of IMS Enterprise Suite SOAP Gateway, version 3.1. Download the new artifacts here: https://www.ibm.com/developerworks/community/files/app/file/b265e36d-3f65-4f06-a88a-ba8f9712c232.
DavidHanson 270002MTAW 1,156 Views
The IMS Enterprise Suite Version 3.1 SOAP Gateway management utility includes the -batch command flag that you can use to submit commands in batch mode, instead of interactive (or online) mode. Batch commands are executed in sequence by the utility in a single JVM instance and produce a log file instead of console output. This example demonstrates how to create batch scripts to administer SOAP Gateway, and how how to identify and troubleshoot problems in batch scripts.