Create the CICS® resources,
including the pipeline, to process inbound and outbound web service
requests.
About this task
Configure the application-owning region (AOR) to support
web services. You can either create the resources in
CICS Explorer® as
described in the procedure or edit the @CDEF124 job in the
CNTL data
set. This job creates the TCPIPSERVICE and PIPELINE definitions in
a group called GENAWSRV in the list AORLIST.
Procedure
- Create a TCPIPSERVICE resource
to accept the web service requests; name the resource GENATCP1. Use the following attributes:
- Set a suitable port number to receive the SOAP over HTTP requests.
- Set the protocol to HTTP.
- Create a pipeline configuration file. The pipeline
handles web service requests and can support SOAP 1.1 or SOAP 1.2
messages. It transforms the XML in the SOAP body into data that the
application can interpret on the inbound requests, and creates a valid
SOAP message from the application response.
- Copy the sample provider pipeline, basicsoap11provider.xml. The sample file is in the directory /usr/lpp/cicsts/samples/pipelines.
- Save the pipeline configuration file in a directory
in zFS. The AOR must have read and execute access to this
directory.
The basicsoap11provider.xml file contains
the following XML:<?xml version="1.0" encoding="EBCDIC-CP-US"?>
<provider_pipeline xmlns="http://www.ibm.com/software/htp/cics/pipeline">
<service>
<terminal_handler>
<cics_soap_1.1_handler/>
</terminal_handler>
</service>
<apphandler>DFHPITP</apphandler>
</provider_pipeline>
The pipeline configuration file
specifies a terminal handler that handles the SOAP envelope and an
application handler that handles the data conversion. CICS supplies both handlers.
- Create a PIPELINE resource
that points to the pipeline configuration file in zFS. You
must also specify a pipeline pickup directory in the WSDIR attribute
that contains the web service binding files. The example supplied
with the general insurance application uses /u/userid/genapp/wsdir.
Results
You have set up the resources that are required to handle
web service requests in CICS.
What to do next
Use the CICS web services
assistant to create the WSDL documents and bindings from the CICS application.