Trace-route message MQMD (message descriptor)

Use this page to view the values contained by the MQMD structure for a trace-route message

StrucId

Description:

Structure identifier.

Data type:

MQCHAR4.

Value:

MQMD_STRUC_ID.

Version

Description:

Structure version number.

Data type:

MQLONG.

Values:

MQMD_VERSION_1.

Report

Description:

Options for report messages.

Data type:

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.

Data type:

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.

Data type:

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.

Data type:

MQLONG.

Value:

MQFB_NONE.

Encoding

Description:

Numeric encoding of message data.

Data type:

MQLONG.

Value:

Set as appropriate.

CodedCharSetId

Description:

Character set identifier of message data.

Data type:

MQLONG.

Value:

Set as appropriate.

Format

Description:

Format name of message data

Data type:

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.

Data type:

MQLONG.

Value:

Set according to requirements.

Persistence

Description:

Message persistence.

Data type:

MQLONG.

Value:

Set according to requirements.

MsgId

Description:

Message identifier.

Data type:

MQBYTE24.

Value:

Set according to requirements.

CorrelId

Description:

Correlation identifier.

Data type:

MQBYTE24.

Value:

Set according to requirements.

BackoutCount

Description:

Backout counter.

Data type:

MQLONG.

Value:

ReplyToQ

Description:

Name of reply queue.

Data type:

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.

Data type:

MQCHAR48.

Value:

Set according to requirements.

UserIdentifier

Description:

The user identifier of the application that originated the message.

Data type:

MQCHAR12.

Value:

Set as normal.

AccountingToken

Description:

Accounting token that allows an application to charge for work done as a result of the message.

Data type:

MQBYTE32.

Value:

Set as normal.

ApplIdentityData

Description:

Application data relating to identity.

Data type:

MQCHAR32.

Values:

Set as normal.

PutApplType

Description:

Type of application that put the message.

Data type:

MQLONG.

Value:

Set as normal.

PutApplName

Description:

Name of application that put the message.

Data type:

MQCHAR28.

Value:

Set as normal.

PutDate

Description:

Date when message was put.

Data type:

MQCHAR8.

Value:

Set as normal.

PutTime

Description:

Time when message was put.

Data type:

MQCHAR8.

Value:

Set as normal.

ApplOriginData

Description:

Application data relating to origin.

Data type:

MQCHAR4.

Value:

Set as normal..