Defines the attributes of the CICS-supplied SOAP 1.2 message handler program.
<t:myheaderblock xmlns:t="http://mynamespace" ...> .... </t:myheaderblock>
<namespace>http://mynamespace</namespace>
<localname>myheaderblock</localname>
<namespace>http://mynamespace</namespace>
<localname>myhead*</localname>
When you use the asterisk
in the <localname> element, a header in a message can
match more than one <headerprogram> element. For example,
this header block <t:myheaderblock xmlns:t="http://mynamespace" ...> .... </myheaderblock>
matches
all the following <headerprogram> elements:<headerprogram>
<program_name>HDRPROG1</program_name>
<namespace>http://mynamespace</namespace>
<localname>*</localname>
<mandatory>false</mandatory>
</headerprogram>
<headerprogram>
<program_name>HDRPROG2</program_name>
<namespace>http://mynamespace</namespace>
<localname>myhead*</localname>
<mandatory>false</mandatory>
</headerprogram>
<headerprogram>
<program_name>HDRPROG3</program_name>
<namespace>http://mynamespace</namespace>
<localname>myheaderblock</localname>
<mandatory>false</mandatory>
</headerprogram>
When this is the case, the header program that
runs is the one specified in the <headerprogram> element
in which the element name of the header block is most precisely stated. In
the example, that is HDRPROG3.When the SOAP message contains more than one header, the header processing program is invoked once for each matching header, but the sequence in which the headers are processed is undefined.
If you code two or more <headerprogram> elements that contain the same <namespace> and <localname>, but that specify different header programs, only one of the header programs will be called to process the header. The header will be passed in the DFHHEADER container to the selected program. The other header programs will not be called unless they are defined with<mandatory>true</mandatory> in which case they will be called without having the header passed in the DFHHEADER container.
<cics_soap_1.2_handler>
<headerprogram>
<program_name> ... </program_name>
<namespace>...</namespace>
<localname>...</localname>
<mandatory>true</mandatory>
</headerprogram>
</cics_soap_1.2_handler>