The <handler> element

Defines the attributes of a message handler program.

Some CICS-supplied handler programs do not use the <handler> element. For example, the CICS-supplied SOAP message handler programs are defined using the <cics_soap_1.1_handler> and <cics_soap_1.2_handler> elements.

Used in:

Contained by:

Contains:

  1. <program> element, containing the name of the handler program
  2. <handler_parameter_list> element, containing XML elements that are made available to the message handlers in container DFH-HANDLERPLIST.

Example

<handler>
  <program>MYPROG</program>
  <handler_parameter_list><output print="yes"/></handler_parameter_list>
</handler>
In this example, the handler program is MYPROG. The handler parameter list consists of a single <output> element; the contents of the parameter list are known to MYPROG.