Use the Queue Statistics attributes to create situations for detecting problems with individual queues. This attribute group provides queue statistics for each monitored queue within a queue manager. For example, you could create a situation to detect a put-inhibited queue or a queue that exceeds its high-depth threshold. Queue Statistics is a multiple-instance attribute group. You cannot mix these attributes with attributes of any other multiple-instance group.
# of Tran/Pgms (z/OS systems only) The number of unique CICS transactions or program names. This information is only available if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)). If Application Queue Statistics monitoring is not active, the values are 0. The valid format is an integer.
% Full The current number of messages on the queue (the current depth) divided by the maximum number of messages for the queue and expressed as a percentage. The valid format is a decimal (formatted to 1 decimal place) in the range 0.0 - 100.0.
Avg Appl Time Between Calls (z/OS systems only) The average elapsed time between MQI calls for any instances of the selected application ID, transaction, or program. This information is only available if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)). If Application Queue Statistics monitoring is not active, the values are 0. The value is expressed in seconds, accurate to the third decimal place. The valid format is a decimal (formatted to 3 decimal places).
Avg MQ Resp Time (z/OS systems only) The average time that it takes for WebSphere MQ to respond to all MQI calls. This information is only available if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)). If Application Queue Statistics monitoring is not active, the values are 0. The value is expressed in seconds, accurate to the third decimal place. The valid format is a decimal (formatted to 3 decimal places).
Buffer Pool ID (z/OS systems only) Indicates the buffer pool that this page set is assigned to. Valid values include 00, 01, 02, and 03.
CF Struct Name (QSG environment on z/OS systems only) The name of the Coupling Facility application structure for this queue. The valid format is an alphanumeric string of up to 12 uppercase characters.
Creation Date & Time The date and time that this WebSphere MQ object (for example, a channel or queue) is created. The valid format is the standard 16-character date/time format (CYYMMDDHHMMSSmmm), where the strings have the following meanings:
Cur Defn Whether the queue or channel is currently defined on the monitored queue manager. Valid values are No = 0 and Yes = 1.
Cur Opened Exclusive (z/OS systems only) Whether this queue currently is opened for exclusive use during the last data sample. Valid values are n/a = 0, Yes = 1, No = 2. This information is only available if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)). If Application Queue Statistics monitoring is not active, the values are 0.
Current Depth The number of messages currently on the queue. The valid format is an integer.
Definition Type The definition type for the queue. Valid values are as follows:
Get Status Indicates whether the current queue is enabled for gets (whether applications can call WebSphere MQ API routine MQGET for this queue). Valid values are Enabled = 0, Disabled = 1, n/a = -1.
High Depth Threshold The percentage of the maximum message depth of the current queue that triggers a Queue Depth High event for this queue. This attribute is expressed as an integer in the range 0 -100.
High Depth Threshold Percent The percentage of the maximum message depth of the current queue that triggers a Queue Depth High event for this queue. This attribute is expressed as a percentage value to one decimal place.
Highest Depth If Queue Statistics are collected (SET QUEUE STATISTICS(YES)), this is the highest number of messages in the queue during the sampling interval; otherwise, this value is 0. The valid format is an integer.
Host Name The name of the system on which this queue manager is running. On z/OS systems, this is the SMF ID. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Input Msg Size Avg (z/OS systems only) The average size of all input messages that belong to this queue, transaction, program, or application. This information is only available if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)). If Application Queue Statistics monitoring is not active, the values are 0. The valid format is an integer.
Initiation Queue Name The name of a local queue to which trigger messages are written. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Input Opens The number of applications that opened this queue for input. This does not include open requests for either inquiry or browse. The valid format is an integer.
Interval Time The size of the current sampling interval, expressed in hundredths of seconds. For example, .50 is half a second. This value is determined by the control parameters your site set when configuring the WebSphere MQ Monitoring agent; it is usually specified as 60.00 (60 seconds). The valid format is a decimal (formatted to 2 decimal places).
Last Put The date and time of the last sample interval in which a put is recorded. If Queue Statistics are collected (SET QUEUE STATISTICS(YES)), the Queue Statistics data is used; otherwise, if Application Queue Statistics are collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)), the Application Queue Statistics data is used. If neither type of monitoring is active, the value is 0. The valid format is the standard 16-character date/time format (CYYMMDDHHMMSSmmm), where the strings have the following meanings:
Last Read The date and time of the last sample interval in which a read is recorded. If Queue Statistics are being collected (SET QUEUE STATISTICS(YES)) then that data is used; otherwise, if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)) that data is used. If neither type of monitoring is active, the values are 0. The valid format is the standard 16-character date/time format (CYYMMDDHHMMSSmmm), where the strings have the following meanings:
Max Depth The maximum number of messages that are allowed on the queue. The valid format is an integer.
Msgs Browsed (z/OS systems only) The number of messages belonging to this queue, transaction, program, or application that are successfully browsed. This information is only available if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)). If Application Queue Statistics monitoring is not active, the values are 0. The valid format is an integer.
Msgs Put The number of messages that are put to the queue during the sampling interval. If Queue Statistics are being collected (SET QUEUE STATISTICS(YES)) then that data is used; otherwise, if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)) that data is used. If neither type of monitoring is active, the values are 0. The valid format is an integer.
Msgs Put per Sec The rate per second of messages that are put to the queue. If Queue Statistics are being collected (SET QUEUE STATISTICS(YES)) then that data is used; otherwise, if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)) that data is used. If neither type of monitoring is active, the values are 0. The valid format is an integer (formatted to one decimal place).
Msgs Read The number of messages that are read and removed from the queue during the sampling interval. If Queue Statistics are being collected (SET QUEUE STATISTICS(YES)) then that data is used; otherwise, if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)) that data is used. If neither type of monitoring is active, the values are 0. The valid format is an integer.
Msgs Read per Sec The rate per second of messages that are read from the queue. If Queue Statistics are being collected (SET QUEUE STATISTICS(YES)) then that data is used; otherwise, if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)) that data is used. If neither type of monitoring is active, the values are 0. The valid format is an integer (formatted to one decimal place).
Origin Node The WebSphere MQ Monitoring agent-assigned name of the node on which the data for the queue manager originates.
On z/OS systems, this name takes the form qmgr:smfid:MQESA, where qmgr is the name of the queue manager and smfid is the z/OS system or SMF ID.
On distributed systems, this name takes the form qmgr::MQ. If you used the SET AGENT command to set the host ID value, then this name takes the form qmgr:hostid:MQ. The valid format is an alphanumeric string of up to 128 case-sensitive characters.
Output Msg Size Avg (z/OS systems only) The average size of all output messages that belong to this queue, transaction, program, or application. This information is only available if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)). If Application Queue Statistics monitoring is not active, the values are 0. The valid format is an integer.
Output Opens The number of applications that opened this queue for output. The valid format is an integer.
Page Set ID (z/OS systems only) The page set identifier (a 2-digit integer of 00 - 99). Valid values include 00, 01, 02...98, 99.
Process Name The name of a process instance that identifies the application. Note that when writing a situation, a particular process name can sometimes be used to identify a group of critically important queues more easily than writing a separate situation for each queue name. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Put Status Indicates whether the current queue is enabled for puts (that is, whether applications can call WebSphere MQ API routines MQPUT or MQPUT1 for this queue). Valid values are Enabled = 0, Disabled = 1, and n/a = -1.
QMgr Name The name that is assigned to this queue manager. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
QSG Disp (QSG environment on z/OS systems only) The disposition of this queue sharing group. Valid values are as follows:
QSG Name (QSG environment on z/OS systems only) The name of the queue sharing group. The valid format is an alphanumeric string of up to 4 case-sensitive characters.
Queue Description A description of the queue. This can be useful when using situations, because you can use the description field to implement a scheme for classifying queues into groups. In this way you can create a situation that is only triggered by queues belonging to a particular group, avoiding the necessity of creating a separate situation for each individual queue, as you would need to if the queue name attribute were used instead.
For example, if you have queues with descriptions of Type 1 and Type 2, you can create situations with the following formulas to trigger events based on the same attribute (Current_Depth) under different circumstances depending on the description field, as follows:
IF Queue_Description = "Type1" AND Current_Depth >99 THEN [situation event occurs]
IF Queue_Description = "Type2" AND Current_Depth >1000 THEN [situation event occurs] Queue Name The name of a queue that is managed by the selected queue manager. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Queue Type Type of the queue. Valid values are Local = 1 and Alias = 3.
Queue Usage The queue usage, either Normal, XmitQ (for a transmission queue), or n/a. Valid values are Normal = 0, XmitQ = 1, n/a = -1.
Ret Intvl Exceeded Whether the retention interval (that is, the number of hours this queue must be retained after its creation) is exceeded. If yes, this queue is eligible for deletion. Valid values are No = 0, Yes = 1, and n/a = -1.
Storage Class (z/OS system local queues only) The name of the WebSphere MQ storage class this queue is assigned to. The valid format is an alphanumeric string of up to 8 case-sensitive characters.
| Value | Description |
|---|---|
Equal_Put_Get_Rates = -1 |
The rate of both puts and gets is equal. |
Zero_Put_Get_Rates = -2 |
The rate of puts and gets is zero. |
Sufficient_Get_Rate = -3 |
The rate of gets is greater than puts. |
n/a = -4 |
Only occurs if the sample interval length is 0. |
If Queue Statistics are being collected (SET QUEUE STATISTICS(YES)) then that data is used; otherwise, if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)) that data is used. If neither type of monitoring is active, the values are 0. The valid format is an integer (formatted to 2 decimal places).
Time to Zero Msgs (Secs) The amount of time, in seconds, that it takes for the queue to have no messages given the current depth, messages read per second, and messages put per second. If this value cannot be calculated with the current rates, the following values might be set:
| Value | Description |
|---|---|
Equal_Put_Get_Rates = -1 |
The rate of both puts and gets is equal. |
Zero_Put_Get_Rates = -2 |
The rate of puts and gets is zero. |
Deficient_Get_Rate = -3 |
The rate of gets is less than puts. |
n/a = -4 |
Only occurs if the sample interval length is 0. |
If Queue Statistics are being collected (SET QUEUE STATISTICS(YES)) then that data is used; otherwise, if Application Queue Statistics are being collected on z/OS systems (SET APPLICATION STATISTICS(ALL|NODYNAMQ)) that data is used. If neither type of monitoring is active, the values are 0. The valid format is an integer (formatted to 2 decimal places).
Total Opens The total number of applications that have opened this queue for either input or output. This does not include open requests for either inquiry or browse. The valid format is an integer.
Trigger Control Whether trigger messages are enabled for this queue. Valid values are No = 0, Yes = 1, n/a = -1.
Trigger Depth For trigger type Depth, the number of messages that trigger a message to the initiation queue. The valid format is an integer.
Trigger Priority For trigger types First and Every, the message priority that triggers a message to the initiation queue. The valid format is an integer in the range 0 - 9.
Trigger Type The condition (First, Every, Depth, or None) that causes a trigger message to be sent to the initiation queue. Valid values are as follows: