WebSphere Message Brokers
File: aq07020_
Writer: Terry Cowling

Reference topic

This build: July 31, 2007 21:35:25

MQMD settings in command messages to the broker

Applications that send command messages to the broker use the following settings of fields in the message descriptor (MQMD). Fields that are left as the default value, or can be set to any valid value in the usual way, are not listed here.

Report
See MsgType and CorrelId (below).
MsgType
MsgType should be set to MQMT_REQUEST for a command message if a response is always required. The MQRO_PAN and MQRO_NAN flags in the Report field are not significant in this case.
If MsgType is set to MQMT_DATAGRAM, responses depend on the setting of the MQRO_PAN and MQRO_NAN flags in the Report field:
  • MQRO_PAN alone means that the broker sends a response only if the command succeeds.
  • MQRO_NAN alone means that the broker sends a response only if the command fails.
  • If a command completes with a warning, a response is sent if either MQRO_PAN or MQRO_NAN is set.
  • MQRO_PAN + MQRO_NAN means that the broker sends a response whether the command succeeds or fails. This has the same effect from the broker's perspective as setting MsgType to MQMT_REQUEST.
  • If neither MQRO_PAN nor MQRO_NAN is set, no response is ever sent.
Format
Set to MQFMT_RF_HEADER_2
MsgId
This field is normally set to MQMI_NONE, so that the queue manager generates a unique value.
CorrelId
This field can be set to any value. If the sender's identity includes a CorrelId, specify this value, together with MQRO_PASS_CORREL_ID in the Report field, to ensure that it is set in all response messages sent by the broker to the sender.
ReplyToQ
This field defines the queue to which responses, if any, are to be sent. This might be the sender's queue; this has the advantage that the QName parameter can be omitted from the message. If, however, responses are to be sent to a different queue, the QName parameter is needed.
ReplyToQMgr
This field defines the queue manager for responses. If you leave this field blank (the default value), the local queue manager puts its own name in this field.
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:35:25

aq07020_ This topic's URL is: