Message Header
A header is required of every message. Header fields contain values
used for routing and identifying messages.
Some header field values are set automatically by Message Queue during
the process of producing and delivering a message, some depend on settings
specified when message producers send a message, and others are set on a message-by-message
basis by the client using the MQSetMessageHeader function. Table 2–7 lists the header fields defined
(and required) by JMS and their corresponding names, as defined by the C-API.
Table 2–7 JMS-defined Message
Header
JMS Message Header Field
|
C-API Message Header Property Name
|
JMSDestination
|
Defined implicitly when a producer sends a message to a destination,
or when a consumer receives a message from a destination.
|
JMSDeliveryMode
|
MQ_PERSISTENT_HEADER_PROPERTY
|
JMSExpiration
|
MQ_EXPIRATION_HEADER_PROPERTY
|
JMSPriority
|
MQ_PRIORITY_HEADER_PROPERTY
|
JMSMessageID
|
MQ_MESSAGE_ID_HEADER_PROPERTY
|
JMSTimeStamp
|
MQ_TIMESTAMP_HEADER_PROPERTY
|
JMSRedelivered
|
MQ_REDELIVERED_HEADER_PROPERTY
|
JMSCorrelationID
|
MQ_CORRELATION_ID_HEADER_PROPERTY
|
JMSReplyTo
|
Set
by the MQSetMessageReplyTo function, and obtained by the MQGetMessageReplyTo function.
|
JMSPriority
|
MQ_MESSAGE_TYPE_HEADER_PROPERTY
|
For additional information about each property type and who sets it,
see MQSetMessageHeaders.