Collecting data for the MQ Queue Statistics workspace

Data in the MQ Queue 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 Queue 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 queue level. For detailed commands about how to set the level of statistics that is produced at the queue level, see the IBM MQ documentation.

Procedure

  1. Configure the queue manager to collect queue statistics information by doing one of the following steps:
    • Run the following MQSC command:
      ALTER QMGR STATQ(ON)
    • Send the command for configuring the queue manager to collect queue 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 statistics information collection for the queues for which you want to collect statistics information by running the following MQSC command:
    ALTER QLOCAL(queue_name) STATQ(QMGR)
    where (queue_name) is the name of the queue 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 (*).
  4. 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. Here you can set it to REMOVE or BROWSE to suit the requirements of your environment. For information about how to change monitoring options, see Changing 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 have to restart the queue manager for these changes to take effect.