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. For details of how to deploy message flows, see Deploying message flow applications.

The following steps show you how to start a user trace.
  1. Start WebSphere Business Integration Message Broker user trace facilities by using the command mqsichangetrace, 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. For a full description of the mqsichangetrace command, see mqsichangetrace command.
  2. Specify an individual execution group or message flow within the specified broker to limit the scope of a trace. The events 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. 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 processes, as well as monitoring objects that are affected by that process.

Example: starting user trace for the default execution group

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

To start user trace for the default execution group from the workbench:

  1. Switch to the Broker Administration perspective.
  2. In the Domains view, right-click on 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 on 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

Related tasks
Deploying message flow applications
Diagnosing errors
Using trace
Stopping user trace
Starting service trace

Related reference
Broker Administration perspective
User trace
mqsichangetrace command