The <provider_pipeline> element

The root element of the XML document that describes the configuration of the CICS® pipeline for a Web service provider.

Used in:

Contains:

  1. Optional <transport> element
  2. <service> element
  3. Start of changeOptional <apphandler> element, that specifies the name of the program that the terminal handler of the pipeline will link to by default.

    Use the <apphandler> when the terminal handler is one of the CICS-supplied SOAP message handlers, that is when the <terminal_handler> element contains a <cics_soap_1.1_handler> element or a <cics_soap_1.2_handler> element.

    Message handlers can specify a different program at run time, so the name coded here is not always the program that is linked to. If you do not code an <apphandler> element, one of the message handlers must use the DFHWS-APPHANDLER container to specify the name of the program at run time.

    Important: When you use the CICS Web services assistant to deploy your service provider, the <apphandler> element (or the DFHWS-APPHANDLER container) must specify DFHPITP, and not the name of your target application or wrapper program. In this case, you specify the name of your program in the PGMNAME parameter when you run DFHWS2LS or DFHLS2WS.
    End of change
  4. Optional <service_parameter_list> element, containing XML elements that are made available to all the message handlers in the pipeline in container DFH-SERVICEPLIST.

Example

<provider_pipeline>
  <service>
    ...
  </service>
  <apphandler>DFHPITP</apphandler>
</provider_pipeline>