controlling trace-route messaging, queue manager, queue managers for trace-route messaging, enabling" /> Controlling queue managers for trace-route messaging

 

Controlling 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. We can use the MQSC command

ALTER QMGR specifying the parameter ROUTEREC to change the value of the queue manager attribute. The value can be:

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 .

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

For information on the TraceRoute PCF group, see 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:

  • 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 .

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

For information on the TraceRoute PCF group, see 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)
Note:
If the queue manager attribute ROUTEREC is modified a running MCA will not pick up the updates until the channel is restarted.