Creating the PIPELINE definition

The complete definition of a pipeline consists of a PIPELINE resource and a pipeline configuration file. The file contains the details of the message handlers that will act on Web service requests and responses as they pass through the pipeline.

The example application uses the CICS-supplied SOAP 1.1 handler to deal with the SOAP envelopes of inbound and outbound requests. CICS® provides sample pipeline configuration files which you can use in your service provider and service requester.

More than one WEBSERVICE can share a single PIPELINE, therefore you need define only one pipeline for the inbound requests of the example application. You must, however, define a second PIPELINE for the outbound requests as a single PIPELINE cannot be configured to be both a provider and requester pipeline at the same time.

  1. Use the CEDA transaction to create a PIPELINE definition for the service provider.
    1. Enter the following: CEDA DEF PIPE(EXPIPE01) G(EXAMPLE). Alternatively, you can copy the PIPELINE definition from CICS supplied group DFH$EXWS.
    2. Enter the following additional attributes:

      STATUS(Enabled)
      CONFIGFILE(/usr/lpp/cicsts
                 /samples/pipelines/basicsoap11provider.xml)

      SHELF(var/cicsts)
      WSDIR(/usr/lpp/cicsts/samples/webservices/wsbind/provider/)

      Note that the HFS entries are case sensitive and assume a default CICS HFS install root of /usr/lpp/cicsts.

  2. Use the CEDA transaction to create a PIPELINE definition for the service requester.
    1. Enter the following: CEDA DEF PIPE(EXPIPE02) G(EXAMPLE). Alternatively, you can copy the PIPELINE definition from CICS supplied group DFH$EXWS.
    2. Enter the following additional attributes:

      STATUS(Enabled)
      CONFIGFILE(/usr/lpp/cicsts
                 /samples/pipelines/basicsoap11requester.xml)

      SHELF(var/cicsts)
      WSDIR(/usr/lpp/cicsts/samples/webservices/wsbind/requester/)

      Note that the HFS entries are case sensitive and assume a default CICS HFS install root of /usr/lpp/cicsts.