How to check queue depth of a remote queue manager using script? - ibm-mq

Question

I have a requirement to write a shell script to check queue depth of few queues in remote Queue manager.
Version of remote queue manager IBM websphere Mq v8.
Can anyone advise on this?

Answer 1

You can do the following:
1) Create an mqsc file, say curdepth.mqsc containing the following:
DIS QL(*) CURDEPTH
The above will display curdepth of all queues. If you need for a specific queue, then
DIS QL(<queue name>) CURDEPTH
You can also wildcard in the name.
DIS QL(SW*) CURDEPTH
2) Setup MQSERVER environment variable to point to remote queue manager. For example:
SET MQSERVER=MQ_CHN/TCP/remotehost(1414)
3) Through your shell script
runmqsc -c <qmgr> < curdepth.mqsc
The output would look something like
AMQ8409I: Display Queue details.
QUEUE(SWIFTQ) TYPE(QLOCAL)
CURDEPTH(0)
4) Then parse the output of the command.

Answer 2

Well, I think it would be better to write an MQ/PCF in Java (or C) rather than do it by a shell script. But if you must, here's one I used back in the early 2000's that I called chkQdepth.sh:
#!/bin/sh
#
# A shell script to check the queue depth and alert
# the user via email if it is too high.
#
# Parameters:
# $1=Queue manager
# $2=Queue name
# $3=alert threshold
# $4=mailing list
# $5=mail subject
# $6=mail message
#
if [ $# -ne 6 ] ; then exit; fi
QMGR="$1"
QUEUE="$2"
WARNING="$3"
MAILLIST="$4"
MAILSUB="$5"
MAILMSG="$6"
CURDEPTH=`/opt/mqm/bin/runmqsc $QMGR << EOF |sed -n '/CURDEPTH([0-9]*)/ {
s/.*CURDEPTH(\([0-9]*\))/\1/
p
}'
DISPLAY QUEUE($QUEUE) CURDEPTH
end
EOF`
if [ "x$CURDEPTH" != "x" ] ; then
if [ $CURDEPTH -gt $WARNING ] ; then
echo "Queue has more than $WARNING message(s)"
mail -t $MAILLIST << EOF
Subject: $5
$6
Queue Manager: $QMGR
Queue Name: $QUEUE
Current queue depth is $CURDEPTH messages
Alerting Threshold is $WARNING
EOF
else
echo "Queue depth is equal to or less than $WARNING. (Current queue depth is $CURDEPTH messages)"
fi
else
echo "Queue depth not available"
fi
exit 0
The script requires 6 input parameters:
The name of the queue manager
The name of the queue to check
Alert threshold amount (a number)
The mailing list of user that will receive the email
The mail subject
The mail message
You can run the script manually but it is far better to setup it so that a scheduler runs it, say every 5 minutes. Most people on Unix / Linux will use CRON, so here's a crontab entry:
0-59/5 * * * * /some/path/mqtools/chkQdepth.sh MQA1 TEST.Q1 50 roger#acme.com "Alert: Test.Q1 has too many messages." "Please check application XYZ as queue TEST.Q1 has too many messages in it." >/dev/null 2>&1