DFHREQUEST container

DFHREQUEST is a container of DATATYPE(CHAR) that contains the request message that is processed in the request phase of a pipeline.

If one of the CICS-supplied SOAP message handlers is configured in the pipeline, the container DFHREQUEST is updated to include the SOAP message headers in the SOAP envelope. If the message is constructed by a CICS-supplied SOAP message handler, and has not been changed subsequently, DFHREQUEST contains a complete SOAP envelope and all of its contents is in the UTF-8 code page.

The DFHREQUEST container is present in the request when a message handler is called, and the DFHFUNCTION container contains RECEIVE-REQUEST or SEND-REQUEST.

In this situation, the normal protocol is to return DFHREQUEST to the pipeline with the same or modified contents. Processing of the pipeline request phase continues normally, with the next message handler program in the pipeline, if there is one.

As an alternative, your message handler can delete container DFHREQUEST, and put a response in the DFHRESPONSE container. In this way, the normal sequence of processing is reversed, and the processing continues with the response phase of the pipeline.