Message handlers

A message handler is a CICS® program which is used to process a Web service request during input, and to process the response during output. Message handlers use channels and containers to interact with one another, and with the system.

The message handler interface lets you perform the following tasks in a message handler program:
Tip: It is advisable to use the CICS-provided SOAP 1.1 and SOAP 1.2 handlers to work with SOAP messages. These handlers let you work directly with the major elements in a SOAP message (the SOAP headers and the SOAP body).
All programs which are used as message handlers are invoked with the same interface: they are invoked with a channel which holds a number of containers. The containers can be categorized as:
Control containers
These are essential to the operation of the pipeline. Message handlers can use the control containers to modify the sequence in which subsequent handlers are processed.
Context containers
In some situations, message handler programs need information about the context in which they are invoked. CICS provides this information in a set of context containers which are passed to the programs.

Some of the context containers hold information which you can change in your message handler. For example, in a service provider pipeline, you can change the user ID and transaction ID of the target application program by modifying the contents of the appropriate context containers.

User containers
These contain information which one message handler needs to pass to another. The use of user containers is entirely a matter for the message handlers.
Restriction: Do not use names starting with DFH for user containers.