Activity report message data

Activity report message data consists of the Activity PCF group, and if generated for a trace-route message, the TraceRoute PCF group. The Activity PCF group is detailed below. For details of the TraceRoute PCF group, see Trace-route message data.

There are certain parameters that are only returned when specific operations have been performed. For details of these parameters, see Operation-specific activity report message data.

For an activity report, the activity report message data contains the following parameters:

Activity
Description: Grouped parameters describing the activity.
Identifier: MQGACF_ACTIVITY.
Datatype: MQCFGR.
Included in PCF group: None.
Parameters in PCF group:
  • ActivityApplName
  • ActivityApplType
  • ActivityDescription
  • Operation
  • TraceRoute
Returned: Always.
ActivityApplName
Description: Name of application that performed the activity.
Identifier: MQCACF_APPL_NAME.
Datatype: MQCFST.
Included in PCF group: Activity.
Maximum length: MQ_APPL_NAME_LENGTH.
Returned: Always.
ActivityApplType
Description: Type of application that performed the activity.
Identifier: MQIA_APPL_TYPE.
Datatype: MQCFIN.
Included in PCF group: Activity.
Returned: Always.
ActivityDescription
Description: Description of activity performed by the application.
Identifier: MQCACF_ACTIVITY_DESCRIPTION.
Datatype: MQCFST.
Included in PCF group: Activity.
Maximum length: 64
Returned: Always.
Operation
Description: Grouped parameters describing an operation of the activity.
Identifier: MQGACF_OPERATION.
Datatype: MQCFGR.
Included in PCF group: Activity.
Parameters in PCF group:
  • OperationType
  • OperationDate
  • OperationTime
  • Message
  • QMgrName
  • QSGName
Note:
Additional parameters are returned in this group depending on the operation type. For information on the additional parameters, see Operation-specific activity report message data.
Returned: One Operation PCF group per operation in the activity.
OperationType
Description: Type of operation performed.
Identifier: MQIACF_OPERATION_TYPE.
Datatype: MQCFIN.
Included in PCF group: Operation.
Values: MQOPER_*.
Returned: Always.
OperationDate
Description: Date when the operation was performed.
Identifier: MQCACF_OPERATION_DATE.
Datatype: MQCFST.
Included in PCF group: Operation.
Maximum length: MQ_DATE_LENGTH.
Returned: Always.
OperationTime
Description: Time when the operation was performed.
Identifier: MQCACF_OPERATION_TIME.
Datatype: MQCFST.
Included in PCF group: Operation.
Maximum length: MQ_TIME_LENGTH.
Returned: Always.
Message
Description: Grouped parameters describing the message that caused the activity.
Identifier: MQGACF_MESSAGE.
Datatype: MQCFGR.
Included in PCF group: Operation.
Parameters in group:
  • MsgLength
  • MQMD
  • EmbeddedMQMD
Returned: Always.
MsgLength
Description: Length of the message that caused the activity, before the activity occurred.
Identifier: MQIACF_MSG_LENGTH.
Datatype: MQCFIN.
Included in PCF group: Message.
Returned: Always.
MQMD
Description Grouped parameters related to the message descriptor of the message that caused the activity.
Identifier: MQGACF_MQMD.
Datatype: MQCFGR.
Included in PCF group: Message.
Parameters in group:
  • StrucId
  • Version
  • Report
  • MsgType
  • Expiry
  • Feedback
  • Encoding
  • CodedCharSetId
  • Format
  • Priority
  • Persistence
  • MsgId
  • CorrelId
  • BackoutCount
  • ReplyToQ
  • ReplyToQMgr
  • UserIdentifier
  • AccountingToken
  • ApplIdentityData
  • PutApplType
  • PutApplName
  • PutDate
  • PutTime
  • ApplOriginData
  • GroupId
  • MsgSeqNumber
  • Offset
  • MsgFlags
  • OriginalLength
