Configuring CICS for web service transactions

For web service requester and provider applications to participate in web service transactions, you must configure CICS® accordingly by installing a number of CICS resources.

Before you begin

Before you can install these resources you must know the location of the pipeline configuration files that CICS supplies in support of web service transactions. By default, the configuration files are supplied in the /usr/lpp/cicsts/cicsts54/pipeline/configs directory, but the default file path might have been changed during CICS installation.

About this task

CICS support for web service transactions uses a CICS-supplied registration service. This registration service consists of a service provider and a service requester. You must install resources for both the service provider and the service requester; even if your applications are all service providers or all service requesters.

You must also install a program definition for the header handler program that is invoked when you run your service provider and requester applications.

The resources you require to configure CICS for web service transactions are all supplied in the DFHWSAT group, except for DFHPIDIR which is supplied in one of the following groups: DFHPIVS, DFHPIVR, or DFHPICF. The DFHWSAT group is not included in the DFHLIST list, and therefore is not installed automatically. You cannot change the resources supplied by CICS in the DFHWSAT group.

To configure CICS for web service transactions:

Procedure

  1. Add the DFHPIDIR data set to your startup JCL. DFHPIDIR stores a mapping between contexts and tasks.
    1. Add a new DD statement for the DFHPIDIR data set to your CICS startup JCL
    2. Create the DFHPIDIR data set using information in DFHDEFDS.JCL. The default RECORDSIZE of DFHPIDIR is 1 KB, which is adequate for most uses. You can create DFHPIDIR with a larger RECORDSIZE if you need to.
    3. Install the appropriate group for the data set on your CICS system: DFHPIVS, DFHPIVR, or DFHPICF. For more information about these groups, see Defining the WS-AT data set.
    If you want to share the DFHPIDIR file across CICS regions, the regions must be logically connected over MRO. You must install one data set per group of regions that are acting as a logical server.
    Tip: You are recommended not to share data sets between regions that are not logically connected.
  2. Copy the contents of the DFHWSAT group to another group. You cannot change the resources supplied by CICS in the DFHWSAT group. However, you must change the CONFIGFILE attribute in the PIPELINE resources.
  3. Modify the registration service's provider PIPELINE resource. The PIPELINE is named DFHWSATP, and specifies the pipeline configuration file /usr/lpp/cicsts/cicsts54/pipeline/configs/registrationservicePROV.xml in the CONFIGFILE attribute.
    1. Change the CONFIGFILE attribute to reflect the location of the file in your system.
    2. Leave the other attributes unchanged.
    Use the pipeline configuration file exactly as provided; do not change its contents.
  4. Install the PIPELINE resource. The registration services provider PIPELINE resource need not be in the same CICS region as your service requester or provider applications, but must be connected to that region with a suitable MRO or APPC connection.
  5. Without changing it, install the URIMAP that is used by the registration services provider in the same region as the PIPELINE. The URIMAP is named DFHRSURI.
  6. Modify the registration service's requester PIPELINE resource. The PIPELINE is named DFHWSATR, and specifies the pipeline configuration file /usr/lpp/cicsts/cicsts54/pipeline/configs/registrationserviceREQ.xml in the CONFIGFILE attribute.
    1. Change the CONFIGFILE attribute to reflect the location of the file in your system.
    2. Leave the other attributes unchanged.
    Use the pipeline configuration file exactly as provided; do not change its contents.
  7. Install the PIPELINE resource. The registration services requester PIPELINE resource must be in the same CICS region as the service requester and provider applications.
  8. Install the programs used by the registration service provider pipeline in the same region as your PIPELINE resources. The programs are DFHWSATX, DFHWSATR, and DFHPIRS. If both your PIPELINE resources are in different regions, you must install these programs in both regions.
  9. Install the PROGRAM resource definition for the header handler program. The program is named DFHWSATH. Install the PROGRAM in the regions where your service provider and requester applications run.

Results

CICS is now configured so that your service provider and requester applications can participate in distributed transactions using WS-AtomicTransaction and WS-Coordination protocols.

What to do next

You must now configure each participating application individually.


dfhws_wsat_configurecics.html | Timestamp icon Last updated: Sunday, 4 June 2017