Default header (-DH)

The Default Header adapter command (-DH) specifies that the default IBM® MQ Message Descriptor (MQMD) is used as the message descriptor for data targets.

-DH

Any null rules (=NONE) in the mapped header field are ignored and the default MQMD values generated by the queue manager are used. Any non-null header fields are set in the MQMD to replace the default MQMD values. The only exception to this is fields that describe the origin and identity context of the message.

Fields describing the origin context of the message are the following (listed in the order in which they appear in the example schema, mq.mtt):
  • PutApplType
  • PutApplName
  • PutDate
  • PutTime
  • ApplOriginData
Fields describing the identity context of the message are the following (listed in the order in which they appear in the example schema, mq.mtt):
  • UserIdentifier
  • AccountingToken
  • ApplIdentityData

Do not try to specify values for these fields if you use the -DH option in the adapter command. Using that option causes values you provided in these fields to be ignored by the adapter and replaced with the default IBM® MQ values. If you need to explicitly specify values for these fields, use the -HDR option in the adapter command (without the -DH option).

The Default Header adapter command (-DH) overrides the Header adapter command (-HDR).

The appropriate header information must be mapped if the Default Header adapter command (-DH) is used. If the header information is not mapped and the Default Header adapter command (-DH) is used, the mqseries trace shows that the map fails with the following error:

<1476-2248>: [m4mqsPut]
<1476-2248>: | [intm4mqsObtainQueueNode]
<1476-2248>: | | Queue node found: QNAME
<1476-2248>: | [intm4mqsObtainQueueNode] (rc = 0) OK
<1476-2248>: | Adapter error rc = -1011 [Invalid message format]
<1476-2248>: [m4mqsPut] (rc = -1011) *** ERROR ***
<1476-2248>: [m4mqsEndTransaction]
<1476-2248>: | Rolling back unit of work
<1476-2248>: [m4mqsEndTransaction] (rc = 0) OK