Queue Status workspace
The Queue Status workspace contains information about the status of the selected open queue, including whether or not the queue has uncommitted messages, the current number of messages on the queue, and information regarding the handles that currently have the queue open.
You can use the SCAN and STR functions with the Queue Name column of the Queue Status attribute group. You can create workspaces based on queries that include only queues with names containing certain strings, such as those that include the word SYSTEM. In addition, you can use these functions to create a situation that can be triggered by the same subset of queues, instead of having to create a new situation for each queue that you want to be able to trigger the situation.
IF STR(Queue_Name) == 1, SYSTEM AND Current_Depth > 100 THEN [situation event occu
rs]
Because the performance overhead of these functions
is relatively high, when creating a query try to include additional
filtering thresholds to reduce the number of times these functions
are used. In particular, if you are creating your own query, you
can include a condition that includes only queues with a current depth
attribute of greater than zero, eliminating all queues that do not
currently contain messages. The default query already includes this
condition. If you want to create a new version of the queue status workspace containing only a filtered subset of the queues listed in the original, do not modify the original workspace and the queries on which it is based. Instead, create copies of both the workspace and query and modify the copies. The query must be copied because the original query is read-only and so cannot be modified. Predefined workspaces included with the IBM® MQ Monitoring agent must never be modified, because this will cause problems when upgrading to future versions.
For more information about using the SCAN and STR functions, see the Formula functions appendix in the Tivoli Enterprise Portal User's Guide.
There are no recent or historical versions of the Queue Status workspace.
Predefined views
The Queue Status workspace includes the following predefined views:
- Oldest Messaging Age This view shows, as a bar chart, the Age of oldest message in seconds of the queue.
- Number of Messages This view shows, as a bar chart, the current depth of the queue.
- Queue Status This view shows, as a single-row table, the
following general queue status data for the selected monitored queue:
- The queue name
- Whether the queue contains uncommitted messages
- The current depth of the queue
- The number of input opens performed during the last sampling interval
- The number of output opens performed during the last sampling interval
- Whether the queue is part of a queue-sharing group
This view contains data described in Queue Status attributes.
- Number of Opens This view shows, as a bar chart, the number of times the queue has been opened to perform input and output operations.
- Open Handles for Queue This view shows, as a table, detailed information about currently open queue handles. Multiple rows might be displayed depending on how many handles have been used to open the queue. This view contains data described in Queue Handle Status attributes.
Predefined links
- Queue Definitions
- Recent Queue Statistics
- Queue Parameters
- Real-time Queue Data
- Application Topology View (Application Connections Workspace) This link is visible only if the ACTCONN value is not equal to Not_Connected_to_QMgr.