Source Debugger: Tool Bar

Debugging and Analysis > Source Debugger > Source Debugger Components

Source Debugger: Tool Bar

At the top of the Source Debugger appears a tool bar similar to the one displayed following (broken into two lines to fit this page).

$image\SourceDebugToolBar.gif$

Note: As with all VTS buttons and tools, placing your mouse pointer over each button opens a tool tip that indicates the function of the button, along with its keyboard shortcut.

The buttons featured on the Source Debugger’s tool bar are identified as follows (left to right).

Back Button

$image\Back_Button.gif$

The Back button enables you to move backward through the modules you have recently viewed. You must have moved forward in the module order for the backward button to be enabled.

Note: You may also use the Alt + Left keys on your keyboard to move backward a module.

Forward Button

$image\ForwardButton.gif$

The Forward button enables you to move forward through the modules you have recently viewed. You must have moved backward in the module order for the forward button to be enabled.

Note: You may also use the Alt + Right keys on your keyboard to move forward a module.

Parent Button

$image\Parent_Button.gif$

The Parent button can be clicked to move to the parent of the module currently selected in the module tree.

Caller Button

$image\Caller_Button.gif$

The Caller button can be clicked to move to the caller of the module currently selected in the module tree.

Select Window to Debug Button

$image\Select_Window_To_Debug_Button.gif$

The Select Window to Debug button enables you to select a window to debug while your VTS application is running.

See also: Selecting an Application for Debugging

Debug Test Framework Button

$image\Test_Framework_Button.gif$

The Debug Test Framework button enables you to launch the Test Framework application that allows you to run tests on the currently selected module.

See also: Test Framework Application

Open Source File Button

$image\Open_Source_File_Button.gif$

The Open Source File button can be clicked to browse to and open a specific source file for debugging.

See also: Opening a Source Code File for Debugging

Open Dump File Button

$image\Open_Dump_File_Button.gif$

The Open Dump File button can be clicked to browse to and open a specific dump file for debugging.

See also: Viewing the Contents of a Dump File

Create Dump File Button

$image\Create_Dump_File_Button.gif$

The Create Dump File button can be clicked to create a dump file for the application being debugged.

See also: Generating a Dump File

Cut Button

$image\Cut_Button.gif$

The Cut button can be clicked to cut selected text from the source file currently being debugged.

See also: Copying and Pasting Code Using the Source Debugger

Copy Button

$image\Copy_Button.gif$

The Copy button can be clicked to copy selected text from the source file currently being debugged to the clipboard.

See also: Copying and Pasting Code Using the Source Debugger

Paste Button

$image\Paste_Button.gif$

The Paste button can be clicked to paste copied text into the source file currently being debugged.

See also: Copying and Pasting Code Using the Source Debugger

Show Module Data in New Window Button

$image\Show_Module_Data_In_New_Win.gif$

The Show Module Data in New Window button can be clicked to launch a new window that displays the objects associated with a selected module.

See also: Displaying the Contents of a Module in a Separate Window

Refresh Trees Button

$image\RefreshTrees.gif$

The Refresh Trees button enables you to refresh the module trees, ensuring that any new module instances that have been added are displayed.

See also: Refreshing the Module Tree

Sort Data Button

$image\Sort_Data_Button.gif$

The Sort Data button enables you to sort the variables, parameters, and modules in the module content window in ascending order alphabetically.

See also: Sorting Data in the Module Content Window

Sort Tree Button

$image\Sort_Tree_Button.gif$

The Sort Tree button enables you to sort the modules in the module tree in ascending order alphabetically.

See also: Sorting the Modules in the Module Tree

Hide Constants Button

$image\Hide_Constants_Button.gif$

The Hide Constants button enables you to hide any constants that are being displayed in the module content window.

See also: Hiding Constants in the Module Content Window

Show Only Parameters Button

$image\Show_Parms_Only_Button.gif$

The Show Only Parameters button enables you to command the Source Debugger to display only parameters for the currently selected module in the module content window.

See also: Displaying Parameters in the Module Content Window

Toggle Breakpoint (F9) Button

