This chapter discusses the Task View and Exception View windows that are specific to Ada code.
Select Views -> Task View from the Main View window menu bar to call up the Task View window. The Task View window is an Ada-specific view that provides you with task and call stack information. If you do not have Ada installed on your system, the Task View menu option of the Views menu is grayed out.
The Task View menu bar contains the Admin, Config, Layout, Display, and Help menus. The Help menu is the same as that described in “Help Menu” in Chapter 1. Other menus are described in the following sections.
The Admin menu contains the following options:
Active: This toggle activates the current window in a set of cloned windows.
Clone: Creates a clone of the current window. This action is not supported in the current release, and the option is grayed out.
Save As Text: Launches the Save Text dialog. This dialog allows you to save your current session as text in a file you designate.
The Config menu contains the Preferences option, which launches the Task View Preference dialog that allows you to set maximum call stack depth shown in Task View. Default depth is 32 frames.
The Layout menu contains the following toggles:
Task List: Causes only the CallStack View to be shown.
Single Task: Causes only the Process Display to be shown.
The Display menu is divided into the Task List Format and Callstack Format sections. The Task List Format toggle buttons control which buttons appear in the toggle sort list, as well as what information is displayed in the Process Display area. The Callstack Format toggles control the amount of information to be displayed in the Callstack Display area of theTask View window.
The Task View Display menu contains the following toggles:
Thread/task: Displays thread/task number. This toggle is active by default.
Status: Displays process status. This toggle is active by default.
PID: Displays PID number.
Location: Displays routine name and location in the current source file.
Arg Values: Allows you to set the argument values in the Callback Display. This toggle is active by default.
Arg Names: Allows you to set the argument names in the Callback Display. This toggle is active by default.
Arg Types: Allows you to display argument types in the Callback Display.
PC: Allows you to set the program counter (PC) in Task View.
In addition to menus, Task View also contains the following items from which you can select to vary the display:
Sort toggles: Allows you to sort the process list by Thread, Name, State, Pid, or Location, depending on which of the buttons is active. Default selection is Thread.
Process display tabs: Allows you to view a list of tasks or details of the currently running (highlighted) task.
Callstack display tabs: Allows you to view all call stack information or call stack details of the currently selected process.
Select Views -> Exception View from the Main View window menu bar to display the Exception View window. Exception View is an Ada-specific view that allows you to set traps on exceptions and control exception handling. This view works only if the Ada compiler is installed. By default, this view displays only the following predefined Ada exceptions:
Constraint errors
Program errors
Storage errors
Tasking errors
In addition, a single breakpoint is set on any unhandled exception.
The Stop boxes toggle on and off to indicate whether a trap is active.
The When control menus allow you to determine when an exception trap fires. The following choices are available:
Always: Stops any time the exception is raised.
WhenOthers: Stops when caught by a when others handler rather than an explicit handler or when unhandled.
Unhandled: Stops when the exception is unhandled.
In the un-labeled text field at the bottom right of the window you can enter a single, fully qualified Ada exception name or a single, fully qualified Ada unit name. Depending on whether the add, remove, or find mode is active; pressing Enter causes one of the following actions to occur:
add mode:
Single exception: Adds single exception to the exception list
Library unit name: Adds all exceptions found in that library unit name to the exception list
remove mode:
Single exception: Removes single exception from the exception list
Library unit name: removes all exceptions found in that library unit name from the exception list
set mode
clear mode
find mode:
Single exception: positions top of the exception list to single exception
Library unit name: positions top of the exception list to the first exception found in given library unit name
The Admin menu has the following options:
Active: Activates the current window in a set of cloned windows.
Clone: Creates a clone of the current window.
Save As Text: Launches the Save Text dialog. This dialog allows you to save your current session as text in a file you designate.
Close: Closes the current window.
The Config menu has the following options:
Load Exceptions: Opens the Load User Defined Exceptions dialog that allows you to add additional exceptions to the predefined Ada exceptions.
Save Exceptions: Opens the Save User Defined Exceptions dialog that allows you to save any user-defined exceptions to the predefined Ada exceptions.
The Display menu has the following options:
Delete All: Deletes all exception traps.
Clear All Traps: Clears all exception traps. Clearing traps is not the same as deleting traps. Clearing only temporarily affects traps while deleting removes them permanently.
Reset All Buttons: Resets all button actions.