Enabling 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:
a trace-route reply message is generated, and delivered to the reply-to queue specified in the message descriptor of 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 .
- 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:
a trace-route reply message is generated, and delivered to the local system queue SYSTEM.ADMIN.TRACE.ROUTE.QUEUE.
- 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 .
- 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.