Starting user trace

Before you start:

Before you start to trace a broker, or any of its execution groups or message flows, the broker must be running, and you must have deployed the message flows using the workbench. Follow the instructions in the Deploying topic.

To start a user trace:
  1. Start WebSphere Message Broker user trace facilities by using the mqsichangetrace command, or, for execution groups and assigned message flows, from the workbench. You can select only one broker on each invocation of the command, but you can activate concurrent traces for more than one broker, by invoking the command more than once.
  2. Specify an individual execution group or message flow within the specified broker to limit the scope of a trace. The events that are recorded when you select the message flow option include:
    • Sending a message from one Message Processing node to the next
    • Evaluating expressions in a Filter or Compute node
  3. Start your trace. You can start trace at two levels:
    normal
    This tracks events that affect objects that you create and delete, such as nodes.
    debug
    This tracks the beginning and end of a process, as well as monitoring objects that are affected by that process.

Example: starting user trace for the default execution group

To start normal level user tracing for the default execution group on a broker that you have created with the name WBRK_BROKER, on distributed systems, enter the command
mqsichangetrace WBRK_BROKER -u -e default -l normal
where:

-u specifies user trace
-e specifies the execution group (in this case, the default execution group)
-l specifies the level of trace (in this case, normal)

On z/OS, enter the command
F MQP1BRK,ct u=yes, e='default', l=normal

Example: starting user trace for the default execution group from the workbench

To start normal level user tracing for the default execution group from the workbench:

  1. Switch to the Broker Administration perspective.
  2. In the Domains view, right-click the default execution group.
  3. Click User trace > Normal.

Example: starting user trace for a message flow from the workbench

To start normal level user tracing for one of your message flows from the workbench:

  1. Switch to the Broker Administration perspective.
  2. In the Domains view, right-click the message flow for which you want to start trace.
  3. Click User trace > Normal.

An alert saying Message Flow is tracing at level 'normal' is displayed in the Alert Viewer.

Related concepts
Trace