IBM Support

CA1P: Web services samples for CICS TS



SupportPac CA1P contains some simple Web services samples that are designed to assist new users in getting started with CICS Transaction Server for z/OS web services.

Download Description

CICS Transaction Server for z/OS (CICS TS) V3.1 introduced the capability to expose a CICS program as a web service, or to invoke a web service from within a CICS program.

SupportPac CA1P aims to help you understand how web services are implemented within CICS TS. This SupportPac contains four samples, complete with exercises containing step-by-step instructions that can be followed to deploy the samples onto a CICS region.

The four samples are:
  1. Develop a CICS web service provider using the web services assistant
  2. Develop a CICS web service requester using the web services assistant
  3. Develop a CICS web service provider using Rational Developer for System z (RDz) V7.1, or later
  4. Develop a CICS web service requester using RDz V7.1, or later

The samples are provided for use in pairs: Sample 1 pairs with Sample 2, and Sample 3 pairs with Sample 4.
  • Sample 1 exposes an existing CICS program (the function of which is to echo a string) as a web service.
  • Sample 2 creates a CICS web service requester that can call the web service exposed in Sample 1.
  • Sample 3 and Sample 4 demonstrate creating the same web service and web service requester as Samples 1 and 2, using features of RDz to simplify the development process.

The documentation for the samples describes how to implement them using CICS TS V3, however the samples can also be applied to CICS TS V4 and CICS TS V5.

Possible uses
SupportPac CA1P is designed to enable the user to create a simple CICS web service, and then to create a CICS program that invokes the web service (a web service requester). It is designed to educate you on CICS web services, to allow you to familiarize yourselves with CICS web services, and to allow you to quickly create a working web service.

Skill level required
A basic understanding of CICS Transaction Server for z/OS, TSO, and ISPF.

What's new in release V1.02
The accompanying documentation has been updated to describe the actions necessary when completing exercises 3 and 4, having already performed exercises 1 and 2. The documentation now recommends that during exercise 3 the CSD group should be deleted, before proceeding with the remaining exercises.

Authors: Dan Millwood, CICS Development, Hursley
Category: 2
Released: 15Oct08
Last updated: 13Feb09
Current Version: 1.02


This SupportPac requires:

Installation Instructions

To download the SupportPac:
  1. Click on the FTP link below for the relevant version of the SupportPac and save the compressed file to your local machine.
  2. Extract the saved file to a temporary directory on your local machine. This will create the necessary installation, documentation, and license files.
  3. Follow the instructions in the included documentation to complete installation of this SupportPac on your host system.

[{"DNLabel":"ca1p","DNDate":" ","DNLang":"US English","DNSize":"2760285 B","DNPlat":{"label":"z/OS","code":"PF035"},"DNURL":"","DNURL_FTP":"","DDURL":null}]

Technical Support

SupportPacs in this category are available at no charge to all licensed users of the CICS family products on the platforms specified in the SupportPac description. These SupportPacs are provided "AS-IS" (under the terms and conditions of the IBM International License Agreement for Non-Warranted Programs and of the associated License Information and other documentation). The terms and conditions of this license DO NOT provide for any entitlement to defect correction.

To determine if you want to use this SupportPac, read the accompanying license file.

CICS SupportPacs
To view the complete portfolio of CICS SupportPacs, go to the
CICS SupportPacs Home Page

[{"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"SupportPac","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"3.1;3.2;4.1;4.2;5.1;5.2;5.3","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICS/TS CICS TS CICS Transaction Server

Document Information

Modified date:
27 April 2021