IBM Support

"SET QUEUE" validity and limitations

Troubleshooting


Problem

Even if you specify "SET QUEUE" statement to monitor only certain queues, for some kind of data the MQ monitoring agent will monitor all queues of the queue manager.

Symptom

You specify in the MQ agent .cfg file a number of "SET QUEUE" statements configuring the agent to monitor only certain queues.
Then you define and start a situation that checks the Queue Status, Current Depth and Input Opens (as an example) and you begin receiving events from queues that are not the ones specified in the .cfg file.

Resolving The Problem

This behavior is by design for the MQ monitoring agent.

The SET QUEUE statements only apply to sampled data collection, which is done every SAMPINT.
Tables containing queue-related sampled data are "Queue Statistics" and "Queue Definitions" and only workspaces/situations based on these tables will have data limited to what was specified in SET QUEUE statements.

Other queue-related tables, such as "Queue Status", "Queue Handle Status", "MQ Queue Statistics" (MQI queue-related data) do not pick up the information in the SET QUEUE statements.
If you only want specific data in these non-sampled workspaces, then you need to modify the query or add filters to only display certain queues.
For situations, you can add "Queue Name" criteria.

Example of formula for a situation that monitors only some queues with current depth > 0:
( #'QMQ_QU_ST.CURDEPTH' > 0 AND #QMQ_QU_ST.QNAME == TESTQ.MONQUEUE) OR
( #QMQ_QU_ST.CURDEPTH > 0 AND STR(#QMQ_QU_ST.QNAME) == 1,ABCQUEUE)

That is, specifying the condition on the Queue Name that should be:
- value of expression - equal for the queue with specific name (for example TESTQ.MONQUEUE)
- return a subset of the string - equal for the queue with name starting with same substring (for example ABCQUEUE*).

[{"Product":{"code":"SSRLBE","label":"Tivoli OMEGAMON XE for Messaging for Distributed Systems"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"OMEGAMON XE WEBSPHERE MQ","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.0.1;7.1.0;7.3.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
17 June 2018

UID

swg21577148