WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Switching Trace nodes on and off

Use the mqsichangetrace command or the WebSphere® Message Broker Explorer to switch Trace nodes on and off.

When an execution group is created, or a message flow is deployed, its Trace node switch is set to on by default. Execution groups and message flows that you have migrated from a previous version are also handled in this way. The message flow level Trace node switch setting is not changed on redeployment. You can significantly improve the performance of a flow that includes Trace nodes by switching Trace nodes off.
Restriction: If you switch off Trace nodes in a flow that was migrated from a version earlier than 6.1, you can no longer revert that flow to its earlier state.

If the Trace node setting for an execution group is off, all Trace nodes in its flows are disabled. You can change the settings for Trace nodes in individual message flows; the settings are applied when you turn on Trace nodes for the execution group. If the Trace node setting for an execution group is on, the Trace node switch setting of each message flow determines the effective settings. Use the mqsireporttrace command to check the settings for message flows and execution groups.

Example: switching off Trace nodes for an execution group on distributed systems, using the command line

To disable the Trace node switch settings of all message flows in an execution group of a broker called MB8BROKER, (that is, stop all the Trace nodes in any of the message flows deployed to the execution group from executing), enter the following command:
mqsichangetrace MB8BROKER –n off -e default
In this example, -n off switches off Trace nodes in the default execution group (-e default).

All Trace nodes are switched off, even if the message flow that contains them has its Trace node switch set to on.

Example: switching off Trace nodes for an execution group on z/OS® systems, using the command line

To disable the Trace node switch settings of all message flows in an execution group of a broker called MQP1BRK, (that is, stop all the Trace nodes in any of the message flows deployed to the execution group from executing), enter the following command:
F MQP1BRK,ct n='off', e='default'
In this example, n='off' switches off Trace nodes in the default execution group (e='default').

All Trace nodes are switched off, even if the message flow that contains them has its Trace node switch set to on.

Example: switching off Trace nodes for a message flow on distributed systems, using the command line

Trace nodes for the default execution group in broker MB8BROKER are switched on. You want to turn off Trace nodes for the myFlow message flow.
Enter the following command:
mqsichangetrace MB8BROKER -n off -e default -f myFlow

Example: switching on Trace nodes for a message flow and an execution group on distributed systems, using the command line

Trace nodes for the default execution group in broker MB8BROKER are switched off. You want to turn on Trace nodes for the myFlow message flow, then turn on Trace nodes for the execution group.
  1. To turn on Trace nodes for the message flow, enter the following command:
    mqsichangetrace MB8BROKER -n on -e default -f myFlow
    Trace nodes for the myFlow message flow are turned on, but this setting is not applied until you turn on trace nodes for the execution group.
  2. To turn on Trace nodes for the execution group, enter the following command:
    mqsichangetrace MB8BROKER –n on -e default
    Trace nodes are turned on for the default execution group. Within that execution group, Trace nodes are enabled in all message flows that have Trace nodes turned on, including the myFlow message flow.

Example: switching off Trace nodes for a message flow on z/OS systems, using the command line

Trace nodes for the default execution group in broker MQP1BRK are switched on. You want to turn off Trace nodes for one of the message flows (myFlow).
Enter the following command:
F MQP1BRK,ct n='off', e='default', f='myFlow'

Example: switching on Trace nodes for an execution group, using the WebSphere Message Broker Explorer

Trace nodes are enabled by default. If you have switched them off, follow these steps to enable Trace nodes for an execution group from the WebSphere Message Broker Explorer:
  1. In the Navigator view, expand the Brokers folder and right-click the execution group with which you want to work.
  2. Click Trace Nodes All Flows > Enable. An alert saying Trace nodes are switched on is displayed in the Alert Viewer. The Trace node switch setting of each message flow determines the effective settings.

Example: switching on Trace nodes for a message flow, using the WebSphere Message Broker Explorer

If the Trace node setting for an execution group is off, all Trace nodes in its flows are disabled. You can change the settings for Trace nodes in individual message flows; the settings are applied when you turn on Trace nodes for the execution group. If the Trace node setting for an execution group is on, the Trace node switch setting of each message flow determines the effective settings.
Follow these steps to enable Trace nodes for one of your message flows from the WebSphere Message Broker Explorer:
  1. In the Navigator view, expand the Brokers folder and right-click the message flow with which you want to work.
  2. Click Trace Nodes > Enable An alert is displayed in the Alert Viewer.
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:47:40


Task topicTask topic | Version 8.0.0.7 | au60100_