You can use the amqsrua command to query metadata that is related to
the system resource usage of a queue manager.
About this task
The amqsrua command reports metadata that is published by queue
managers. This data can include information about the CPU, memory, and disk usage. You can also
see data equivalent to the STATMQI PCF statistics data. The data is published every 10 seconds
and is reported while the command runs.
Procedure
-
Enter the IBM® MQ administration mode by
entering the following command:
-
Query the meta data by entering the following command:
amqsrua -n MaxPubs -m QMgrName [-s
model_queue]
Where:
- MaxPubs
- Specifies how many reports are returned before the command ends. The command publishes
data every ten seconds, so if you enter a value of 50, the command returns 50 reports over
500 seconds.
- If you do not specify this parameter, the command runs until either an error occurs, or
the queue manager shuts down.
- QMgrName
- Specifies the name of the queue manager that you want to query. The queue manager must
be running.
- If you do not specify a queue manager name, the default queue manager is used.
- model_queue
- By default amqsrua uses the SYSTEM.DEFAULT.MODEL.QUEUE. You can use the -s
option to specify a different model queue.
-
From the list of options, enter the class of data you want returned. The class is
case-sensitive. The following options are available:
- CPU
- Returns information about CPU usage.
- DISK
- Returns information about disk usage.
- STATMQI
- Returns information about MQI usage.
- STATQ
- Returns information about per-queue MQI usage.
- STATAPP
- Returns information about per-application usage
-
From the list of options, enter the type of data you want returned. The type is case-sensitive.
- Optional:
When amqsrua finishes, exit the IBM MQ administration mode by entering the following
command:
Example
The following example shows the result of using amqsrua to view CPU
performance data for the running queue manager over a 20-second period:
mqa(mqcli)# amqsrua -n 2 -m ASH
CPU : Platform central processing units
DISK : Platform persistent data stores
STATMQI : API usage statistics
STATQ : API per-queue usage statistics
Enter Class selection
==> CPU
SystemSummary : CPU performance - platform wide
QMgrSummary : CPU performance - running queue manager
Enter Type selection
==> QMgrSummary
Publication received PutDate:20151014 PutTime:09175398
User CPU time - percentage estimate for queue manager 0.02%
System CPU time - percentage estimate for queue manager 0.04%
RAM total bytes - estimate for queue manager 200MB
Publication received PutDate:20151014 PutTime:09180405
User CPU time - percentage estimate for queue manager 0.00%
System CPU time - percentage estimate for queue manager 0.00%
RAM total bytes - estimate for queue manager 200MB
mqa(mqcli)#