MQ Batch Toolkit

Chapter 7 Queue Monitor

Queue Monitor

This section will describe how to invoke and use the Queue Monitor tool. The Queue Monitor will continuously monitor the Queue Depth, Max Depth, IPPROCS, OPPROCS, Put Inhibit and Get Inhibit attributes of a queue.

The monitoring data will 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.

On Windows: C:\Documents and Settings\{UserId}\Capitalware\MQBT\QM\{QMgrName}\
On Unix: {home}/Capitalware/MQBT/QM/{QMgrName}/

Purpose

Use the QM command to start the monitoring of the queues of a queue manager.

Syntax

{mqbt or mqbt.sh} QM -a Path_and_FileName_for_CommProfileDB -p Profile_Name {-d Days -h Minutes -m Hours} [-k mask] [-r RefreshRate] [-A] [-S]

Function Name:
QM

Required Parameters:
-a The full path and filename for a CommProfileDB.properties file. -p The name of a profile contained in the CommProfileDB.properties file.

Requires at least 1 of the following parameters:
-d Consumes messages for 'x' days. -h Consumes messages for 'x' hours. -m Consumes messages for 'x' minutes.

Optional parameters:
-r The Refresh Rate (in seconds) is the value to determine how often to retrieve the monitoring data. Default value is 60 seconds. -k The mask can be used to limit the the number of queues to be monitored. i.e. ABC.* -A Append the monitoring data to CSV file (do not delete the old data) -S Include System Queues in the list of queues to be monitored.

Example 1

Monitor the queues of a queue manager for 4 hours.

Windows
mqbt QM -a c:\CommProfileDB.properties -p MQA1 -h 4
Unix
./mqbt.sh QM -a /Capitalware/MQBT/CommProfileDB.properties -p MQA1 -h 4

Example 2

Monitor the only queues that begin with "TEST.*" of a queue manager for 8 days, 4 hours and 35 minutes.

Windows
mqbt QM -a c:\CommProfileDB.properties -p MQA1 -k "TEST.*" -d 8 -h 4 -m 35
Unix
./mqbt.sh QM -a /Capitalware/MQBT/CommProfileDB.properties -p MQA1 -k "TEST.*" -d 8 -h 4 -m 35

Sample Output for queue TEST.Q1

Queue_Name,Queue_Depth,Max_Depth,IPPROCS,OPPROCS,Get_Inhibit,Put_Inhibit
16:40:06,10,5000,1,1,Enabled,Enabled
16:41:06,13,5000,1,1,Enabled,Enabled
16:42:06,17,5000,1,1,Enabled,Enabled
16:43:06,0,5000,1,1,Enabled,Enabled
16:44:06,8,5000,1,1,Enabled,Enabled
16:45:06,11,5000,1,1,Enabled,Enabled
16:46:06,13,5000,1,1,Enabled,Enabled
16:47:06,5,5000,1,1,Enabled,Enabled
16:48:06,12,5000,1,1,Enabled,Enabled
16:49:06,1,5000,1,1,Enabled,Enabled
16:50:06,6,5000,1,1,Enabled,Enabled
16:51:06,11,5000,1,1,Enabled,Enabled
16:52:06,13,5000,1,1,Enabled,Enabled
16:53:06,18,5000,1,1,Enabled,Enabled
16:54:06,21,5000,1,1,Enabled,Enabled
16:55:06,0,5000,1,1,Enabled,Enabled
16:56:06,4,5000,1,1,Enabled,Enabled
16:57:06,9,5000,1,1,Enabled,Enabled
16:58:06,14,5000,1,1,Enabled,Enabled
16:59:06,19,5000,1,1,Enabled,Enabled

Visualizing the Data

The user can use the "TEST.Q1.csv" file with a spreadsheet program and create a Line Chart. The following sample Line Chart is using just the first 2 columns of the CSV file.