Using the Test Client in trace and debug mode

You can run the Test Client in trace and debug mode to trace the path of a test message through a message flow.

Before you begin

Before you can test your message flow, you must have configured an integration node. The integration node must be running. You must also have created an integration server to which to deploy your message flows.

About this task

You can use the trace and debug mode to complete the following actions:
  • Stop the test message at breakpoints in the message flow by using the flow debugger.
  • Trace the message nodes and terminals that the test message passes through.
  • See the test message change as it passes through the message flow.
  • View a message node, where an exception occurs, and the associated exception message and trace details.
Note: If the message flow does not contain an MQOutput, HTTPReply, JMSOutput, or SOAPReply node, the Test Client stops the test after the test message is sent to the integration node. Therefore, you might not see trace events when the flow is run.

All output from the trace and debug mode is written to the Message flow test events section on the Message flow Test Events tab.

To use the Test Client in trace and debug mode, complete the following steps:

Procedure

  1. Configure the flow debug port for the integration server in the IBM® Integration Toolkit:
    1. In the Integration Nodes view, right-click the integration server with which you want to work.
    2. Click Launch Debugger.
    3. To set the Flow Debug Port, click Configure, and enter a number for the port.
    4. Click OK.
    The debugger is now enabled on the selected integration server. Click Terminate Debugger to stop the debugger.
  2. In the Test Client, click Send Message to open the Deployment Location wizard.
  3. If your integration node is not connected, click Connect. From the list in the wizard, select the integration server to which you want to deploy your message flow.
  4. Click Trace and debug.
  5. Optional: If you want the test message to stop at a breakpoint after the input node, click Stop at the beginning of the flow during debug.
  6. Click Next and modify the test settings as required.
  7. Click Finish to save the settings and deploy the message flow.

What to do next

You can modify the deployment location settings from run mode to trace and debug mode by using the Deployment Location wizard:
  1. Click Configuration in the Test Client.
  2. Click Deployment to display the deployment settings.
  3. Click Change to open the Deployment Location wizard.