Activity report MQMD (message descriptor)

Use this page to view the values contained by the MQMD structure for an activity report

StrucId

Structure identifier:

Data type: MQCHAR4
Value: MQMD_STRUC_ID.

Version

Structure version number

Data type

MQLONG

Values

Copied from the original message descriptor. Possible values are:

MQMD_VERSION_1: Version-1 message descriptor structure, supported in all environments.
MQMD_VERSION_2: Version-2 message descriptor structure, supported on AIX®, HP-UX, z/OS®, IBM® i, Solaris, Linux®, Windows, and all IBM MQ MQI clients connected to these systems.

Report

Options for further report messages

Data type

MQLONG

Value

If MQRO_PASS_DISCARD_AND_EXPIRY or MQRO_DISCARD_MSG were specified in the Report field of the original message descriptor:

MQRO_DISCARD: The report is discarded if it cannot be delivered to the destination queue.

Otherwise:

MQRO_NONE: No reports required.

MsgType

Indicates type of message

Data type: MQLONG
Value: MQMT_REPORT

Expiry

Report message lifetime

Data type

MQLONG

Value

If the Report field in the original message descriptor is specified as MQRO_PASS_DISCARD_AND_EXPIRY, the remaining expiry time from the original message is used.

Otherwise:

MQEI_UNLIMITED: The report does not have an expiry time.

Feedback

Description:

Feedback or reason code.

Data type:

MQLONG.

Value:

MQFB_ACTIVITY: Activity report.

Encoding

Description:

Numeric encoding of report message data.

Data type:

MQLONG.

Value:

MQENC_NATIVE.

CodedCharSetId

Description:

Character set identifier of report message data.

Data type:

MQLONG.

Value:

Set as appropriate.

Format

Description:

Format name of report message data

Data type:

MQCHAR8.

Value:

MQFMT_EMBEDDED_PCF: Embedded PCF message.

Priority

Description:

Report message priority.

Data type:

MQLONG.

Value:

Copied from the original message descriptor.

Persistence

Description:

Report message persistence.

Data type:

MQLONG.

Value:

Copied from the original message descriptor.

MsgId

Description:

Message identifier.

Data type:

MQBYTE24.

Values:

If the Report field in the original message descriptor is specified as MQRO_PASS_MSG_ID, the message identifier from the original message is used.

Otherwise, a unique value will be generated by the queue manager.

CorrelId

Description:

Correlation identifier.

Data type:

MQBYTE24.

Value:

If the Report field in the original message descriptor is specified as MQRO_PASS_CORREL_ID, the correlation identifier from the original message is used.

Otherwise, the message identifier is copied from the original message.

BackoutCount

Description:

Backout counter.

Data type:

MQLONG.

Value:

ReplyToQ

Description:

Name of reply queue.

Data type:

MQCHAR48.

Values:

Blank.

ReplyToQMgr

Description:

Name of reply queue manager.

Data type:

MQCHAR48.

Value:

The queue manager name that generated the report message.

UserIdentifier

Description:

The user identifier of the application that generated the report message.

Data type:

MQCHAR12.

Value:

Copied from the original message descriptor.

AccountingToken

Description:

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

Data type:

MQBYTE32.

Value:

Copied from the original message descriptor.

ApplIdentityData

Description:

Application data relating to identity.

Data type:

MQCHAR32.

Values:

Copied from the original message descriptor.

PutApplType

Description:

Type of application that put the report message.

Data type:

MQLONG.

Value:

MQAT_QMGR: Queue manager generated message.

PutApplName

Description:

Name of application that put the report message.

Data type:

MQCHAR28.

Value:

Either the first 28 bytes of the queue manager name, or the name of the MCA that generated the report message.

PutDate

Description:

Date when message was put.

Data type:

MQCHAR8.

Value:

As generated by the queue manager.

PutTime

Description:

Time when message was put.

Data type:

MQCHAR8.

Value:

As generated by the queue manager.

ApplOriginData

Description:

Application data relating to origin.

Data type:

MQCHAR4.

Value:

Blank.

If Version is MQMD_VERSION_2, the following additional fields are present:

GroupId

Description:

Identifies to which message group or logical message the physical message belongs.

Data type:

MQBYTE24.

Value:

Copied from the original message descriptor.

MsgSeqNumber

Description:

Sequence number of logical message within group.

Data type:

MQLONG.

Value:

Copied from the original message descriptor.

Offset

Description:

Offset of data in physical message from start of logical message.

Data type:

MQLONG.

Value:

Copied from the original message descriptor.

MsgFlags

Description:

Message flags that specify attributes of the message or control its processing.

Data type:

MQLONG.

Value:

Copied from the original message descriptor.

OriginalLength

Description:

Length of original message.

Data type:

MQLONG.

Value:

Copied from the original message descriptor.