Channel statistics information
Use the channel attribute STATCHL to control the collection of channel statistics information. You can also set queue manager attributes to control information collection.
You can enable or disable channel statistics information collection for individual channels, or for multiple channels. To control individual channels, you must set the channel attribute STATCHL to enable or disable channel statistic information collection. To control many channels together, you enable or disable channel accounting information collection at the queue manager level by using the queue manager attribute STATCHL. For all channels that have the channel attribute STATCHL specified with the value QMGR, channel accounting information collection is controlled at the queue manager level.
Automatically defined cluster-sender channels are not IBM® 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.
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, use the MQSC command, ALTER CHANNEL
and specify the parameter STATCHL
.
To change the value of the queue manager attribute STATCHL, use the MQSC command, ALTER QMGR
and specify the parameter STATCHL
.
To change the value of the queue manager attribute STATACLS, use the MQSC command, ALTER QMGR
and specify the parameter STATACLS
.
- LOW
- Channel statistics information is collected with a low level of detail.
- MEDIUM
- Channel statistics information is collected with a medium level of detail.
- HIGH
- Channel statistics information is collected with a high level of detail.
- OFF
- Channel statistics information is not collected for this channel.
- QMGR
- The channel attribute is set as QMGR. The collection of statistics information for this channel is controlled by the value of the queue manager attribute, STATCHL.
This is the default value.
On z/OS®, this parameter simply turns on statistics data collection, regardless of the value you select. Specifying LOW, MEDIUM, or HIGH makes no difference to your results.
- LOW
- Channel statistics information is collected with a low level of detail, for all channels that have the channel attribute STATCHL set as QMGR.
- MEDIUM
- Channel statistics information is collected with a medium level of detail, for all channels that have the channel attribute STATCHL set as QMGR.
- HIGH
- Channel statistics information is collected with a high level of detail, for all channels that have the channel attribute STATCHL set as QMGR.
- OFF
- Channel statistics information is not collected for all channels that have the channel attribute STATCHL set as QMGR.
This is the default value.
- NONE
- The collection of channel statistics information is disabled for all channel, regardless of the channel attribute STATCHL.
On z/OS, this parameter simply turns on statistics data collection, regardless of the value you select. Specifying LOW, MEDIUM, or HIGH makes no difference to your results.
- LOW
- Statistics information is collected with a low level of detail for automatically defined cluster-sender channels.
- MEDIUM
- Statistics information is collected with a medium level of detail for automatically defined cluster-sender channels.
- HIGH
- Statistics information is collected with a high level of detail for automatically defined cluster-sender channels.
- OFF
- Statistics information is not collected for automatically defined cluster-sender channels.
- QMGR
- The collection of statistics information for automatically defined cluster-sender channels is controlled by the value of the queue manager attribute, STATCHL.
This is the default value.
On z/OS, this parameter simply turns on statistics data collection, regardless of the value you select. Specifying LOW, MEDIUM, or HIGH makes no difference to your results.
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)