Queue statistics message data

Use this page to view the structure of a queue statistics message

Message name:

Queue statistics message.

Platforms:

All, except IBM® MQ for z/OS®.

System queue:

SYSTEM.ADMIN.STATISTICS.QUEUE.

QueueManager

Description:

Name of the queue manager

Identifier:

MQCA_Q_MGR_NAME

Data type:

MQCFST

Maximum length:

MQ_Q_MGR_NAME_LENGTH

Returned:

Always

IntervalStartDate

Description:

The date at the start of the monitoring period

Identifier:

MQCAMO_START_DATE

Data type:

MQCFST

Maximum length:

MQ_DATE_LENGTH

Returned:

Always

IntervalStartTime

Description:

The time at the start of the monitoring period

Identifier:

MQCAMO_START_TIME

Data type:

MQCFST

Maximum length:

MQ_TIME_LENGTH

Returned:

Always

IntervalEndDate

Description:

The date at the end of the monitoring period

Identifier:

MQCAMO_END_DATE

Data type:

MQCFST

Maximum length:

MQ_DATE_LENGTH

Returned:

Always

IntervalEndTime

Description:

The time at the end of the monitoring period

Identifier:

MQCAMO_END_TIME

Data type:

MQCFST

Maximum length:

MQ_TIME_LENGTH

Returned:

Always

CommandLevel

Description:

The queue manager command level

Identifier:

MQIA_COMMAND_LEVEL

Data type:

MQCFIN

Returned:

Always

ObjectCount

Description:

The number of queue objects accessed in the interval for which statistics data has been recorded. This value is set to the number of QStatisticsData PCF groups contained in the message.

Identifier:

MQIAMO_OBJECT_COUNT

Data type:

MQCFIN

Returned:

Always

QStatisticsData

Description: Grouped parameters specifying statistics details for a queue

Identifier: MQGACF_Q_STATISTICS_DATA

Data type: MQCFGR

Parameters in group:

QName
CreateDate
CreateTime
QType
QDefinitionType
QMinDepth
QMaxDepth
AvgTimeOnQ
PutCount
PutFailCount
Put1Count
Put1FailCount
PutBytes
GetCount
GetFailCount
GetBytes
BrowseCount
BrowseFailCount
BrowseBytes
NonQueuedMsgCount
ExpiredMsgCount
PurgeCount

Returned: Always

QName

Description:

The name of the queue

Identifier:

MQCA_Q_NAME

Data type:

MQCFST

Maximum length:

MQ_Q_NAME_LENGTH

Returned:

Always

CreateDate

Description:

The date when the queue was created

Identifier:

MQCA_CREATION_DATE

Data type:

MQCFST

Maximum length:

MQ_DATE_LENGTH

Returned:

Always

CreateTime

Description:

The time when the queue was created

Identifier:

MQCA_CREATION_TIME

Data type:

MQCFST

Maximum length:

MQ_TIME_LENGTH

Returned:

Always

QType

Description:

The type of the queue

Identifier:

MQIA_Q_TYPE

Data type:

MQCFIN

Value:

MQOT_LOCAL

Returned:

Always

QDefinitionType

Description:

The queue definition type

Identifier:

MQIA_DEFINITION_TYPE

Data type:

MQCFIN

Values:

Possible values are

MQQDT_PREDEFINED
MQQDT_PERMANENT_DYNAMIC
MQQDT_TEMPORARY_DYNAMIC

Returned:

When available

QMinDepth

Description:

The minimum queue depth during the monitoring period

Identifier:

MQIAMO_Q_MIN_DEPTH

Data type:

MQCFIN

Included in PCF group:

QStatisticsData

Returned:

When available

QMaxDepth

Description:

The maximum queue depth during the monitoring period

Identifier:

MQIAMO_Q_MAX_DEPTH

Data type:

MQCFIN

Included in PCF group:

QStatisticsData

Returned:

When available

AvgTimeOnQ

Description:

The average latency, in microseconds, of messages destructively retrieved from the queue during the monitoring period. This parameter is an integer list indexed by persistence value, see Reference note 2.

Identifier:

