Queue Status attributes
Use the Queue Status attributes to view the most current status data about a specifically chosen queue; note the Queue Name attribute must be provided in queries to this attribute group. No data is returned if the IBM MQ (WebSphere MQ) version requirement is not met.
If there are certain queues to be monitored by situations for Queue Status, you should make a specific situation for each queue to be monitored and match the specific queue name with the Queue Name attribute as a condition in the situation. However, if you choose not to provide the queue name in the situation, only queues with a non-zero Current Depth value are considered for possible match with the situation conditions specified.
Current Depth The number of messages that are currently on the queue; this includes both committed and uncommitted messages. 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 Opens The number of handles that are currently open for input (either shared or exclusive), this does not include opens for browsing. The valid format is an integer.
Last Get Date & Time The date and time that the last message is destructively read from the queue. The valid format is the standard 16-character date/time format (CYYMMDDHHMMSSmmm), where the strings have the following meanings:
- C
- Century (0 for 20th, 1 for 21st)
- YY
- Year
- MM
- Month
- DD
- Day
- HH
- Hour
- MM
- Minute
- SS
- Second
- mmm
- Millisecond
Last Put Date & Time The date and time that the last message is successfully put to the queue. Standard 16-character date/time format (CYYMMDDHHMMSSmmm), where the strings have the following meanings:
- C
- Century (0 for 20th, 1 for 21st)
- YY
- Year
- MM
- Month
- DD
- Day
- HH
- Hour
- MM
- Minute
- SS
- Second
- mmm
- Millisecond
Long Term Queue Time The time that messages remain on queue in microseconds over a long period of time. The maximum displayable value is 999,999,999.
Media Recovery Log Extent The log extent or journal receiver needed for media recovery of the queue. On queue managers on which circular logging is in place, The media recovery log extent is returned as a null string. The valid format is an alphanumeric string of up to 24 case-sensitive characters. This attribute is valid on AIX, HP-UX, Linux, i5/OS, Solaris, and Windows systems.
Oldest Msg Age Age, in seconds, of the oldest message on the queue. The maximum displayable value is 999,999,999; if the age exceeds this value, 999,999,999 is displayed.
Origin Node The IBM 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 ID or SMF ID.
On distributed systems, this name takes the form qmgr::MQ. If the host ID value is specified by the SET AGENT command, this name takes the form qmgr:hostid:MQ. The valid format is an alphanumeric string of up to 128 case-sensitive characters.
Queue Monitoring The current level of monitoring data collection for the queue. Valid values are as follows:
- n/a = -1,
- Off = 0 ,
- On = 1,
- Low = 17,
- Medium = 33,
- High = 65
Output Opens The number of handles that are currently open for output. The valid format is an integer.
QSG Disp Indicates the disposition of the queue in a queue-sharing group environment. This attribute is for QSG environment on z/OS systems only. Valid values are as follows:
- Qmgr = 0
- Copy = 1
- Shared = 2
- Unknown = 255
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.
Queue Name The name of a queue that is managed by the selected queue manager. This attribute is required to be given in queries to this attribute group. The valid format is an alphanumeric string of up to 48 case-sensitive characters.
Short Term Queue Time The time that messages remain on queue in microseconds over a short period of time. The maximum displayable value is 999,999,999.
Uncommitted Msgs Whether there are any uncommitted messages on the queue. Valid values are No = 0 and Yes = 1.