The <service_handler_list> pipeline configuration element
Specifies a list of message handlers that are invoked for every request.
Used in:
- Service provider
- Service requester
Contained by:
<service>element
Contains:
One or more of the following elements:<cics_soap_1.1_handler><cics_soap_1.2_handler><cics_soap_1.1_handler_java><cics_soap_1.2_handler_java><handler><wsse_handler>
You determine the order that each handler is called at run time by the order that you
specify the handler elements in the <service_handler_list> element. For example,
if your pipeline supports WS-Security, encrypted SOAP messages remain encrypted until the
<wsse_handler> element is called. Therefore, you must specify the
<wsse_handler> element before any other handler program that processes
unencrypted messages.
The <service_handler_list> element for a service
provider cannot contain the <cics_soap_1.1_handler_java> and
<cics_soap_1.2_handler_java> elements, because these elements must be specified
in the <terminal_handler> element for Java-based pipelines. A service requestor
can contain the <cics_soap_1.1_handler_java> and
<cics_soap_1.2_handler_java>, however if these elements are used, they must be
the first element listed in the <service_handler_list> element.
If you
expect your pipeline to process both SOAP 1.1 and SOAP 1.2 messages, you must use either the
<cics_soap_1.2_handler> or <cics_soap_1.2_handler_java>
element.
You can use either a SOAP 1.1 or a SOAP 1.2 handler in a service requester pipeline, but in this case the SOAP 1.2 handler does not support SOAP 1.1 messages. Do not specify the SOAP 1.1 or SOAP 1.2 handler in the pipeline if your service requester applications are sending complete SOAP envelopes in the DFHREQUEST container. This avoids duplicating the SOAP message headers in outbound messages.
In a service provider, you can specify the generic handler and SOAP
handlers in the <terminal_handler> element as well as in the
<service_handler_list> element. For more information about processing SOAP
header, see Header processing programs.
Example
<service_handler_list>
<wsse_handler>
...
</wsse_handler>
<cics_soap_1.1_handler_java>
...
</cics_soap_1.1_handler_java>
<handler>
...
</handler>
</service_handler_list>