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 Vis 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 Vis 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 Vis 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 Vis 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 Vis 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.