Trace-route message MQMD (message descriptor)

The MQMD structure describes the information that accompanies the message data of a trace-route message. For a full description of MQMD, including a description of the elementary datatype of each parameter, see the WebSphere MQ Application Programming Reference manual.

For a trace-route message, the MQMD structure contains these values:

StrucId
Description: Structure identifier.
Datatype: MQCHAR4.
Value: MQMD_STRUC_ID.
Version
Description: Structure version number.
Datatype: MQLONG.
Values:
MQMD_VERSION_1.
Report
Description: Options for report messages.
Datatype: MQLONG.
Value: Set according to requirements. Common report options follow:
MQRO_DISCARD_MSG
The message is discarded on arrival to a local queue.
MQRO_PASS_DISCARD_AND_EXPIRY
Every response (activity reports or trace-route reply message) will have the report option MQRO_DISCARD_MSG set, and the remaining expiry passed on. This ensures that responses do not remain in the queue manager network indefinitely.
MsgType
Description: Type of message.
Datatype: MQLONG.
Value: If the Accumulate parameter in the TraceRoute group is specified as MQROUTE_ACCUMULATE_AND_REPLY, then message type is MQMT_REQUEST

Otherwise:

MQMT_DATAGRAM.
Expiry
Description: Message lifetime.
Datatype: MQLONG.
Value: Set according to requirements. This parameter can be used to ensure trace-route messages are not left in a queue manager network indefinitely.
Feedback
Description: Feedback or reason code.
Datatype: MQLONG.
Value:
MQFB_NONE.
Encoding
Description: Numeric encoding of message data.
Datatype: MQLONG.
Value: Set as appropriate.
CodedCharSetId
Description: Character set identifier of message data.
Datatype: MQLONG.
Value: Set as appropriate.
Format
Description: Format name of message data
Datatype: MQCHAR8.
Value:
MQFMT_ADMIN
Admin message. No user data follows the TraceRoute PCF group.
MQFMT_EMBEDDED_PCF
Embedded PCF message. User data follows the TraceRoute PCF group.
Priority
Description: Message priority.
Datatype: MQLONG.
Value: Set according to requirements.
Persistence
Description: Message persistence.
Datatype: MQLONG.
Value: Set according to requirements.
MsgId
Description: Message identifier.
Datatype: MQBYTE24.
Value: Set according to requirements.
CorrelId
Description: Correlation identifier.
Datatype: MQBYTE24.
Value: Set according to requirements.
BackoutCount
Description: Backout counter.
Datatype: MQLONG.
Value: 0.
ReplyToQ
Description: Name of reply queue.
Datatype: MQCHAR48.
Values: Set according to requirements.

If MsgType is set to MQMT_REQUEST or if Report has any report generating options set, then this parameter must be non-blank.

ReplyToQMgr
Description: Name of reply queue manager.
Datatype: MQCHAR48.
Value: Set according to requirements.
UserIdentifier
Description: The user identifier of the application that originated the message.
Datatype: MQCHAR12.
Value: Set as normal.
AccountingToken
Description: Accounting token that allows an application to charge for work done as a result of the message.
Datatype: MQBYTE32.
Value: Set as normal.
ApplIdentityData
Description: Application data relating to identity.
Datatype: MQCHAR32.
Values: Set as normal.
PutApplType
Description: Type of application that put the message.
Datatype: MQLONG.
Value: Set as normal.
PutApplName
Description: Name of application that put the message.
Datatype: MQCHAR28.
Value: Set as normal.
PutDate
Description: Date when message was put.
Datatype: MQCHAR8.
Value: Set as normal.
PutTime
Description: Time when message was put.
Datatype: MQCHAR8.
Value: Set as normal.
ApplOriginData
Description: Application data relating to origin.
Datatype: MQCHAR4.
Value: Set as normal..