MQIAMO64_AVG_Q_TIME

Data type:

MQCFIL64

Included in PCF group:

QStatisticsData

Returned:

When available

PutCount

Description:

The number of persistent and nonpersistent messages successfully put to the queue, with exception of MQPUT1 requests. This parameter is an integer list indexed by persistence value. See Reference note 2.

Identifier:

MQIAMO_PUTS

Data type:

MQCFIL

Included in PCF group:

QStatisticsData

Returned:

When available

PutFailCount

Description:

The number of unsuccessful attempts to put a message to the queue

Identifier:

MQIAMO_PUTS_FAILED

Data type:

MQCFIN

Included in PCF group:

QStatisticsData

Returned:

When available

Put1Count

Description:

The number of persistent and nonpersistent messages successfully put to the queue using MQPUT1 calls. This parameter is an integer list indexed by persistence value. See Reference note 2.

Identifier:

MQIAMO_PUT1S

Data type:

MQCFIL

Included in PCF group:

QStatisticsData

Returned:

When available

Put1FailCount

Description:

The number of unsuccessful attempts to put a message using MQPUT1 calls

Identifier:

MQIAMO_PUT1S_FAILED

Data type:

MQCFIN

Included in PCF group:

QStatisticsData

Returned:

When available

PutBytes

Description:

The number of bytes written in put requests to the queue

Identifier:

MQIAMO64_PUT_BYTES

Data type:

MQCFIL64

Included in PCF group:

QStatisticsData

Returned:

When available

GetCount

Description:

The number of successful destructive get requests for persistent and nonpersistent messages. This parameter is an integer list indexed by persistence value. See Reference note 2.

Identifier:

MQIAMO_GETS

Data type:

MQCFIL

Included in PCF group:

QStatisticsData

Returned:

When available

GetFailCount

Description:

The number of unsuccessful destructive get requests

Identifier:

MQIAMO_GETS_FAILED

Data type:

MQCFIN

Included in PCF group:

QStatisticsData

Returned:

When available

GetBytes

Description:

The number of bytes read in destructive put requests for persistent and nonpersistent messages. This parameter is an integer list indexed by persistence value. See Reference note 2.

Identifier:

MQIAMO64_GET_BYTES

Data type:

MQCFIL64

Included in PCF group:

QStatisticsData

Returned:

When available

BrowseCount

Description:

The number of successful non-destructive get requests for persistent and nonpersistent messages. This parameter is an integer list indexed by persistence value. See Reference note 2.

Identifier:

MQIAMO_BROWSES

Data type:

MQCFIL

Included in PCF group:

QStatisticsData

Returned:

When available

BrowseFailCount

Description:

The number of unsuccessful non-destructive get requests

Identifier:

MQIAMO_BROWSES_FAILED

Data type:

MQCFIN

Included in PCF group:

QStatisticsData

Returned:

When available

BrowseBytes

Description:

The number of bytes read in non-destructive get requests for persistent and nonpersistent messages. This parameter is an integer list indexed by persistence value. See Reference note 2.

Identifier:

MQIAMO64_BROWSE_BYTES

Data type:

MQCFIL64

Included in PCF group:

QStatisticsData

Returned:

When available

NonQueuedMsgCount

Description:

The number of messages that bypassed the queue and were transferred directly to a waiting application.

Bypassing a queue can only occur in certain circumstances. This number represents how many times IBM MQ was able to bypass the queue, and not the number of times an application was waiting.

Identifier:

MQIAMO_MSGS_NOT_QUEUED

Data type:

MQCFIN

Included in PCF group:

QStatisticsData

Returned:

When available

ExpiredMsgCount

Description:

The number of persistent and nonpersistent messages that were discarded because they had expired before they could be retrieved.

Identifier:

MQIAMO_MSGS_EXPIRED

Data type:

MQCFIN

Included in PCF group:

QStatisticsData

Returned:

When available

PurgeCount

Description:

The number of messages purged.

Identifier:

MQIAMO_MSGS_PURGED

Data type:

MQCFIN

Included in PCF group:

QStatisticsData

Returned:

When available