+

Search Tips | Advanced Search

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 in the following environments:

        • AIX
        • IBM i
        • Linux
        • Windows
        • z/OS

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

    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.

Parent topic: Activity report reference

Last updated: 2020-10-04