MQ Visual Edit

This section will describe how to invoke and use the Queue Stats Monitor tool. The Queue Stats Monitor will continuously monitor the queues of a queue manager displaying the Queue Name, Put Rate (enqueue rate), Get Rate (dequeue rate), High Queue Depth and Max Queue Depth.

Features:
• User selectable refresh rate i.e. 60 or 30 or 10 seconds
• The user can de-select the displaying of the SYSTEM queues (i.e. SYSTEM.*)
• The displayed queue attributes are: Queue Name, Put Rate (Enqueue rate), Get Rate (Dequeue rate), High Queue Depth during the interval, and Max Queue Depth.
• The user can have multi windows open at the same time monitoring different queues of the same queue manager or monitoring of different queues of different queue managers at the same time.

Quick visual helpers:
• If the 'High Queue Depth' is between 70% to 84.99% (of max queue depth) then it is highlighted in 'yellow'.
• If the 'High Queue Depth' is 85% or higher (of max queue depth) then it is highlighted in 'red'.

Whatever you select for the Refresh Rate will be the interval that the Put & Get rates are measured by.
• The Put Rate is the number of MQPUTs in the given interval.
• The Get Rate is the number of MQGETs in the given interval.

Example: If the refresh rate is 60 seconds (interval) and during the interval the Put Rate was 15, hence, 15 messages were put to the queue in the last 60 seconds.

For z/OS queue managers, you MUST enable Queue Manager Performance Events (PERFMEV) to use the Queue Stats Monitor tool against a z/OS queue manager.

For the MQ Tools, you can have unlimited number of them running (up to what your box can support). Also, while any of the MQ Tools are running, the user can still use MQ Visual Edit.

From the main panel of MQ Visual Edit, select Tools, then Queue Stats Monitor.

This is the main panel of the Queue Stats Monitor. Click the Start button to choose the queue manager and options.

This is the 'Queues To Monitor' panel, where the user selects the queue manager, refresh rate, system queues option and queue mask to be used during the monitoring of the queues.

• First, the user must select a queue manager which contents the queues to be monitored.
• If the queue mask is set to "*" then the user can select or de-select the system queues from being displayed.
• The monitoring data can be written to a CSV (Comma Separated Value) file. On subsequent invocations, the user can select to append the data to the file or write the data to a new file.
Location of the Queue Stats Monitor CSV files:
• On Windows: C:\Documents and Settings\{UserId}\Capitalware\MQVE\QSM\{QMgrName}\
• On Unix: {home}/Capitalware/MQVE/QSM/{QMgrName}/
• The user can set the rate in seconds at which the display will be refreshed.
• The user can select all queues ("*") of a queue manager to be monitored or select a partial list ("TEST*") of the queues to be monitored.

While the Queue Stats Monitor is running, the current real-time values are displayed and updated. To stop the execution of the Queue Stats Monitor click the Stop button.

Whatever you select for the Refresh Rate will be the interval that the Put & Get rates are measured by.
• The Put Rate is the number of MQPUTs in the given interval.
• The Get Rate is the number of MQGETs in the given interval.

Example: If the refresh rate is 60 seconds (interval) and during the interval the Put Rate was 15, hence, 15 messages were put to the queue in the last 60 seconds.

Quick visual helpers:
• If the 'High Queue Depth' is between 70% to 84.99% (of max queue depth) then it is highlighted in 'yellow'.
• If the 'High Queue Depth' is 85% or higher (of max queue depth) then it is highlighted in 'red'.