Configuring CICS to support web services

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

  1. 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.
  2. 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.
    1. Copy the sample provider pipeline, basicsoap11provider.xml. The sample file is in the directory /usr/lpp/cicsts/samples/pipelines.
    2. 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.
  3. 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.


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