This sample demonstrates how to perform basic administrative tasks for a SOAP Gateway server on z/OS. Follow the instructions in the sample comments to modify the files for your environment and administrative tasks.
The zip file contains two samples: a JCL job that executes one or more SOAP Gateway management utility (iogmgmt) commands and then copies the utility output to the job log, and a sample shell script that prunes the SOAP Gateway log files according to parameters that you specify. The shell script as provided executes once, but includes basic instructions for the Unix cron job scheduling facility. The JCL can be used to execute iogmgmt commands without starting an OMVS session. These scripts are also provided with the SOAP Gateway installation package.
You can also modify the sample JCL to directly execute the sample shell script if you include the shell script as a CMD argument in the JCL.
Although these samples are intended for IMS Enterprise Suite 2.1 SOAP Gateway, they demonstrate concepts that are generally applicable to products that run under the z/OS Unix System Services environment.
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.
This end-to-end sample demonstrates how to enable an IMS™ application as a web service with WS-Security SAML 1.1 signed assertion, and 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.
Last updated: January 10, 2017
z/OS Connect Enterprise Edition (z/OS Connect EE) also provides an Eclipse-based tool, known as the z/OS Connect EE API Editor, for designing and creating APIs to act on the services.
Two IMS scenarios are provided, each with a step-by-step tutorial, to show you the steps to:
These tutorials demonstrate how to expose the IVTNO transaction in the IMS phonebook application (IMSPHBK.cpy) as a RESTful service by using the IMS Explorer for Development, and how to create APIs to invoke the service to add, delete, display, and update a phonebook entry.
These scenarios and tutorials are made available in the z/OS Connect EE product information in IBM Knowledge Center:
Make sure you check the prerequisites before you start following the tutorials.
Tip: z/OS Connect EE provides an open beta version for trials. You can download the latest version of the z/OS Connect EE open beta via the "Download open beta" link on the product developer center (ibm.biz/zosconnectdc). The open beta roughly every 4-6 weeks when new content is available. Each open beta version expires after 90 days from the day it was built. Whenever your current open beta version expires or is close to expiring, you can download and install the latest version from the developer center to extend the expiry date. The same scenarios and tutorials are provided in the open beta Knowledge Center:
Figure 1. Tutorials for each of the IMS scenarios in IBM Knowledge Center
In this overview video, we describe the new installation process for the IMS Enterprise Suite 2.2 version of SOAP Gateway on the z/OS platform. We explain the new installation architecture and its benefits, what IBM Installation Manager for z/OS is, why you should use it to install SOAP Gateway, and how the installation process generally works. Two additional videos then demonstrate how to install IBM Installation Manager for z/OS and how to install and configure SOAP Gateway for use.
Watch on YouTube: http://www.youtube.com/watch?v=uiOZKtyXJ8c&feature=plcp&list=PLeVzecbkl8Bwu9R-JV_Z-GokxgZD1_VSs
Transcript for Part 1: https://www.ibm.com/developerworks/mydeveloperworks/files/app/person/270002MTAW/file/e0a1074b-5683-42bb-9ba3-fdbe374d7974
Transcript for Part 2: https://www.ibm.com/developerworks/mydeveloperworks/files/app/person/270002MTAW/file/9f753f29-d1e9-4275-82ca-772c659a0136