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.. |