Chapter 4 Retrieving a list of Queues
Retrieving a list of queues.
This section will describe how to retrieve a list of queues from a local or remote queue manager.
Purpose
Use the QList command to query a queue manager for a current list of queues. The list of queues
can content the current queue depth, the queue type, number of input opens (IPPROCS), and number of output opens (IPPROCS).
The Qlist function can be used in junction with other scripts for light-weight monitoring of queues of a queue manager.
Syntax
{mqbt or mqbt.sh} QList -a Path_and_FileName_for_CommProfileDB -p Profile_Name [-f Input_File_Name] [-t Queue_Type] [-m Mask] [-D] [-T] [-I] [-O]
Function Name:
QList
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.
Optional Parameters:
-f The full path and filename of the output file.
-t The Queue Type can be used to reduce the returned List Of Queues. Valid values are L, A, C and R (Local, Alias, Cluster and Remote). Default is to return all queues.
-m The mask can be used to reduce the returned List Of Queues. i.e. ABC.*
-D Along with the List Of Queues, show the current depth of each local queue.
-T Show the Queue Type for each queue with the List Of Queues.
-I Show the Input Opens (IPPROCS) for each local queue in the List Of Queues.
-O Show the Output Opens (OPPROCS) for each local queue in the List Of Queues.
Notes:
If the user does not want to view the extra logging information, then review the Configure
Section of Chapter 2 for turning off logging to the console.
Example 1
List all queues in a queue manager.
Windows
mqbt QList -a c:\CommProfileDB.properties -p MQA1
Unix
./mqbt.sh QList -a /Capitalware/MQBT/CommProfileDB.properties -p MQA1
SYSTEM.ADMIN.CHANNEL.EVENT
SYSTEM.ADMIN.COMMAND.QUEUE
SYSTEM.ADMIN.PERFM.EVENT
SYSTEM.ADMIN.QMGR.EVENT
SYSTEM.AUTH.DATA.QUEUE
SYSTEM.CHANNEL.INITQ
SYSTEM.CHANNEL.SYNCQ
SYSTEM.CICS.INITIATION.QUEUE
SYSTEM.CLUSTER.COMMAND.QUEUE
SYSTEM.CLUSTER.REPOSITORY.QUEUE
SYSTEM.CLUSTER.TRANSMIT.QUEUE
SYSTEM.DEAD.LETTER.QUEUE
SYSTEM.DEFAULT.ALIAS.QUEUE
SYSTEM.DEFAULT.INITIATION.QUEUE
SYSTEM.DEFAULT.LOCAL.QUEUE
SYSTEM.DEFAULT.REMOTE.QUEUE
SYSTEM.PENDING.DATA.QUEUE
TEST01.Q
TEST02.Q
TEST03.Q
TEST04.Q
TEST05.Q
TEST1
TEST2
TEST3
TEST_BAD_TRIG.Q
TEST_XMIT.Q |
Example 2
List all queues, queue types, current depth, IPPROCS and OPPROCS of a queue manager.
Windows
mqbt QList -a c:\CommProfileDB.properties -p MQA1 -D -T -I -O
Unix
./mqbt.sh QList -a /Capitalware/MQBT/CommProfileDB.properties -p MQA1 -D -T -I -O
SYSTEM.ADMIN.CHANNEL.EVENT QLocal 0 0 0
SYSTEM.ADMIN.COMMAND.QUEUE QLocal 0 1 1
SYSTEM.ADMIN.PERFM.EVENT QLocal 0 0 0
SYSTEM.ADMIN.QMGR.EVENT QLocal 1 0 0
SYSTEM.AUTH.DATA.QUEUE QLocal 40 1 1
SYSTEM.CHANNEL.INITQ QLocal 0 1 1
SYSTEM.CHANNEL.SYNCQ QLocal 0 0 0
SYSTEM.CICS.INITIATION.QUEUE QLocal 0 0 0
SYSTEM.CLUSTER.COMMAND.QUEUE QLocal 0 1 1
SYSTEM.CLUSTER.REPOSITORY.QUEUE QLocal 1 1 1
SYSTEM.CLUSTER.TRANSMIT.QUEUE QLocal 0 1 1
SYSTEM.DEAD.LETTER.QUEUE QLocal 0 0 0
SYSTEM.DEFAULT.ALIAS.QUEUE QAlias
SYSTEM.DEFAULT.INITIATION.QUEUE QLocal 0 0 0
SYSTEM.DEFAULT.LOCAL.QUEUE QLocal 0 0 0
SYSTEM.DEFAULT.REMOTE.QUEUE QRemote
SYSTEM.PENDING.DATA.QUEUE QLocal 0 1 1
TEST01.Q QLocal 78 0 0
TEST02.Q QLocal 0 0 0
TEST03.Q QLocal 0 0 0
TEST04.Q QLocal 0 0 0
TEST05.Q QLocal 87 0 0
TEST1 QLocal 1 0 0
TEST2 QLocal 16 0 0
TEST3 QLocal 10 0 0
TEST_BAD_TRIG.Q QLocal 0 0 0
TEST_XMIT.Q QLocal 0 0 0 |
Example 3
List only local queues that begin with 'TEST', along with queue types, current depth, IPPROCS and OPPROCS of a queue manager.
Windows
mqbt QList -a c:\CommProfileDB.properties -p MQA1 -m "TEST*" -D -T -I -O
Unix
./mqbt.sh QList -a /Capitalware/MQBT/CommProfileDB.properties -p MQA1 -m "TEST*" -D -T -I -O
TEST01.Q QLocal 78 0 0
TEST02.Q QLocal 0 0 0
TEST03.Q QLocal 0 0 0
TEST04.Q QLocal 0 0 0
TEST05.Q QLocal 87 0 0
TEST1 QLocal 1 0 0
TEST2 QLocal 16 0 0
TEST3 QLocal 10 0 0
TEST_BAD_TRIG.Q QLocal 0 0 0
TEST_XMIT.Q QLocal 0 0 0 |
|
MQ Batch Toolkit