data types, detailed description, structures" /> Activity report MQMD (message descriptor)

 

Activity report MQMD (message descriptor)

For an activity report, the MQMD structure contains these values:

StrucId

Description: Structure identifier.
Datatype: MQCHAR4.
Value: MQMD_STRUC_ID.

Version

Description: Structure version number.
Datatype: 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, Compaq NonStop Kernel, HP OpenVMS, i5/OS, Solaris, Linux, Windows, and all WebSphere MQ clients connected to these systems.

Report

Description: Options for further report messages.
Datatype: 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

Description: Indicates type of message.
Datatype: MQLONG.
Value: MQMT_REPORT.

Expiry

Description: Report message lifetime.
Datatype: 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.
Datatype: MQLONG.
Value:

MQFB_ACTIVITY

Activity report.

Encoding

Description: Numeric encoding of report message data.
Datatype: MQLONG.
Value: MQENC_NATIVE.

CodedCharSetId

Description: Character set identifier of report message data.
Datatype: MQLONG.
Value: Set as appropriate.

Format

Description: Format name of report message data
Datatype: MQCHAR8.
Value:

MQFMT_EMBEDDED_PCF

Embedded PCF message.

Priority

Description: Report message priority.
Datatype: MQLONG.
Value: Copied from the original message descriptor.

Persistence

Description: Report message persistence.
Datatype: MQLONG.
Value: Copied from the original message descriptor.

MsgId

Description: Message identifier.
Datatype: 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.
Datatype: 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.
Datatype: MQLONG.
Value: 0.

ReplyToQ

Description: Name of reply queue.
Datatype: MQCHAR48.
Values: Blank.

ReplyToQMgr

Description: Name of reply queue manager.
Datatype: MQCHAR48.
Value: The queue manager name that generated the report message.

UserIdentifier

Description: The user identifier of the application that generated the report message.
Datatype: 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.
Datatype: MQBYTE32.
Value: Copied from the original message descriptor.

ApplIdentityData

Description: Application data relating to identity.
Datatype: MQCHAR32.
Values: Copied from the original message descriptor.

PutApplType

Description: Type of application that put the report message.
Datatype: MQLONG.
Value:

MQAT_QMGR

Queue manager generated message.

PutApplName

Description: Name of application that put the report message.
Datatype: 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.
Datatype: MQCHAR8.
Value: As generated by the queue manager.

PutTime

Description: Time when message was put.
Datatype: MQCHAR8.
Value: As generated by the queue manager.

ApplOriginData

Description: Application data relating to origin.
Datatype: MQCHAR4.
Value: Blank.

If Vis MQMD_VERSION_2, the following additional fields are present:

GroupId

Description: Identifies to which message group or logical message the physical message belongs.
Datatype: MQBYTE24.
Value: Copied from the original message descriptor.

MsgSeqNumber

Description: Sequence number of logical message within group.
Datatype: MQLONG.
Value: Copied from the original message descriptor.

Offset

Description: Offset of data in physical message from start of logical message.
Datatype: MQLONG.
Value: Copied from the original message descriptor.

MsgFlags

Description: Message flags that specify attributes of the message or control its processing.
Datatype: MQLONG.
Value: Copied from the original message descriptor.

OriginalLength

Description: Length of original message.
Datatype: MQLONG.
Value: Copied from the original message descriptor.