# The Tracepoint Window

### Overview

The Tracepoint Window lists all the various tracepoints that exist in the program. It facilitates modifying tracepoints (make them temporary or normal, disabled or enabled) and removing tracepoints.

Tracepoint Window topics:

- Menus
  - Tracepoint Menu
  - Global Menu
- Tracepoint Display
  - Enabling/Disabling Tracepoints
  - Removing Tracepoints
  - Tracepoint Pop-up Menu

### Menus

The Tracepoint Window contains two menus, one which deals specifically with the individual tracepoints selected in the window, and one whose commands affect all tracepoints.

#### Tracepoint Menu

The Tracepoint Menu operates on the selected tracepoint only. The state of a tracepoint may be changed by selecting the desired state from the menu:

Actions
  Display the Tracepoint Dialog for this tracepoint.
Enabled
  The tracepoint is active and will stop the debugger when it is hit.
Disabled
  The tracepoint is being ignored. A disabled tracepoint will never get hit.
Remove
  Deletes the tracepoint

#### Global Menu

Items on the Global Menu affect all defined tracepoints. Users may:

Enable All
  Enable all tracepoints
Disable All
  Disable all tracepoints
Remove All
  Delete all tracepoints

#### Tracepoint Display

The Tracepoint Display is a table of tracepoints. The first column of the table (unlabeled) shows a checkbutton, indicating whether the tracepoint is enabled (checked) or disabled (unchecked). Disabled tracepoints are ignored and will not cause any actions to be performed on the target.

To use the Tracepoint Menu or the Tracepoint Pop-up Menu, first use the left mouse button to select a tracepoint from the list, then make the menu selection.

### Modifying Tracepoints

To enable a tracepoint, simply click the checkbutton in the first column of the desired tracepoint so that it is selected (checked). To disable a tracepoint, "uncheck" the checkbutton.

To remove a tracepoint, use the left mouse button to select the tracepoint to remove and use either the tracepoint Menu or the Tracepoint Pop-up Menu to select "remove". To re-install a tracepoint, use the Source Window Display.

#### Tracepoint Pop-up Menu

The Tracepoint Pop-up Menu is accessed by using the mouse cursor to select a tracepoint from the Tracepoint Display and then clicking the right button on the mouse. The Pop-up allows expert users quicker access to the functions of the Tracepoint Menu:

Actions
  Display the Tracepoint Dialog for the selected tracepoint. This allows the tracepoint's actions to viewed or edited.
Enabled
  The tracepoint is active and will causes actions to be performed on the target when it is hit
Disabled
  The tracepoint is being ignored. A disabled tracepoint will never perform any actions or be recorded in the trace buffer.
Remove
  Deletes the tracepoint
Global, Enable All
  Enable all tracepoints
Global, Disable All
  Disable all tracepoints
Global, Remove All
  Delete all tracepoints