Rule examples

This section includes some tips and examples for rule creation.

Alert on queue manager being down

• Intent of rule: this rule is set on the queue manager to trigger an alert if queue manager goes down.
• Implementation: 
  • In MQ6 and higher, use the QMgrStatus attribute with a greater than sign and value of zero.
    
    ClientHostName!QmgrName!QmgrStatus > 0
     
  • In MQ5.x and higher, use LastPCFResponse.
    
    ClientHostName!QmgrName!LastPCFResponse != 0

• Results: the event actions configured in the event rule are triggered if the queue manager status is anything greater than zero (in the above examples).
• Additional notes: if you have multiple queue managers and you want to be notified when they are down, create a template for queue manager down, then associate it with each queue manager.

Alert on increase in queue depth

• Intent of rule: this rule is set on the Current Queue Depth of the queue to trigger an alert when the number of messages in the queue increases.
• Implementation: delta (change) of 1 - to detect the change.
  
  Dequeue Rate of 0 - to ensure that there is no alert if a message is removed from the queue.
  
  Rule:
  
  'RJH01YQM1!queuename! MsgDeqRate'=n
&'RJH01YQM1!queuename! CurrentQDepth' [DELTA]1
  
  where:
  queuename is the name of the queue
  n is any number lower than the enqueue rate.

• Results: the rule fires when the current queue depth increases, with one exception: if this event is set up for increase in queue depth only, it does not fire if the depth drops to zero.