Monitoring the input or output of a message flow
About this task
When you are designing a message flow that is to be monitored by a broker, you must place a CandleMonitor node immediately after the MQInput node, so that the CandleMonitor node can gather the information that is required for input rate calculations. Another important location for placing the CandleMonitor node is immediately in front of any MQOutput, MQReply, or Publication nodes, so that the CandleMonitor node can gather the information that is required to calculate output rate calculations.
Tip: If you want to place only a single CandleMonitor node in
a message flow, the input position is the best choice, because most
statistics are generated from this position.
To monitor the input of a message flow, perform the following procedure:
Procedure
- Place a CandleMonitor node immediately after the MQInput node.
- Set the type attribute of the CandleMonitor node placed in this position to input.
- Optional: If the input queue to a message flow contains messages that have put date and times that do not accurately reflect when the message was put into the input queue, and you are using a CandleMonitor node with the type attribute set to input, set the collectQueueTime attribute to no, so that queue times are not calculated for these messages. When queue time statistics are determined, queue times are calculated using the put date and time of the message in the queue. Put date and times are not accurate when origin context is preserved for a message during the put operation by the application performing this operation. Inaccuracies of put date and time commonly occur when an application is a message mover that transfers messages from one queue to another, or when an application passes or sets origin context for a message. If the input queue to Message Flow B is the output queue of Message Flow A, the broker passes the origin context so that the put date and time for the message in Message Flow B is not an accurate calculation of queue time. The collectQueueTime attribute for a CandleMonitor node placed in Message Flow B must be set to no.
Results
To monitor the output of a message flow, do the following steps:
- Place the CandleMonitor node immediately in front of any MQOutput, MQReply, or Publication nodes.
- Set the type attribute of a CandleMonitor node placed in this position to output.