The <cics_mtom_handler> element
Enables the supplied MTOM handler program for SOAP pipelines. This program provides support for MTOM MIME multipart/related messages that contain XOP documents and binary attachments. MTOM support is enabled for all inbound messages that are received in the pipeline, but MTOM support for outbound messages is conditionally enabled subject to further options.
Used in:
- Service provider
- Service requester
Contained by:
In a provider pipeline configuration file, the <cics_mtom_handler> element should be defined before the <transport> element. At run time, the MTOM handler program needs to unpackage the inbound MTOM message before other handlers including the transport handler process it. It is then invoked as the last handler for the response message, to package an MTOM message to send to the web service requester.In a requester pipeline configuration file the <cics_mtom_handler> element should be defined after the <transport> element. At run time, the outbound request message is not converted into MTOM format until all other handlers have processed it. It is then invoked as the first handler for the inbound response message to unpackage the MTOM message before other handlers process it and return to the requesting program.
Contains:
- <dfhmtom_configuration> element
Default options can be changed using configuration options specified in the <dfhmtom_configuration> element. If you do not want to change the default options, you can use an empty element.
Example
For a provider mode pipeline, you could specify:<provider_pipeline>
<cics_mtom_handler></cics_mtom_handler>
<transport>
....
</transport>
<service>
....
</service>
</provider_pipeline>