Performance events

Performance events relate to conditions that can affect the performance of applications that use a specified queue. The scope of performance events is the queue. MQPUT calls and MQGET calls on one queue do not affect the generation of performance events on another queue.

Performance event messages can be generated at any appropriate time, not necessarily waiting until an MQI call for the queue is issued. However, if we use an MQI call on a queue to put or remove a message, any appropriate performance events are generated at that time.

Every performance event message that is generated is placed on the queue, SYSTEM.ADMIN.PERFM.EVENT.

The event data contains a reason code that identifies the cause of the event, a set of performance event statistics, and other data. The types of event data that can be returned in performance event messages are described in the following list:

• Queue Depth High
• Queue Depth Low
• Queue Full
• Queue Service Interval High
• Queue Service Interval OK

Examples that illustrate the use of performance events assume that you set queue attributes by using the appropriate IBM MQ commands (MQSC). On z/OS, we can also set queue attributes using the operations and controls panels for queue managers.

• Performance event statistics
  The performance event data in the event message contains statistics about the event. Use the statistics to analyze the behavior of a specified queue.
• Queue service interval events
  Queue service interval events indicate whether an operation was performed on a queue within a user-defined time interval called the service interval. Depending on your installation, we can use queue service interval events to monitor whether messages are being taken off queues quickly enough.
• Queue service interval events examples
  Use the examples in this section to understand the information that we can obtain from queue service interval events.
• Queue depth events
  Queue depth events are related to the queue depth, that is, the number of messages on the queue.
• Queue depth events examples
  Use these examples to understand the information that we can obtain from queue depth events

Parent topic: Event monitoring

Related reference

• Event types