Collecting data for the MQ Channel Statistics workspace

Data in the MQ Channel Statistics workspace is retrieved from the statistics messages in a system queue of the queue manager. To display correct data, you must configure the queue manager and the IBM MQ Monitoring Agent for the workspace.

Before you begin

You must have the required authorities for the MQSC commands.

About this task

Do the following steps to collect data for the MQ Channel Statistics workspace.
Important: The commands in the following instructions set the level of statistics that is produced at the queue manager level. You can also set that level at the individual channel level. For detailed commands about how to set the level of statistics that is produced at the channel level, see the IBM MQ documentation.

Procedure

  1. Configure the queue manager to collect channel statistics information by doing one of the following steps:
    • Run the following MQSC command:
      ALTER QMGR STATCHL(collection_level)
      where collection_level is the collection level of channel statistics information. You can set it to LOW, MEDIUM, or HIGH to suit the requirements of your environment.
    • Send the command for configuring the queue manager to collect channel statistics information by using the Take Action command. For information about how to send a Take Action command to a managed system, see Sending a Take Action command.
  2. Set the interval over which the accounting data is collected by doing one of the following steps:
    • Run the following MQSC command:
      ALTER QMGR STATINT(n)
      where n is the number of seconds over which the accounting data is collected.
    • Send the command for setting the interval by using the Take Action command.
  3. Enable the statistics information collection for the channels for which you want to collect statistics information by doing one of the following steps:
    • Run the following MQSC command:
      ALTER CHANNEL(channel_name) STATCHL(QMGR)
      where channel_name is the name of the channel for which you want to collect statistics information. You can also specify a generic name by entering a character string that is followed by an asterisk (*).
    • Send the command for enabling statistics information collection for the channels by using the Take Action command.
  4. Optional: Edit the monitoring file of the IBM MQ Monitoring Agent to allow it to read messages from the system statistics queues.
    The STATISTICSINFO attribute specifies how the IBM MQ Monitoring Agent accesses the data that is produced by the queue manager. It is set to REMOVE by default. You can set it to BROWSE to suit the requirements of your environment. See Changing monitoring options for information about how to change monitoring options.
  5. If you changed the monitoring file of the IBM MQ Monitoring Agent, restart the agent for the changes to take effect.

What to do next

You do not need to restart the queue manager for these changes to take effect.