The collection of statistics data is controlled by queue manager, queue, and channel attributes.
The collection of MQI statistics information is controlled by the queue manager attribute, STATMQI. To change the value of this queue manager attribute, you can use the MQSC command, ALTER QMGR and specify the parameter STATMQI. STATMQI can have the following values:
For example, to enable MQI statistics use the following MQSC command:
ALTER QMGR STATMQI(ON)
Queue statistics information collection can be enabled or disabled for individual queues, or for multiple queues. To control individual queues, the queue attribute STATQ must be set to enable or disable queue statistic information collection. To control many queues together, queue statistics information collection can be enabled or disabled at the queue manager level using the queue manager attribute STATQ. For all queues that have the queue attribute STATQ specified with the value, QMGR, queue statistics information collection is controlled at the queue manager level.
To change the value of the queue attribute STATQ, you can use the MQSC command, ALTER QLOCAL and specify the parameter STATQ. To change the value of the queue manager attribute STATQ, you can use the MQSC command, ALTER QMGR and specify the parameter STATQ.
The queue attribute, STATQ, can have the following values:
The queue manager attribute, STATQ, can have the following values:
To enable statistics information collection for the queue, Q1, use the following MQSC command:
ALTER QLOCAL(Q1) STATQ(ON)
To enable statistics information collection for all queues that specify the queue attribute STATQ as QMGR, use the following MQSC command:
ALTER QMGR STATQ(ON)
If the queue manager attribute, STATQ, is set to NONE, the collection of queue statistics information is disabled for all queues, regardless of the queue attribute STATQ.
Channel statistics information collection can be enabled or disabled for individual channels, or for multiple channels. To control individual channels, the channel attribute STATCHL must be set to enable or disable channel statistic information collection. To control many channels together, channel statistics information collection can be enabled or disabled at the queue manager level using the queue manager attribute STATCHL. For all channels that have the channel attribute STATCHL specified with the value, QMGR, channel statistics information collection is controlled at the queue manager level.
Automatically defined cluster-sender channels are not WebSphere MQ objects, so do not have attributes in the same way as channel objects. To control automatically defined cluster-sender channels, use the queue manager attribute, STATACLS. This attribute determines whether automatically defined cluster-sender channels within a queue manager are enabled or disabled for channel statistics information collection.
Channel statistics information collection can be set to one of the three monitoring levels, low, medium or high. This is set at either object level, or at the queue manager level. The choice of which level to use is dependant on your system. Collecting statistics information data may require the execution of some relatively expensive instructions, so in order to reduce the impact of channel statistics information collection, the medium and low monitoring options measure a sample of the data at regular intervals rather than collecting data all the time. Table 20 summarizes the levels available with channel statistics information collection:
Level | Description | Usage |
---|---|---|
Low |
Measure a small sample of the data, at regular intervals. |
For objects that process a high volume of messages. |
Medium |
Measure a sample of the data, at regular intervals. |
For most objects. |
High |
Measure all data, at regular intervals. |
For objects that process only a few messages per second, on which the most current information is important. |
To change the value of the channel attribute STATCHL, you can use the MQSC command, ALTER CHANNEL and specify the parameter STATCHL.
To change the value of the queue manager attribute STATCHL, you can use the MQSC command, ALTER QMGR and specify the parameter STATCHL.
To change the value of the queue manager attribute STATACLS, you can use the MQSC command, ALTER QMGR and specify the parameter STATACLS.
The channel attribute, STATCHL, can have the following values:
This is the default value.
The queue manager attribute, STATCHL, can have the following values:
This is the default value.
The queue manager attribute, STATACLS, can have the following values:
This is the default value.
For example, to enable statistics information collection, with a medium level of detail, for the sender channel QM1.TO.QM2, use the following MQSC command:
ALTER CHANNEL(QM1.TO.QM2) CHLTYPE(SDR) STATCHL(MEDIUM)
To enable statistics information collection, at a medium level of detail, for all channels that specify the channel attribute STATCHL as QMGR, use the following MQSC command:
ALTER QMGR STATCHL(MEDIUM)
To enable statistics information collection, at a medium level of detail, for all automatically defined cluster-sender channels, use the following MQSC command:
ALTER QMGR STATACLS(MEDIUM)
Statistics messages are generated at configured intervals, and when a queue manager shuts down in a controlled fashion.
The configured interval is controlled by the STATINT queue manager attribute. STATINT specifies the interval, in seconds, between the generation of statistics messages. The default statistics interval is 1800 seconds (30 minutes). To change the statistics interval you can you the MQSC command ALTER QMGR and specify the STATINT parameter. For example, to change the statistics interval to 900 seconds (15 minutes) use the following MQSC command:
ALTER QMGR STATINT(900)
To write the currently collected statistics data to the statistics queue before the statistics collection interval is due to expire, you can use issue the MQSC command RESET QMGR TYPE(STATISTICS). This causes the collected statistics data to be written to the statistics queue and a new statistics data collection interval to begin.
Notices |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
csqzax0598 |