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
- Add the DFHPIDIR data set to your startup
JCL. DFHPIDIR stores a mapping between contexts and tasks.
- Add a new DD statement for the DFHPIDIR data set to
your CICS startup JCL
- 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.
- 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.
- 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.
- 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.
- Change the CONFIGFILE attribute to reflect the location
of the file in your system.
- Leave the other attributes unchanged.
Use the pipeline configuration file exactly as provided; do
not change its contents.
- 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.
- 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.
- 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.
- Change the CONFIGFILE attribute to reflect the location
of the file in your system.
- Leave the other attributes unchanged.
Use the pipeline configuration file exactly as provided; do
not change its contents.
- Install the PIPELINE resource. The registration
services requester PIPELINE resource must be in the same CICS region
as the service requester and provider applications.
- 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.
- 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.