Acquiring recorded activity information
When a trace-route message has reached its intended destination, or is discarded, the method that we use to acquire the activity information depends on how that information was recorded.
Before starting
If we are unfamiliar with activity information, refer to How activity information is recorded.
About this task
Use the following methods to acquire the activity information after the trace-route message has reached its intended destination, or is discarded:
Procedure
- Retrieve the trace-route message. The Deliver parameter, in the TraceRoute PCF group, controls whether a trace-route message is placed on the target queue on arrival, or whether it is discarded. If the trace-route message is delivered to the target queue, we can retrieve the trace-route message from this queue. Then, we can use the IBM MQ display route application to display the activity information.
To request that activity information is accumulated in the message data of a trace-route message, set the Accumulate parameter in the TraceRoute PCF group to MQROUTE_ACCUMULATE_IN_MSG.
- Use a trace-route reply message. When a trace-route message reaches its intended destination, or the trace-route message cannot be routed any further in a queue manager network, a trace-route reply message can be generated. A trace-route reply message contains a duplicate of all the activity information from the trace-route message, and is either delivered to a specified reply-to queue, or the system queue SYSTEM.ADMIN.TRACE.ROUTE.QUEUE. We can use the IBM MQ display route application to display the activity information.
To request a trace-route reply message, set the Accumulate parameter in the TraceRoute PCF group to MQROUTE_ACCUMULATE_AND_REPLY.
- Use activity reports. If activity reports are generated for a trace-route message, we must locate the activity reports before we can acquire the activity information. Then, to determine the sequence of activities, we must order the activity reports.
Parent topic: Trace-route messaging