Debugging mappings

When message flow processing has paused at a breakpoint that you have set in source code within a node that contains mappings, you can view the mapping routines and modify user-defined variables in the Flow Debugger.

Before you start

To complete this task, you must have completed the following tasks:

Mapping routines are implemented in ESQL. If you step into the code, you can choose either to step through the ESQL code, or to step through the mappings.

  1. Switch to the Debug perspective.
  2. In the Debug view:
    • either, click Step into Source Code Step into code on the toolbar.
    • or, right-click the flow stack frame, then click Step into Step into.
    The Message Mapping editor opens with the mapping routine highlighted in both the Mapping editor and the Outline view.
  3. To use breakpoints on mapping lines:
    1. In the Message Mapping Editor, select the line for the mapping command that you want to use, right-click the space beside it and select from the menu to add or disable a breakpoint. (Alternatively, double-click the same space to add or remove a breakpoint.)
    2. Select from the menu to create, delete, or restrict the breakpoint, in a similar way to normal debugger breakpoints, as described in: Working with breakpoints in the flow debugger.

    You cannot set a breakpoint on a comment line or a blank line.

  4. Check the mapping routines by stepping through the mappings.

    In the Debug view, the stack frame shows the list of mapping commands and the current command. The Variables view shows your user-defined mapping variables and the current message. You can change the values of user-defined variables.

Message flow processing continues until the next breakpoint that is set in the logical processing of the current message. If there is no further enabled breakpoint at which the flow instance can pause, processing runs to completion and the flow instance is removed from the Debug view.

Next:

If you have finished debugging, you can remove the breakpoints, or end the debugging session:
Related concepts
Flow debugger overview
Debug perspective
Message Mapping editor
Related tasks
Working with breakpoints in the flow debugger
Debug: stepping through source code
Related reference
Flow debugger shortcuts
Flow debugger icons and symbols
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Last updated : 2009-01-07 15:21:55

ag20510_