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