$image\Toggle_Breakpoint_Button.gif$

The Toggle Breakpoint button enables you to set a breakpoint in the code you are viewing. A breakpoint indicates to the Source Debugger that the selected application should pause execution at a certain point.

See also: Setting a Breakpoint , Setting a Data Breakpoint , and Clearing a Breakpoint

Enable/Disable Breakpoint (Ctrl + F9) Button

$image\EnabDisabBreakPtBtn.gif$

The Enable/Disable Breakpoint button allows you to disable an existing breakpoint or enable a disabled breakpoint in the code you are debugging or examining.

See also: Disabling a Breakpoint , and Enabling a Breakpoint

Breakpoint Properties (Alt + F9) Button

$image\Breakpoint_Properties.gif$

The Breakpoint Properties button can be clicked to open a window that allows you to configure a conditional breakpoint.

See also: Conditional Breakpoints

Continue (F5) Button

$image\ContinueBtn.gif$

The Continue button allows you to continue execution of the code you are debugging or examining when a breakpoint has been hit and code execution paused.

Step Into (F11) Button

$image\Step_Into_Button.gif$

The Step Into button steps you into a statement, even if it is in another source file.

See also: Stepping Into a Statement

Step Over (F10) Button

$image\Step_Over_Button.gif$

The Step Over button steps you onto the next instruction. Stepping over a subroutine call runs it at full speed and halts execution of the stepped thread at the next function or statement.

See also: Stepping Over Code

Run to Cursor (F12) Button

$image\Run_To_Cursor_Button.gif$

The Run to Cursor button places a temporary breakpoint at the highlighted line of source code. If the Source Debugger has currently halted execution of a thread and that break is highlighted in the Breakpoints tab of the Action window, that thread’s execution will be resumed at full speed. The Run to Cursor button can be used like a shortcut that will run from a breakpoint to wherever the highlighted line of code is situated.

See also: Running Code from a Breakpoint to a Selected Line

Add Watch (Ctrl + W) Button

$image\Add_Watch_Button.gif$

The Add Watch button allows you to add the currently selected variable and its value from the module content window to the currently selected tab in the watch window.

See also: Setting a Watch on a Variable

Add Watch Expression Button

$image\Add_Watch_Expression_Button.gif$

The Add Watch Expression button allows you to add the currently selected expression from the module content window to the currently selected tab in the watch window.

See also: Setting a Data Breakpoint

Remove Watch (Del)

$image\Remove_Watch.gif$

The Remove Watch button allows you to remove the currently selected variable and its value from the watch window.

See also: Removing a Watch on a Variable

Find Module

$image\Find_Module_Button.gif$

When clicked, the Find Module button opens the Find Module dialog that allows you to enter a Boolean expression and search to find all instances of the current module.

See also: Searching for a Specific Module Instance

Options

$image\Options_Button.gif$

The Options button can be clicked to launch the Options dialog that allows you to set several options that affect the way the Source Debugger appears and behaves.

See also: Source Debugger Options

Slay

$image\Slay_Button.gif$

The Slay button allows you to terminate the execution of the currently selected module instance.

See also: Slaying a Module Instance

Toggle Code Coverage

Toggles the display of code coverage (the indicator of what modules, states, statements and parameters used)

Refresh Code Coverage

Displays an up-to-date view of the code coverage.

Previous Highlight

Steps through the display to the previous statement (parameter…) highlighted as having been used by the module.

Next Highlight

Steps through the display to the next statement (parameter…) highlighted as having been used by the module.

Merge From File

Loads the code coverage record as stored in a file, into the current display. This is especially useful for team debugging where various team members are testing different parts of the code and wish to merge their results.

Merge To File

Saves the code coverage, from the current session to a file. This is especially useful for team debugging where various team members are testing different parts of the code and wish to merge their results.

Reset Code Coverage

Resets the code coverage counters to zero.

Mouse Coordinates

$image\Coords.gif$

To the far right of the Source Debugger's tool bar is the mouse coordinates section. As you move your mouse pointer around on the screen, it reports the X and Y coordinates with respect to the origin of the VTS window that the mouse pointer is over.