Controlling performance events

Performance events as a whole are controlled using the PERFMEV queue manager attribute. To enable performance events, set PERFMEV to ENABLED. To disable performance events, set the PERFMEV queue manager attribute to DISABLED. For example, to set the PERFMEV queue manager attribute to ENABLED, we can use the following MQSC command:

ALTER QMGR PERFMEV (ENABLED)

We can then enable specific performance events by setting the appropriate queue attribute. You also have to specify the conditions that give rise to the event.

 

Controlling queue depth events

By default, all queue depth events are disabled. To configure a queue for any of the queue depth events :

1. Enable performance events on the queue manager.

2. Enable the event on the required queue.

3. Set the limits, if required, to the appropriate levels, expressed as a percentage of the maximum queue depth.

For more information, see Understanding queue depth events.

 

Controlling queue service interval events

To configure a queue for queue service interval events :

1. Enable performance events on the queue manager.

2. Set the control attribute for a Queue Service Interval High or OK event on the queue as required.

3. Specify the service interval time by setting the QSVCINT attribute for the queue to the appropriate length of time.

For more information, see Enabling queue service interval events.

Note:

When enabled, a queue service interval event can be generated at any appropriate time, not necessarily waiting until an MQI call for the queue is issued. However, if an MQI call is used on a queue to put or remove a message, any applicable performance event will be generated at that time. The event is not generated when the elapsed time becomes equal to the service interval time.