Returned: Always.
EmbeddedMQMD
Description: Grouped parameters describing the message descriptor embedded within a message on a transmission queue.
Identifier: MQGACF_EMBEDDDED_MQMD.
Datatype: MQCFGR.
Included in PCF group: Message.
Parameters in group:
  • StrucId
  • Version
  • Report
  • MsgType
  • Expiry
  • Feedback
  • Encoding
  • CodedCharSetId
  • Format
  • Priority
  • Persistence
  • MsgId
  • CorrelId
  • BackoutCount
  • ReplyToQ
  • ReplyToQMgr
  • UserIdentifier
  • AccountingToken
  • ApplIdentityData
  • PutApplType
  • PutApplName
  • PutDate
  • PutTime
  • ApplOriginData
  • GroupId
  • MsgSeqNumber
  • Offset
  • MsgFlags
  • OriginalLength
Returned: For Get operations where the queue resolves to a transmission queue.
StrucId
Description: Structure identifier
Identifier: MQCACF_STRUC_ID.
Datatype: MQCFST.
Included in PCF group: MQMD or EmbeddedMQMD.
Maximum length: 4.
Returned: Always.
Version
Description: Structure version number.
Identifier: MQIACF_VERSION.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: Always.
Report
Description: Options for report messages.
Identifier: MQIACF_REPORT.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: Always.
MsgType
Description: Indicates type of message.
Identifier: MQIACF_MSG_TYPE.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: Always.
Expiry
Description: Message lifetime.
Identifier: MQIACF_EXPIRY.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: Always.
Feedback
Description: Feedback or reason code.
Identifier: MQIACF_FEEDBACK.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: Always.
Encoding
Description: Numeric encoding of message data.
Identifier: MQIACF_ENCODING.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: Always.
CodedCharSetId
Description: Character set identifier of message data.
Identifier: MQIA_CODED_CHAR_SET_ID.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: Always.
Format
Description: Format name of message data
Identifier: MQCACH_FORMAT_NAME.
Datatype: MQCFST.
Included in PCF group: MQMD or EmbeddedMQMD.
Maximum length: MQ_FORMAT_LENGTH.
Returned: Always.
Priority
Description: Message priority.
Identifier: MQIACF_PRIORITY.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: Always.
Persistence
Description: Message persistence.
Identifier: MQIACF_PERSISTENCE.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: Always.
MsgId
Description: Message identifier.
Identifier: MQBACF_MSG_ID.
Datatype: MQCFBS.
Included in PCF group: MQMD or EmbeddedMQMD.
Maximum length: MQ_MSG_ID_LENGTH.
Returned: Always.
CorrelId
Description: Correlation identifier.
Identifier: MQBACF_CORREL_ID.
Datatype: MQCFBS.
Included in PCF group: MQMD or EmbeddedMQMD.
Maximum length: MQ_CORREL_ID_LENGTH.
Returned: Always.
BackoutCount
Description: Backout counter.
Identifier: MQIACF_BACKOUT_COUNT.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: Always.
ReplyToQ
Description: Name of reply queue.
Identifier: MQCACF_REPLY_TO_QUEUE.
Datatype: MQCFST.
Included in PCF group: MQMD or EmbeddedMQMD.
Maximum length: MQ_Q_NAME_LENGTH.
Returned: Always.
ReplyToQMgr
Description: Name of reply queue manager.
Identifier: MQCACF_REPLY_TO_Q_MGR.
Datatype: MQCFST.
Included in PCF group: MQMD or EmbeddedMQMD.
Maximum length: MQ_Q_MGR_NAME_LENGTH.
Returned: Always.
UserIdentifier
Description: The user identifier of the application that originated the message.
Identifier: MQCACF_USER_IDENTIFIER.
Datatype: MQCFST.
Included in PCF group: MQMD or EmbeddedMQMD.
Maximum length: MQ_USER_ID_LENGTH.
Returned: Always.
AccountingToken
Description: Accounting token that allows an application to charge for work done as a result of the message.
Identifier: MQBACF_ACCOUNTING_TOKEN.
Datatype: MQCFBS.
Included in PCF group: MQMD or EmbeddedMQMD.
Maximum length: MQ_ACCOUNTING_TOKEN_LENGTH.
Returned: Always.
ApplIdentityData
Description: Application data relating to identity.
Identifier: MQCACF_APPL_IDENTITY_DATA.
Datatype: MQCFST.
Included in PCF group: MQMD or EmbeddedMQMD.
Maximum length: MQ_APPL_IDENTITY_DATA_LENGTH.
Returned: Always.
PutApplType
Description: Type of application that put the message.
Identifier: MQIA_APPL_TYPE.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: Always.
PutApplName
Description: Name of application that put the message.
Identifier: MQCACF_APPL_NAME.
Datatype: MQCFST.
Included in PCF group: MQMD or EmbeddedMQMD.
Maximum length: MQ_APPL_NAME_LENGTH.
Returned: Always.
PutDate
Description: Date when message was put.
Identifier: MQCACF_PUT_DATE.
Datatype: MQCFST.
Included in PCF group: MQMD or EmbeddedMQMD.
Maximum length: MQ_PUT_DATE_LENGTH.
Returned: Always.
PutTime
Description: Time when message was put.
Identifier: MQCACF_PUT_TIME.
Datatype: MQCFST.
Included in PCF group: MQMD or EmbeddedMQMD.
Maximum length: MQ_PUT_TIME_LENGTH.
Returned: Always.
ApplOriginData
Description: Application data relating to origin.
Identifier: MQCACF_APPL_ORIGIN_DATA.
Datatype: MQCFST.
Included in PCF group: MQMD or EmbeddedMQMD.
Maximum length: MQ_APPL_ORIGIN_DATA_LENGTH.
Returned: Always.
GroupId
Description: Identifies to which message group or logical message the physical message belongs.
Identifier: MQBACF_GROUP_ID.
Datatype: MQCFBS.
Included in PCF group: MQMD or EmbeddedMQMD.
Maximum length: MQ_GROUP_ID_LENGTH.
Returned: If the Version is specified as MQMD_VERSION_2.
MsgSeqNumber
Description: Sequence number of logical message within group.
Identifier: MQIACH_MSG_SEQUENCE_NUMBER.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: If Version is specified as MQMD_VERSION_2.
Offset
Description: Offset of data in physical message from start of logical message.
Identifier: MQIACF_OFFSET.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: If Version is specified as MQMD_VERSION_2.
MsgFlags
Description: Message flags that specify attributes of the message or control its processing.
Identifier: MQIACF_MSG_FLAGS.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: If Version is specified as MQMD_VERSION_2.
OriginalLength
Description: Length of original message.
Identifier: MQIACF_ORIGINAL_LENGTH.
Datatype: MQCFIN.
Included in PCF group: MQMD or EmbeddedMQMD.
Returned: If Version is specified as MQMD_VERSION_2.
QMgrName
Description: Name of the queue manager where the activity was performed.
Identifier: MQCA_Q_MGR_NAME.
Datatype: MQCFST.
Included in PCF group: Operation.
Maximum length: MQ_Q_MGR_NAME_LENGTH
Returned: Always.
QSGName
Description: Name of the queue-sharing group to which the queue manager where the activity was performed belongs.
Identifier: MQCA_QSG_NAME.
Datatype: MQCFST.
Included in PCF group: Operation.
Maximum length: MQ_QSG_NAME_LENGTH
Returned: If the activity was performed on a WebSphere MQ for z/OS queue manager.
TraceRoute
Description: Grouped parameters specifying attributes of the trace-route message.
Identifier: MQGACF_TRACE_ROUTE.
Datatype: MQCFGR.
Contained in PCF group: Activity.
Parameters in group:
  • Detail
  • RecordedActivities
  • UnrecordedActivities
  • DiscontinuityCount
  • MaxActivities
  • Accumulate
  • Forward
  • Deliver
For details of these parameter structures, see Trace-route message data.
Returned: If the activity was performed on behalf of the trace-route message.

The values of the parameters in the TraceRoute PCF group are those from the trace-route message at the time the activity report was generated. For details of the TraceRoute PCF group, see The TraceRoute PCF group.