MQ Visual Edit

This section will describe how to invoke and use the Queue Monitor tool. The Queue Monitor will continuously monitor the queues of a queue manager displaying the Queue Name, Current Queue Depth, Max Queue Depth, Open Input Count, Open Output Count, Get Enabled / Inhibited and Put Enabled / Inhibited.

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, Current Depth, Max Queue Depth, Open Input Count, Open Output Count, Get and Put.
• 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 current queue depth is between 70% to 84.99% (of max queue depth) then it is highlighted in 'yellow'.
• If the current queue depth is 85% or higher (of max queue depth) then it is highlighted in 'red'.
• If either the Get or Put attributes are set to Inhibited then they are highlighted in 'yellow'.

Whatever you select for the Refresh Rate will be the interval that the Depth, Input & Output fields are measured by.
• The Depth is the current number of messages in the queue including both committed and uncommitted messages.
• The Input is the IPPROCS value for the queue. IPPROCS is the number of processes that have a queue open for input.
• The Output is the OPPROCS value for the queue. OPPROCS is the number of processes that have a queue open for output.

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

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 Monitor.

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 Monitor CSV files:
• On Windows: C:\Documents and Settings\{UserId}\Capitalware\MQVE\QM\{QMgrName}\
• On Unix: {home}/Capitalware/MQVE/QM/{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 Monitor is running, the current real-time values are displayed and updated. To stop the execution of the Queue Monitor click the Stop button.

Whatever you select for the Refresh Rate will be the interval that the Depth, Input & Output fields are measured by.
• The Depth is the current number of messages in the queue including both committed and uncommitted messages.
• The Input is the IPPROCS value for the queue. IPPROCS is the number of processes that have a queue open for input.
• The Output is the OPPROCS value for the queue. OPPROCS is the number of processes that have a queue open for output.

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

Quick visual helpers:
• If the current queue depth is between 70% to 84.99% (of max queue depth) then it is highlighted in 'yellow'.
• If the current queue depth is 85% or higher (of max queue depth) then it is highlighted in 'red'.
• If either the Get or Put attributes are set to Inhibited then they are highlighted in 'yellow'.