Set line...

Displays the Line Breakpoint window, which allows you to set a line breakpoint to stop the execution of your program at a specific line number.

The Line Breakpoint window is divided into two group headings: Required Parameters and Optional Parameters.

The Required Parameters group heading contains the following:

• Executable Entry Field

  To select a component from the Executable list:

  
  
  • Type the executable name in the entry field or open the Executable list by selecting the list button. This displays a drop-down combination box.
    
  • Highlight the executable where you want to set the breakpoint
  
  Source Entry Field

  To select a component from the Source list:

  1.
  Type the source name in the entry field or open the Source list by selecting the list button. This displays a drop-down combination box.
  2.
  Highlight the source where you want to set the breakpoint.
  
  Include File Entry Field

  If the source you selected has include files with executable statements, then the File list displays all the file names that contain executable lines.

  1.
  Type the name of the file in the entry field or open the File list by selecting the list button. This displays a drop-down combination box.
  2.
  Highlight the file where you want to set the breakpoint.
  
  Line Entry Field

  To set a line breakpoint, type the line number in the Line entry field. The breakpoint is set on the line number.

  The Optional Parameters group heading contains the following:

  • Thread Entry Field

    To select a thread ID from the Thread list:

    1.
    Open the Thread list by selecting the list button. This displays a drop-down combination box.
    2.
    Highlight the thread where you want to set the breakpoint.
    Select Every, the default, to set a breakpoint in all of the active threads in your program. The Every choice is thread independent. Select one of the individual threads to set a breakpoint in one thread only. Threads are added to the Thread list as new threads are activated.
    
    From Entry Field

    This field is used for location breakpoints, address breakpoints and load occurrence breakpoints. Type in a number to start activating the breakpoint the nth time the location is encountered.

    
    To Entry Field

    This field is used for location breakpoints, address breakpoints and load occurrence breakpoints. Type in a number to stop activating the breakpoint after the nth time the location is encountered.

    
    Every Entry Field

    This field is used for location breakpoints, address breakpoints and load occurrence breakpoints. Type in a number to indicate how often the breakpoint should be activated within the From and To range.

    
    Expression Entry Field

    If you are setting an address, function, or line breakpoint, you can also type in an expression. The execution of the program stops only if this condition tests true. For example, you could type the following:

       (i==1) || (j==k) && (k!=5)

    Note: Variables in a conditional expression associated with a function breakpoint are limited to any static or global variables that are known to the called function when the function is called. Local variables and automatic variables will not evaluate correctly.

    The maximum length of the condition is 256 characters.

    
    Defer breakpoint Check Box

    Enable the Defer breakpoint check box if you want to set a breakpoint in a module that is not currently loaded.

    If you set a deferred line breakpoint and the line is located in a template, the debugger sets the line breakpoint in all of the templates when the module is loaded.

    When a module is loaded and a deferred breakpoint has been set in the module, the state of the breakpoint changes from deferred to active. When a module is freed, any breakpoints that were set in the module change from the active state to deferred state.

    If you enter an invalid source, file or line number, the debugger will be unable to activate the breakpoint when the module is loaded. Therefore, the invalid breakpoint will remain in the deferred state even after the module is loaded.

    ---

    [Back: Breakpoints Menu Choices]
    [Next: Set function...]