IBM Support

IMS Enterprise Suite Version 2.2 SOAP Gateway for z/OS:
Getting started with secure synchronous callout with SAML 2.0

Education


Abstract

This sample takes you through the steps to enable an IMS™ application to call out synchronously to an external web service. You will configure a secure synchronous callout request to a secure web service that uses Security Assertions Markup Language (SAML) 2.0 unsigned tokens.

Content

Diagrams are provided to show you the process flow and the context of the steps. The diagrams, general process flow, and detailed instructions are provided in the attached PDF file. Sample files for use to follow along the instructions are included in the attached compressed zip file.

Requirements

  • IMS Enterprise Suite Version 2. 2 SOAP Gateway installed on the z/OS® platform
  • IMS Version 12 with integrated IMS Connect
  • Application artifacts attached to this sample document
  • A web server, application server, or servlet container to host the target secure web service.
    This sample uses another IMS Enterprise Suite V2.2 SOAP Gateway server installed on System z® as the target web service server.
  • The FEK.SFEKLOAD data set for Rational® Developer for System z. The SFEKLOAD module needs to be added to the STEPLIB in the IMS Connect startup procedure.

Contents in this downloaded sample zip file

The zip file provided with this sample contains the following files:



File Name
Description
HELLOD.cblXML converter file. Generated with IBM® Rational® Developer for System z V8.0.3.2
HELLOD.jclJCL for compiling the HELLOD.cbl XML converter program
HELLO.cpyCOBOL copybook that contains the callout request and response message definitions.
HELLO.wsdlWeb service definition for the callout service
HELLO.xmlCorrelator XML file. Generated with Rational Developer for System z V8.0.3.2. This is used with the client SOAP Gateway server that sends the secure callout request
SYCALOUT.cblIMS program source for running an ICAL call
SYCALOUT.jclJCL for compiling the SYCALOUT program
server_artifacts/HELLO.xmlCorrelator XML file. Generated with Rational Developer for System z V8.0.3.2. This is used with the server SOAP Gateway server that receives the secure callout request
server_artifacts/HELLOService.aarAxis2 service archive for the target web
service

[{"Product":{"code":"SSGMWY","label":"IBM IMS Enterprise Suite for z\/OS"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"SOAP Gateway","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"2.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
01 June 2022

UID

swg27036434