Enable queue managers for trace-route messaging

To control whether queue managers are enabled or disabled for trace-route messaging use the queue manager attribute ROUTEREC.

Use the MQSC command ALTER QMGR, specifying the parameter ROUTEREC to change the value of the queue manager attribute. The value can be any of the following values:

MSG

The queue manager is enabled for trace-route messaging. Applications within the scope of the queue manager can write activity information to the trace-route message. If the Accumulate parameter in the TraceRoute PCF group is set as MQROUTE_ACCUMULATE_AND_REPLY, and the next activity to be performed on the trace-route message:

• is a discard
• is a put to a local queue (target queue or dead-letter queue)
• will cause the total number of activities performed on the trace-route message to exceed the value of parameter the MaxActivities, in the TraceRoute PCF group .

a trace-route reply message is generated, and delivered to the reply-to queue specified in the message descriptor of the trace-route message.

QUEUE

The queue manager is enabled for trace-route messaging. Applications within the scope of the queue manager can write activity information to the trace-route message. If the Accumulate parameter in the TraceRoute PCF group is set as MQROUTE_ACCUMULATE_AND_REPLY, and the next activity to be performed on the trace-route message:

• is a discard
• is a put to a local queue (target queue or dead-letter queue)
• will cause the total number of activities performed on the trace-route message to exceed the value of parameter the MaxActivities, in the TraceRoute PCF group .

a trace-route reply message is generated, and delivered to the local system queue SYSTEM.ADMIN.TRACE.ROUTE.QUEUE.

DISABLED

The queue manager is disabled for trace-route messaging. Activity information is not accumulated in the the trace-route message, however the TraceRoute PCF group can be updated while in the scope of this queue manager.

For example, to disable a queue manager for trace-route messaging, use the following MQSC command:

ALTER QMGR ROUTEREC(DISABLED)

Remember: When you modify the ROUTEREC queue manager attribute, a running MCA does not detect the change until the channel is restarted. Parent topic: Control trace-route messaging