The <cics_mtom_handler> pipeline configuration 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.

Note: You must not use this handler program with Java-based pipelines. For Java-based pipelines, specify the <mtom> element.

Contains:

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>