Setting and clearing breakpoints

Setting and clearing breakpoints in a debug session allow you to control map execution during a debug session:

When ECRTP execution pauses at a breakpoint, you can observe the data values of records/fields, memory variables, or system variables at that point and monitor the change in data values as ECRTP execution progresses.

StepsSetting breakpoints

  1. Select a command or a rule where you want to set a breakpoint.

  2. Select Breakpoints | Set from the main menu, press Ctrl+B, or click the Set Breakpoints button to set the breakpoint at the highlighted command or rule. A blue dot appears to the left of the command or rule where you have set the breakpoint.

    NoteIf you set a breakpoint for a rule, all commands under that rule are set with breakpoints.

StepsSetting conditional breakpoints

You can set conditional breakpoints, which allow you to pause ECRTP execution at a breakpoint when a variable has a specific value.

  1. In ECMAP, add a new placeholder rule to your map that checks the value of a specified variable. You can do this by using the If Condition command in the placeholder rule and inserting the Do Nothing command as the only outcome in this placeholder rule.

    An example of a placeholder rule can be represented in this form:

    If variable=value Then Perform Rule rule number
    

    where variable is a Memory Variable, System Variable, or Record/Field, value is the value of variable, and rule number is the specific rule that contains the Do Nothing command.

    The placeholder rule stops map execution when it is encountered because of the Do Nothing command. You can insert any other command besides the Do Nothing command if you want specific actions to occur.

  2. In the map, add the placeholder rule to an existing rule where you want the value to be checked.

  3. Regenerate the map.

  4. Load the map in ECMAP Debugger.

  5. Set a breakpoint in the map on the placeholder you created in step 1.

  6. Run the debug session. When map execution reaches the existing rule whose value you want to check, it pauses if the value in variable matches the value you specified in the placeholder rule.

StepsClearing selected breakpoints

  1. Select the command or rule where you want to clear a breakpoint.

  2. Select Breakpoints | Clear from the main menu, press Ctrl+C, or click the Clear Breakpoint button to remove the breakpoint at the highlighted command or rule. The blue dot to the left of the command or rule is removed.

    NoteIf you clear a breakpoint for a rule, all commands under that rule have their breakpoints removed.

StepsClearing all breakpoints

  1. Select Breakpoints | Clear All from the main menu, press Ctrl+A, or click the Clear All Breakpoints button to remove all breakpoints that have been set in the map. The blue dots to the left of commands or rules that have breakpoints are removed.