Power GUI Programming with VisualAge C++/powergui.iso/trialva/ibmcppw/help/cppwdhl3.hlp

OS/2 Help File | 1996-02-16 | 173.8 KB | 7,581 lines

ΓòÉΓòÉΓòÉ 1. Notices ΓòÉΓòÉΓòÉ

References in this online information to IBM products, programs, or services do
not imply that IBM intends to make these available in all countries in which
IBM operates. Any reference to an IBM licensed program in this publication is
not intended to state or imply that only IBM's licensed program may be used.
Any functionally equivalent product, program or service that does not infringe
any of IBM's intellectual property rights may be used instead of the IBM
product, program, or service. Evaluation and verification of operation in
conjunction with other products, except those expressly designated by IBM, is
the user's responsibility.

IBM may have patents or pending patent applications covering subject matter in
this document. The furnishing of this document does not give you any license to
these patents.  You can send license inquiries, in writing, to the IBM Director
of Commercial Relations, IBM Corporation, Purchase, NY 10577.

This publication could contain technical inaccuracies or typographical errors.


ΓòÉΓòÉΓòÉ 1.1. Trademarks and Service Marks ΓòÉΓòÉΓòÉ

The following terms, denoted by an asterisk (*) in this online documentation,
are trademarks of the IBM Corporation and other companies in the United States
and/or other countries:

 o IBM

 o Windows


ΓòÉΓòÉΓòÉ 1.1.1. Debug on Demand Feature ΓòÉΓòÉΓòÉ

Debug on demand enables you to open a debugging session whenever an error
occurs in your application. For example, if an unhandled exception occurs and
the debug on demand feature is enabled, the debugger is notified that an error
has occurred.  The debugger starts and attaches to your application at the
point of fault.  This can save you time because you do not have to re-create
errors. Your application will run at full speed without any interference from
the debugger until an exception is encountered. The debug on demand feature is
also useful when you are debugging asserts in place.

VisualAge for C++ can start debug on demand for any application that fails
while it is running, even if the application does not contain debug
information. With debug on demand, it is possible to find and fix the problem
in the application and let it continue running.

Note:   This feature is only available from Windows NT.

To enable the debug on demand feature, type the following at a Windows command
prompt:

   dod path_name idebug
where, path_name is the location where idebug.exe is installed and idebug is
specified as the default debugger. For example, you would type:

   dod e:\idebug

To remove the default debugger, type the following:

   dod /u


ΓòÉΓòÉΓòÉ 2. Process List Window ΓòÉΓòÉΓòÉ

The Process List window allows you to attach to a specific process that you
want to debug.

Note:   This feature is not available for Windows95.

To select a process to debug:

  1. Type the full path name of the process you want to debug in the Process
     path entry field.
  2. Select the process you want to debug from the list.
  3. Select the Attach push button.

 You can also double-click on the process name to select it. However, you still
 have to type the full path name of the process you want to debug in the
 Process path entry field.

 Note:   If you are currently debugging a process, the process will be
 terminated when a new process is attached.  You can only debug one process at
 a time. Do not attach to operating system processes. This could cause
 unpredictable results.

 Use program profile Check Box

 Select the Use program profile check box to start the debugging session with
 program profile information.

 Push Buttons

 Attach
           Attaches the program you selected so that you can begin debugging.

 Refresh
           Lists the processes that are currently running.

 Cancel
           Closes the window without accepting any changes or selections that
           you may have made.

 Help
           Displays help information for this window.


ΓòÉΓòÉΓòÉ 3. Debug Session Control Window ΓòÉΓòÉΓòÉ

The Debug Session Control window is the control window of the debugger and
displays during the entire debugging session.  This window contains tool
buttons which allow for easy access to frequently used features.  It also
contains a status line which allows you to see the status of the debugger at
all times.  The window is divided into two panes which are sizeable. One pane
contains the threads and the other pane contains the components for the program
you are debugging.

The Threads pane contains the threads. It shows the state of the threads that
are started by your program.

To display the state of a thread, select the plus icon to the left of the
thread.  You may enable or disable the highlighted thread in the Threads list
by toggling the Thread enabled choice from the Run menu. When a check mark
symbol displays, threads are enabled and the debugger allows the highlighted
thread to execute. When the check mark symbol does not display, threads are
disabled and do not executed.  You can also double-click on Enabled to change
the thread status to Disabled.

Thread popup menu

The Thread popup menu contains choices to take you to different debugger
windows. The popup menu is shown when you click mouse button 2 with the mouse
pointer on a highlighted thread name.

The following are the popup choices:

 Execution point
           Open a source window containing the next line to be run.

 Disable
           Disable a thread stopping it from being executed.

 Enable
           Enable a thread allowing it be executed.

 Registers
           Display the Register window.

 Call stack
           Display the Call Stack window.

 Local variables
           Display the Local Variables window.

 The components pane shows the path name and process ID of the executable file
 that is associated with the program you are debugging.

 Note:   For Windows95, the components pane only shows the path name.

 To display a list of object files contained within an executable file, select
 the plus icon to the left of the executable file name. To open a source window
 of an object file, double-click on the object file name.

 To display a list of functions for a specific object file, select the plus
 icon to the left of the object file name. To open a source window to a
 specific function, double-click on the function name.

 Note:   If you have more than one source file that contains executable code,
 expanding the object file will display the other source files. Click on any of
 the source files to display the functions for that particular source file.

 Object or Function Popup Menu

 The Object or Function Popup Menu contains a choice that allows you to display
 the object or function in a source window. The popup menu displays when you
 click mouse button 2 with the mouse pointer on a highlighted object or
 function name.

 The choices in the popup menu are:

 View
           Show the object or function in the Source window.

 Set function breakpoint
           Set a function breakpoint to stop the execution of your program
           after calling a specific function in the highlighted thread.

 Set breakpoint (every)
           Set a breakpoint to stop the execution of your program after calling
           the specific function in all threads.

 You can display any component by double-clicking on the component name that
 displays in the components pane or by highlighting the component name. The
 Source window will display if the source is available.

 You specify which components display in the components list by selecting
 Options -> Window Settings -> Display style. When the Show all components
 check box is enabled, only components compiled and linked with debugging data
 are listed. Otherwise, all components are listed.

 There are tool buttons active in this window. Double-click on any of the
 following for a description of that button.

 You can also access any debugger window that is already open and hidden or
 minimized by selecting the menu choice that displays that window from the
 Windows menu.

 Menu Bar Summary

 File
           Start or end the debugging session and control the source windows.

 Breakpoints
           Set and manipulate breakpoints in your program.

 Monitors
           Select other debugger windows.

 Run
           Execute the program, halt execution, or enable and disable threads.

 Options
           Access various utility windows where you can set debugger options.
           These debugger options control the various debugger windows.

 Windows
           Displays the active debugger windows.

 Help
           Displays online help that compliments the information you get when
           you press F1 or select the Help push button.

 Related Information

 o Source Windows
 o Register Window
 o Call Stack Window
 o Local Variables Window
 o Program Monitor Window
 o Private Monitor Window
 o Popup Expression Window
 o Storage Window
 o Breakpoint List Window
 o Monitor Properties


ΓòÉΓòÉΓòÉ <hidden> Execution Point Choice ΓòÉΓòÉΓòÉ

Select the Execution point choice to locate the next line to be run. When you
select Execution point, a source window containing the next line to be run is
shown.


ΓòÉΓòÉΓòÉ <hidden> Call Stack Choice ΓòÉΓòÉΓòÉ

Select the Call stack choice to display the Call Stack window.


ΓòÉΓòÉΓòÉ <hidden> Disable Choice ΓòÉΓòÉΓòÉ

Select the Disable choice to disable the highlighted thread.  This stops the
thread from being executed.


ΓòÉΓòÉΓòÉ <hidden> Enable Choice ΓòÉΓòÉΓòÉ

Select the Enable choice to allow the highlighted thread to be executed.


ΓòÉΓòÉΓòÉ <hidden> Registers Choice ΓòÉΓòÉΓòÉ

Select the Register choice to display the Registers window.


ΓòÉΓòÉΓòÉ <hidden> Local Variables Choice ΓòÉΓòÉΓòÉ

Select the Local variables choice to display the Local Variables window.


ΓòÉΓòÉΓòÉ <hidden> View Choice ΓòÉΓòÉΓòÉ

Select the View choice to show the highlighted object or function in a source
window.


ΓòÉΓòÉΓòÉ <hidden> Set Function Breakpoint Choice ΓòÉΓòÉΓòÉ

Select the Set function breakpoint choice to set a function breakpoint on the
highlighted variable or expression in the selected thread. A function
breakpoint stops the execution of your program after calling a specific
function.

To set a function breakpoint:

  1. Highlight the variable or expression.
  2. Select the Set function breakpoint choice.

 The Function Breakpoint window displays.


ΓòÉΓòÉΓòÉ <hidden> Set Breakpoint (Every) Choice ΓòÉΓòÉΓòÉ

Select the Set breakpoint (every) choice to set a breakpoint on the highlighted
variable or expression in all the threads. A function breakpoint stops the
execution of your program after calling a specific function.

To set the breakpoint:

  1. Highlight the variable or expression.
  2. Select the Set breakpoint (every) choice.


ΓòÉΓòÉΓòÉ 3.1. File Menu ΓòÉΓòÉΓòÉ

Select choices from the File menu of the Debug Session Control window to start
a program, find the current line, replace your current program file with a
program file from another location or with a different name, restart the
current debugging session, restart a previous debugging session for this
program or end the debugging session.

Menu Summary

 Open new source...
           Display a new source file.

 Find function...
           Open a source window to a particular function.

 Where is execution point
           Open a source window containing the next line to be executed.

 Startup
           Start the program you want to debug after ending the current
           program.

 Process list...
           Open the Process List window and attach to the process that you want
           to debug.

 Close debugger
           End the debugging session.


ΓòÉΓòÉΓòÉ 3.1.1. Open New Source Choice ΓòÉΓòÉΓòÉ

Select the Open new source... choice to open a new source file. When you select
Open new source..., the Open New Source window displays.


ΓòÉΓòÉΓòÉ 3.1.2. Find Function Choice ΓòÉΓòÉΓòÉ

Select the Find function... choice to open a source window to a particular
function. When you select Find function..., the Find Function window displays.


ΓòÉΓòÉΓòÉ 3.1.3. Where Is Execution Point Choice ΓòÉΓòÉΓòÉ

Select the Where is execution point choice to locate the next line to be
executed in the thread.


ΓòÉΓòÉΓòÉ 3.1.4. Startup Choice ΓòÉΓòÉΓòÉ

Select the Startup choice to start a program for debugging. Startup allows you
to debug another program, while Restart allows you to restart the current
debugging session on the existing program.

When you select Startup, the Startup window displays.


ΓòÉΓòÉΓòÉ 3.1.5. Process List Choice ΓòÉΓòÉΓòÉ

Select the Process list... choice to select the process that you want to debug.

When you select Process list..., the Process List window displays.

Note:   This choice is not available for Windows95.


ΓòÉΓòÉΓòÉ 3.1.6. Close Debugger Choice ΓòÉΓòÉΓòÉ

Select the Close debugger choice to close your current debugging session.  When
you select Close debugger, the Close Debugger message box prompts you to
confirm that you want to end the debugging session.


ΓòÉΓòÉΓòÉ 3.2. View Choice ΓòÉΓòÉΓòÉ

Select the View choice to show the highlighted object or function in a source
window.


ΓòÉΓòÉΓòÉ 3.3. Breakpoints Menu ΓòÉΓòÉΓòÉ

Select choices from the Breakpoints menu to set breakpoints and stop the
execution of your program at any point. You can set as many breakpoints as you
want.

Breakpoints can be set from the Debug Session Control window or from the source
window. When you set a breakpoint in the source window of your program, it is
reflected in the other views.

There are five types of breakpoints that you can set. You can customize the
breakpoints using the various breakpoint windows.

Menu Summary

 Set line...
           Set a line breakpoint to stop the execution of your program at a
           specific line number.

 Set function...
           Set a function breakpoint to stop the execution of your program
           after calling a specific function.

 Set address...
           Set an address breakpoint to stop the execution of your program at a
           specific address.

 Set change address...
           Set a change address breakpoint to stop the execution of your
           program when contents of memory at a given address changes.

 Set load occurrence...
           Set a load occurrence breakpoint to stop the execution of your
           program after loading a DLL.

 List
           List the breakpoints that have been set.

 Delete all
           Delete all breakpoints.

 You can also set simple line breakpoints. Double-click on one of the following
 to learn how to set or clear simple line breakpoints:

 o Setting simple line breakpoints

 o Clearing simple line breakpoints


ΓòÉΓòÉΓòÉ 3.3.1. Set Line Choice ΓòÉΓòÉΓòÉ

Select the Set line choice to stop the execution of your program at the line
number you select. When you select Set line, the Line Breakpoint window
displays.

You can also set simple line breakpoints. Double-click on one of the following
for the procedures you use to set or clear simple line breakpoints:

 o Setting simple line breakpoints

 o Deleting simple line breakpoints.


ΓòÉΓòÉΓòÉ 3.3.2. Set Function Choice ΓòÉΓòÉΓòÉ

Select the Set function choice to stop the execution of your program after the
function that you specify is called. When you select Set function, the Function
Breakpoint window displays.


ΓòÉΓòÉΓòÉ <hidden> Function Breakpoint Window ΓòÉΓòÉΓòÉ

Use the Function Breakpoint window to set a function breakpoint.  Type the name
of the function. If a function is overloaded, then a window displays with a
list of all the overloaded function names. Select one of the functions from the
list.

For a description of types of data you can enter in the entry fields,
double-click on one of the following topics:

 o Executable (optional)

 o Source (optional)

 o Function

 o Expression

 o Thread

 o From

 o To

 o Every.

 Debugging information only Check Box

 Enable this check box if you want to search only the object files that contain
 debugging data.

 Case sensitive Check Box

 Enable this check box if you want to search for the string exactly as typed.
 Disable this check box if you want to search for both uppercase and lowercase
 characters.

 Defer breakpoint Check Box

 Enable this check box if you want to set a breakpoint in a DLL that is not
 currently loaded.

 Note:   If your application consists of an EXE or preloaded DLLs, do not use
 this choice. If your application consists of DLLs that are dynamically loaded,
 you must use this choice to set breakpoints in the dynamically loaded DLLs
 that have not been loaded yet.

 If you enter an invalid source file or invalid function, the debugger is
 unable to activate the breakpoint when the DLL is loaded. Therefore, the
 invalid breakpoint remains in the deferred state even after the DLL is loaded.

 The state of the breakpoints will change from active state to deferred state
 depending on whether the DLL has been loaded or not.  For example, if the DLL
 has been loaded and a deferred breakpoint has been set, the breakpoint becomes
 active. If you stop the program and the DLL has been freed, the breakpoint
 changes from active state to deferred state. If you set a deferred breakpoint
 in a function and that function is overloaded, the debugger sets the
 breakpoint in all of the overloaded functions when the DLL is loaded.

 Refer to the Breakpoints window for the current state of the breakpoints that
 have been set.

 Setting a Function:

 To set a function breakpoint for the function my_func, type the following in
 the Function entry field.

       my_func

 Note:   You cannot set a function breakpoint to a function name that was
         defined using the define preprocessor directive.

 Select the appropriate push button to continue.


ΓòÉΓòÉΓòÉ 3.3.3. Set Address Choice ΓòÉΓòÉΓòÉ

Select the Set address choice to stop the execution of your program at the
selected address. When you select Set address, the Address Breakpoint window
displ


ΓòÉΓòÉΓòÉ <hidden> Address Breakpoint Window ΓòÉΓòÉΓòÉ

Use the Address Breakpoint window to set an address breakpoint.  Type in the
address that represents the location in your program where you want to set the
breakpoint.

Note:   The address can be either segmented or flat format.

To set an address breakpoint for the address 000A1FCC, you would type the
following in the Address or expression entry field.

     A1FCC

For a description of types of data you can enter in the window entry fields,
double-click on any of the following topics:

 o Thread

 o Every

 o From

 o To

 o Expression

 Select the appropriate push button to continue.


ΓòÉΓòÉΓòÉ 3.3.4. Set Change Address Choice ΓòÉΓòÉΓòÉ

Select the Set change address choice to stop the execution of your program
after the contents of memory at a given address changes.  When you select Set
change address, the Change Address Breakpoint window displays.


ΓòÉΓòÉΓòÉ <hidden> Change Address Breakpoint Window ΓòÉΓòÉΓòÉ

Use the Change Address Breakpoint window to set a change address breakpoint.
To do so, type a hexadecimal address or an expression and select the range of
bytes. The range of bytes can only be 4.

To set a change address breakpoint, complete the fields as follows:

Address or expression Entry Field

Type the following in the Address or expression entry field to set a change
address breakpoint for the expression 0xA1FCC.

     0xA1FCC

Note:   If you type ABC in the Address or expression entry field, and there is
a variable named ABC, it uses the value of the variable instead of the hex
value ABC. Also, you can type &a in the Address or expression entry field to
set the breakpoint on the address of a variable a.

Warning:  If you set a change address breakpoint that is on the call stack, you
should remove the breakpoint prior to leaving the routine associated with the
breakpoint.  Otherwise, when you return from the routine, the routine's stack
frame will be removed from the stack leaving the breakpoint intact.  Any other
routine that gets loaded on the stack will then contain the breakpoint.

For a description of types of data you can enter in the other window entry
fields, double-click on one of the following topics:

 o Thread

 o From

 o To

 o Every

 Select the appropriate push button to continue.

 Related Information

 o Expression Language Guidelines.


ΓòÉΓòÉΓòÉ 3.3.5. Set Load Occurrence Choice ΓòÉΓòÉΓòÉ

Select the Set load occurrence choice to stop the execution of your program
after the DLL that you specify is loaded. When you select Set load occurrence,
the Load Occurrence Breakpoint window displays.


ΓòÉΓòÉΓòÉ <hidden> Expression Language Guidelines ΓòÉΓòÉΓòÉ

The following are the rules for evaluating data within these fields.

 0x0100000
           Treated as hex number (per language rules of C)

 0100000
           Treated as hex number (C language would treat as octal)

 100000
           Treated as hex number (C language would treat as decimal)

 0027:0100
           Treated as segmented hex address
           (C language would treat as octal segmented address)

 0100:1002
           Treated as segmented hex address
           (C language would treat as octal/hex segmented address)

 0x287e8
           Treated as hex number (per language rules of C)

 287e8
           Treated as hex number
           (C would treat as floating point 287 * 10^8)

 abad
           Treated as hex number, unless user has a variable defined with this
           name in the current scope.  If that variable can be represented as a
           hexadecimal value, the value of the variable will be used.
           Otherwise, the hex value of 0xabad will be used.  You can force this
           to be treated as hex value by using the prefix 0x.  For example,
           0xABAD.

 All other strings will be evaluated strictly by the language rules that apply
 to the part that is currently in scope.

 EBP + 10
           Treated as value of EBP register plus decimal 10.

 10 + 5
           Treated as decimal 15.

 10 + 6F
           Cannot be evaluated.

 Values for expressions that cannot have a hexadecimal representation will not
 be supported.  The following error message will be displayed for cases of
 invalid expression.

     Invalid address


ΓòÉΓòÉΓòÉ <hidden> Load Occurrence Breakpoint Window ΓòÉΓòÉΓòÉ

Use the Load Occurrence Breakpoint window to set a load occurrence breakpoint.
Type the name of the DLL in the DLL file name entry field. Execution stops when
the DLL is loaded.

DLL file name Entry Field

To set a load occurrence breakpoint when MY.DLL is loaded, type the following
in the DLL file name entry field:

     MY

or

     MY.DLL

For a description of types of data you can enter in the other window entry
fields, double-click on one of the following topics:

 o Thread

 o From

 o To

 o Every

 Select the appropriate push button to continue.


ΓòÉΓòÉΓòÉ <hidden> Include file (optional) ΓòÉΓòÉΓòÉ

If the source you selected has include files with executable statements, then
use the down arrow to display the list of file names that contain executable
lines.

  1. Open the list by selecting the arrow with your mouse.

  2. Highlight the file where you want to set the breakpoint.

     OR

  3. Type the name of the file in the Include file (optional) entry field.


ΓòÉΓòÉΓòÉ <hidden> Function List ΓòÉΓòÉΓòÉ

Type in the name of the function where you want to set the breakpoint or select
a function from the Function list:

  1. Open the Function list by selecting the arrow with your mouse.

  2. Highlight the function you want to set the breakpoint.

     OR

  3. Type the name of the function in the entry field.


ΓòÉΓòÉΓòÉ <hidden> 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 cannot be used.

The maximum length of the condition is 256 characters.


ΓòÉΓòÉΓòÉ <hidden> Thread List ΓòÉΓòÉΓòÉ

To select a thread ID from the Thread list:

  1. Open the Thread list by selecting the arrow with your mouse.

  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.


ΓòÉΓòÉΓòÉ <hidden> Every Entry Field ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ <hidden> From Entry Field ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ <hidden> To Entry Field ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 3.3.6. List Choice ΓòÉΓòÉΓòÉ

Select the List choice to list the breakpoints that you have set.  When you
select List, the Breakpoints List window displays.


ΓòÉΓòÉΓòÉ 3.3.7. Delete All Choice ΓòÉΓòÉΓòÉ

Select the Delete all choice to delete all the breakpoints that you have set.

When you select Delete all, an information box displays for verification that
you want to delete all the breakpoints.


ΓòÉΓòÉΓòÉ 3.4. Monitors Menu ΓòÉΓòÉΓòÉ

Select choices from the Monitors menu to display other debugger windows.

Menu Summary

 Call stack
           Displays the Call Stack window to allow you to monitor the call
           stack for a particular thread.

 Registers
           Displays the Registers window to allow you to monitor registers and
           flags for a particular component or thread.

 Storage
           Displays the Storage window to allow you to monitor the storage in
           your program.

 Local variables
           Displays the local variables for the programs current function.


ΓòÉΓòÉΓòÉ 3.4.1. Passthru Choice ΓòÉΓòÉΓòÉ

Select the Passthru choice to diplay messages and information from the
micro-kernel.  It also allows you to send commands (usually functions to be
executed) to the micro-kernel.


ΓòÉΓòÉΓòÉ 3.5. Run Menu ΓòÉΓòÉΓòÉ

Select choices from the Run menu to execute your program, halt execution, or
enable or disable threads.

Menu Summary

 Run
           Execute the program from the current line until a breakpoint is
           encountered or the program ends.

 Halt
           Interrupt the program you are debugging.

 Restart
           Restart the current debugging session.

 Hide debugger on Run
           Hides the debugger windows while your application is running.

 Check heap when stopping
           Check all memory blocks allocated or freed by the compiler debug
           memory management functions to make sure that overwriting has not
           occurred outside the bounds of allocated blocks and free memory
           blocks have not been overwritten.

 Thread enabled
           Enable or disable threads.


ΓòÉΓòÉΓòÉ 3.5.1. Run Choice ΓòÉΓòÉΓòÉ

Select the Run choice to execute the program, including all enabled threads,
from the current line until a breakpoint is encountered or the program ends.


ΓòÉΓòÉΓòÉ 3.5.2. Halt Choice ΓòÉΓòÉΓòÉ

Select the Halt choice to interrupt the program that you are debugging.


ΓòÉΓòÉΓòÉ 3.5.3. Restart Choice ΓòÉΓòÉΓòÉ

Select the Restart choice to start the debugging session again. Restart allows
you to restart the current debugging session on the existing program, while
Startup allows you to debug another program.


ΓòÉΓòÉΓòÉ 3.5.4. Hide Debugger on Run Choice ΓòÉΓòÉΓòÉ

Select the Hide debugger on Run choice to hide the debugger windows when your
program is running.


ΓòÉΓòÉΓòÉ 3.5.5. Check Heap When Stopping Choice ΓòÉΓòÉΓòÉ

Select the Check heap when stopping choice to check all memory blocks allocated
or freed by the compiler debug memory management functions.  This makes sure
that overwriting has not occurred outside the bounds of allocated blocks and
free memory blocks have not been overwritten.

When Check heap when stopping choice is enabled, each time the program stops,
the heap is checked.  For example, stopping at a breakpoint or at the end of a
step command would cause the heap check to be performed. If a heap error is
detected, your application terminates. The Termination window displays showing
the source line number where the application stopped and the heap check was
performed.

Notes

 o For the Check heap when stopping choice to work, you have to compile your
   application using the Tm+ compiler option.

 o If you enable the Check heap when stopping choice and you run your
   application to termination and the application contains a heap error, the
   heap check is not made. To check the heap just before termination, set a
   breakpoint on the last line of your application.


ΓòÉΓòÉΓòÉ 3.5.6. Thread Enabled Choice ΓòÉΓòÉΓòÉ

Select the Thread enabled choice so that the thread that is highlighted in the
Threads box is executed when the program runs.

When threads are enabled, a check mark symbol displays beside the Thread
enabled choice.  When threads are not enabled, a check mark symbol is not
displayed and the highlighted thread is not executed when the program runs.


ΓòÉΓòÉΓòÉ 3.6. Options Menu ΓòÉΓòÉΓòÉ

Select choices from the Options menu of the Debug Session Control window to
control how and what the debugger windows display.

Menu Summary

 Window settings
           Control how the items in the Debug Session Control window display.

 Debugger settings
           Display windows to control the debugger windows.


ΓòÉΓòÉΓòÉ 3.6.1. Window Settings Cascading Choice ΓòÉΓòÉΓòÉ

Select choices from the Window settings choice to modify the characteristics of
the Debug Session Control window.

Menu Summary

 Fonts
           Select the font you want to use for the text displayed in the active
           window.

 Display style...
           Select the debugger settings you want to use.

 Restore defaults
           Reset all of the window settings to their original settings.

 Tool buttons
           Enable or disable buttons from being displayed in the window.

 Hover help
           Enable or disable the hover help from being displayed in the window.

 Infoarea
           Enable or disable the information area from being displayed in the
           window.


ΓòÉΓòÉΓòÉ 3.6.2. Fonts Choice ΓòÉΓòÉΓòÉ

Select the Fonts choice to choose the font you want to use for the text that
displays in the active window.


ΓòÉΓòÉΓòÉ 3.6.3. Display Style Choice ΓòÉΓòÉΓòÉ

Select the Display style choice to set the style of the Debug Session Control
window. When you select Display style, the Display Style window is shown.


ΓòÉΓòÉΓòÉ <hidden> Display Style Window ΓòÉΓòÉΓòÉ

Use the Display Style window to select what you want displayed in the Debug
Session Control window.

Show all components Check Box

If you enable this check box, all the components will be displayed. If not
enabled, only components compiled and linked with debugging data are listed.

Show module path Check Box

If you enable this check box, the path name and Process ID will be be
displayed.

Sort components Check Box

If you enable this check box, the components will be sorted in alphabetical
order.

Sort threads Check Box

If you enable this check box, the threads will be sorted in numerical order.

Show titles Check Box

If you enable this check box, the titles which are Threads and the module path
will be displayed.

Show status line Check Box

If you enable this check box, the status line will be displayed.  This shows
the debugger state


ΓòÉΓòÉΓòÉ 3.6.4. Restore Defaults Choice ΓòÉΓòÉΓòÉ

Reset all of the Debug Session Control window settings to their original
settings. This includes the font, the style settings, and the presentation of
tool buttons.


ΓòÉΓòÉΓòÉ 3.6.5. Tool Buttons Choice ΓòÉΓòÉΓòÉ

Select the Tool buttons choice if you want the tool buttons to be shown in the
window.

The tool buttons provide quick and easy access to frequently used features of
the debugger. If this choice is enabled, a check mark symbol displays beside
the Tool buttons choice and buttons display.


ΓòÉΓòÉΓòÉ 3.6.6. Hover Help Choice ΓòÉΓòÉΓòÉ

Select the Hover help choice if you want the hover help to be shown in the
window.

The hover help provides the name of the tool button.


ΓòÉΓòÉΓòÉ 3.6.7. Infoarea Choice ΓòÉΓòÉΓòÉ

Select the Infoarea choice if you want the information area to be shown in the
window.

The information area, which is located at the bottom of the window, provides a
brief description of each menu item.


ΓòÉΓòÉΓòÉ 3.6.8. Debugger Settings Cascading Choice ΓòÉΓòÉΓòÉ

Select choices from the Debugger settings cascading choice to set various
debugger options that control how the debugger windows display. These settings
affect the behavior of the debugger and remain in effect for the duration of
the debugging session.

Menu Summary

 Debugger properties...
           Select the view that is to be displayed when the debugger starts and
           how to process the views.

 Monitor properties...
           Select the settings for the variable monitor windows.

 Default data representation
           Select how you want your data displayed in the monitor windows.

 Program profiles
           Change the location, save, or delete program profiles.

 Exception filtering...
           Select exceptions that you want the debugger to recognize.

 Save debugger window positions
           Save the position and sizes of all debugger windows.

 Global font change...
           Change the font in the debugger windows.

 Enable window cascading
           Enable or disable the overlapping of debugger windows.

 Display tool buttons
           Enable or disable buttons from being displayed in all of the
           debugging windows.

 Display hover help
           Enable or disable the hover help from being displayed in all of the
           debugging window.

 Display inforarea
           Enable or disable the information area from being displayed in all
           of the debugging windows.

 Place tool buttons on title bar
           Enable or disable the tool buttons from being displayed in the title
           bar of all the debugging windows.


ΓòÉΓòÉΓòÉ 3.6.9. Debugger Properties Choice ΓòÉΓòÉΓòÉ

Select the Debugger properties choice to determine how your threads and source
files initially display and how they are handled when they stop or are no
longer active. When you select Debugger properties, the Debugger Properties
window displays.


ΓòÉΓòÉΓòÉ 3.6.10. Monitor Properties Choice ΓòÉΓòÉΓòÉ

Select the Monitor Properties choice to select the settings for monitoring
variables or expressions.

When you select Monitor properties, the Monitor Properties window displays.


ΓòÉΓòÉΓòÉ 3.6.11. Default Data Representation Cascading Choice ΓòÉΓòÉΓòÉ

When you select Default data representation, a cascaded menu displays with
language choices.  This lets you change the default representation for a data
type in the language that you select.


ΓòÉΓòÉΓòÉ 3.6.11.1. System Choices ΓòÉΓòÉΓòÉ

Select the System choice to change the default representation of the math
coprocessor registers. This choice is language independent.

When you select the System choice, the Default Representation window displays.


ΓòÉΓòÉΓòÉ 3.6.11.2. Language Choices ΓòÉΓòÉΓòÉ

Select a language to change the default representation of the selected data
type. For example, you can change the default representation for an integer in
the C language from decimal to hexadecimal.

When you select System, the Default Representation window displays.


ΓòÉΓòÉΓòÉ 3.6.11.3. Language Choices ΓòÉΓòÉΓòÉ

Select a language to change the default representation of the selected data
type. For example, you can change the default representation for an integer in
the C language from decimal to hexadecimal.

When you select System, the Default Representation window displays.


ΓòÉΓòÉΓòÉ 3.6.11.4. Language Choices ΓòÉΓòÉΓòÉ

Select a language to change the default representation of the selected data
type. For example, you can change the default representation for an integer in
the C language from decimal to hexadecimal.

When you select System, the Default Representation window displays.


ΓòÉΓòÉΓòÉ 3.6.11.5. Language Choices ΓòÉΓòÉΓòÉ

Select a language to change the default representation of the selected data
type. For example, you can change the default representation for an integer in
the C language from decimal to hexadecimal.

When you select System, the Default Representation window displays.


ΓòÉΓòÉΓòÉ 3.6.12. Program Profiles Cascading Choice ΓòÉΓòÉΓòÉ

Select the Program profiles cascading choice to specify where you want the
program profiles changed, replaced or delete program profiles.

Menu Summary

 Select information
           Select the information to be saved in the program profile.

 Delete program profiles
           Delete profile information for a program that you have debugged.

 Change location
           Change the location of the files that hold the debugger settings.


ΓòÉΓòÉΓòÉ 3.6.13. Select Information Choice ΓòÉΓòÉΓòÉ

Select the Select information choice to indicate what information you want
saved in the program profiles.  You may save breakpoints, breakpoint list
windows, settings for the Debug Session Control window, monitors, stack, and
source views.

When you select Select information, the Select information window displays.


ΓòÉΓòÉΓòÉ 3.6.14. Delete Program Profiles Choice ΓòÉΓòÉΓòÉ

Select the Delete program profiles choice to delete the profile information for
a program that you have previously debugged.

When you select Delete program profiles, the Delete Program Profiles window
displays.


ΓòÉΓòÉΓòÉ 3.6.15. Change Location Choice ΓòÉΓòÉΓòÉ

Select the Change location choice to specify where you want the profile
information file stored. The debugger program profile information file contains
your selections for most of the debugger settings and information. You choose
whether or not you want your selections saved for the next debugging session by
selecting Save settings when you make your selections in an option window.

When you select Change location, the Change Location window displays.


ΓòÉΓòÉΓòÉ 3.6.16. Exception Filtering Choice ΓòÉΓòÉΓòÉ

Use the Exception filtering choice to select the exceptions that you want the
debugger to recognize.

When you select Exception filtering, the Exception Filtering window displays.


ΓòÉΓòÉΓòÉ 3.6.17. Save Debugger Window Positions Choice ΓòÉΓòÉΓòÉ

Use the Save debugger window positions choice to save the window positions.


ΓòÉΓòÉΓòÉ 3.6.18. Global Font Change Choice ΓòÉΓòÉΓòÉ

Select the Global font change choice to change the font in the debugger
windows.

When you select Global font change, the Font window displays.

Note:   The Source window will not change.


ΓòÉΓòÉΓòÉ 3.6.19. Enable Window Cascading Choice ΓòÉΓòÉΓòÉ

When you enable this choice, successive windows that are opened overlap each
other on the screen. However, they are cascaded so that you can see the
underlying windows. When this choice is disabled, successive windows cover
previously displayed windows so that you do not see the underlying windows.


ΓòÉΓòÉΓòÉ 3.6.20. Display Tool Buttons Choice ΓòÉΓòÉΓòÉ

Select the Display tool buttons choice if you want the tool buttons to be shown
in all of the debugging windows.


ΓòÉΓòÉΓòÉ 3.6.21. Display Hover Help Choice ΓòÉΓòÉΓòÉ

Select the Display hover help choice if you want the hover help to be shown in
all of the debugging windows.


ΓòÉΓòÉΓòÉ 3.6.22. Display Infoarea Choice ΓòÉΓòÉΓòÉ

Select the Display infoarea choice if you want the information area to be shown
in all of the debugging windows.


ΓòÉΓòÉΓòÉ 3.6.23. Place Buttons on Title Bar Choice ΓòÉΓòÉΓòÉ

Select the Place buttons on the title bar choice if you want the buttons shown
in the title bar.


ΓòÉΓòÉΓòÉ 3.7. Windows Menu ΓòÉΓòÉΓòÉ

Select the Windows menu to display a list of all the open debugger windows.

Menu Summary

 Local variables
           Display the local variables for the current line of the program.

 Registers
           Monitor registers and flags for a particular thread.

 Call Stack
           Monitor the call stack for a particular thread.

 Program monitor
           Display the Program Monitor window.

 Storage
           Monitor the storage that a program uses.

 Breakpoints
           Lists the set breakpoints.

 Debug session control
           Display the Debug Session Control window.


ΓòÉΓòÉΓòÉ 3.7.1. Local Variables Choice ΓòÉΓòÉΓòÉ

Select the Local variables choice to display the local variables (static,
automatic, and parameters) for the current function.  The local variables
display in the Local Variables window.


ΓòÉΓòÉΓòÉ 3.7.2. Registers Choice ΓòÉΓòÉΓòÉ

Select the Registers choice to display the processor and math coprocessor
registers.

When you select Registers, the Registers window displays.


ΓòÉΓòÉΓòÉ 3.7.3. Call Stack Choice ΓòÉΓòÉΓòÉ

Select the Call stack choice to list the active functions or procedures for a
particular thread. When you select Call stack, the Call Stack window displays.


ΓòÉΓòÉΓòÉ 3.7.4. Storage Choice ΓòÉΓòÉΓòÉ

Select the Storage choice to display the contents of storage used by your
program. When you select Storage, a storage window is displayed.  You can open
multiple storage windows.


ΓòÉΓòÉΓòÉ 3.7.5. Windows Choices ΓòÉΓòÉΓòÉ

Select this choice to display the window. This allows you to access any
debugger window that is already open and hidden or minimized.


ΓòÉΓòÉΓòÉ 3.7.6. Windows Choices ΓòÉΓòÉΓòÉ

Select this choice to display the window. This allows you to access any
debugger window that is already open and hidden or minimized.


ΓòÉΓòÉΓòÉ 3.7.7. Windows Choices ΓòÉΓòÉΓòÉ

Select this choice to display the window. This allows you to access any
debugger window that is already open and hidden or minimized.


ΓòÉΓòÉΓòÉ 3.7.8. Windows Choices ΓòÉΓòÉΓòÉ

Select this choice to display the window. This allows you to access any
debugger window that is already open and hidden or minimized.


ΓòÉΓòÉΓòÉ 3.7.9. Windows Choices ΓòÉΓòÉΓòÉ

Select this choice to display the window. This allows you to access any
debugger window that is already open and hidden or minimized.


ΓòÉΓòÉΓòÉ 3.7.10. Windows Choices ΓòÉΓòÉΓòÉ

Select this choice to display the window. This allows you to access any
debugger window that is already open and hidden or minimized.


ΓòÉΓòÉΓòÉ 3.7.11. Windows Choices ΓòÉΓòÉΓòÉ

Select this choice to display the window. This allows you to access any
debugger window that is already open and hidden or minimized.


ΓòÉΓòÉΓòÉ 3.7.12. Windows Choices ΓòÉΓòÉΓòÉ

Select this choice to display the window. This allows you to access any
debugger window that is already open and hidden or minimized.


ΓòÉΓòÉΓòÉ 3.7.13. Windows Choices ΓòÉΓòÉΓòÉ

Select this choice to display the window. This allows you to access any
debugger window that is already open and hidden or minimized.


ΓòÉΓòÉΓòÉ 3.7.14. Windows Choices ΓòÉΓòÉΓòÉ

Select this choice to display the window. This allows you to access any
debugger window that is already open and hidden or minimized.


ΓòÉΓòÉΓòÉ 3.8. Help Menu ΓòÉΓòÉΓòÉ

Select choices from the Help menu to complement the online help information
that you can get for the debugger when you press F1 or select the Help push
button.

 Menu Summary

 Help index
           An alphabetical index of all available debugger help topics.

 General help
           Help information for the active window.

 Using help
           How to use the IBM C/C++ Debugger help facility.

 How do I
           Display the debugger task help.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 3.8.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Index choice display an alphabetical list of index topics for the
debugger. Use the Find choice provided with the online help facility to locate
topics in the index.


ΓòÉΓòÉΓòÉ 3.8.2. General Help Choice ΓòÉΓòÉΓòÉ

Select the General help choice to display online help for the active debugger
window. The online help panel displayed is the same panel that displays when
you place your cursor inside the window and press F1.


ΓòÉΓòÉΓòÉ 3.8.3. Using Help Choice ΓòÉΓòÉΓòÉ

Select the Using help choice to display online help information about the help
facility.


ΓòÉΓòÉΓòÉ 3.8.4. How do I Choice ΓòÉΓòÉΓòÉ

Select the How do I choice to display the online task help. This lists tasks
that you may want to do and instructions on how to complete these tasks.


ΓòÉΓòÉΓòÉ 3.8.5. Product Information Choice ΓòÉΓòÉΓòÉ

Select the Product information choice to display the product information.


ΓòÉΓòÉΓòÉ <hidden> Shortcut Keys ΓòÉΓòÉΓòÉ

This help panel lists the  shortcut keys you use to invoke debugger choices.
When two key names are joined by a plus sign (+), use these two keys together.
Hold down the first key and press the second key.

The following shortcut keys are available for the source windows
(Source/Disassembly/Mixed):

 Step over
           O

 Step into
           I

 Step debug
           D

 Step return
           T

 Run
           R

 Run to location
           L

 Jump to location
           N

 Animate
           A


ΓòÉΓòÉΓòÉ 4. Source Windows: Source, Mixed, and Disassembly ΓòÉΓòÉΓòÉ

The Source window displays the source code for the program you are debugging.
When you start the debugger, the Source window displays if the source file is
available. If the source file is not available, the Source Filename window
displays. Although, only one source window initially displays, you can display
additional source windows at any time.

In each source window, executable statements initially display in blue. You can
set breakpoints or execute your program only on executable lines.
Non-executable lines, such as comments, initially display in black. The prefix
area of each source line displays a line number. If your source file contains
include files, the Source window displays in a notebook format where the tabs
represent the include files.

The tool buttons display in each of the source windows. Double-click on any of
the following for a description of that button.

The buttons listed can also be accessed from the menu items of the source
windows.  For example, the step buttons can be found under the Run menu.

Views

You can display your source in three different views.

The Source view  displays the source code for the program you are debugging as
it was written.

The Disassembly view displays the source code as assembler instructions without
the symbolic information. The prefix area of each line displays the address of
the assembler instruction.

The Mixed view displays the source code for the component and the assembler
instructions that are generated for each source line without the symbolic
information.

You can change from one view to another using one of the following two methods:

 o Select the View menu from a source window and then select the view you want
   displayed.
 o Select the View button to cycle through the source windows.

 Basic tasks from the source windows include:

 Setting line breakpoints Double-click on the prefix area of any line to set a
           simple line breakpoint. For more information about breakpoints, see
           Breakpoints.

 Single stepping your program Press mouse button 2 to single step your program.
           This performs a Step over command.

           Note:   This function depends on the Step with mouse button 2 check
           box in the Debugger Properties window. (If the check box is enabled,
           clicking mouse button 2 performs a step over command.)

 Monitoring and modifying variables Double-click on any variable name in your
           program to display that variable in a monitor window. Drag the mouse
           over an expression, and then double-click on the highlighted
           expression, to display the expression in a monitor window.

           Select Local Variables from the Windows menu to display a monitor
           window of all the local variables in your program.

 The four monitors for variables and expressions are:

 o Program monitor
 o Private monitor
 o Popup expression
 o Local Variables

 Variable or Expression Popup Menu

 The Variable or Expression Popup Menu contains options that you can perform on
 a variable or expression. The popup menu is shown when you click mouse button
 2 with the mouse pointer on a highlighted variable or expression in a source
 window, unless the Step with mouse button 2 check box on the Debugger
 Properties window is enabled. (If the check box is enabled, clicking mouse
 button 2 performs a step over command.)

 Menu Summary

 Popup expression
           Show the variable or expression in a popup expression window.

 Add to private monitor
           Add the variable or expression to the private monitor.

 Add to program monitor
           Add the variable or expression to the program monitor.

 Add to storage monitor
           Add the variable or expression to the storage monitor.

 Copy
           Copy the variable or expression to the copy buffer.

 Find
           Find the next occurrence of the variable or expression.

 Find function...
           Find the function which contains the variable or expression.

 Set function breakpoint
           Set a function breakpoint on the selected variable or expression.

 Line Popup Menu

 The Line Popup Menu contains options that you can perform on breakpoints and
 the Run to location command. The popup menu is shown when you click mouse
 button 2 with the mouse pointer on a line number in a source window, unless
 the Step with mouse button 2 check box on the Debugger Properties window is
 enabled. (If the check box is enabled, clicking mouse button 2 performs a step
 over command.)

 Menu Summary

 Run to location
           Run your program from the current line up to the line that is
           highlighted in the prefix area.

 Jump to location
           Change the current line in the program without executing the code
           between the present current line and the new current line.

 Set breakpoint
           Set a simple line breakpoint on the current line.

 Set line breakpoint
           Use the Line Breakpoint window to set a line breakpoint.

 Clear breakpoint
           Delete the breakpoint on the current line.

 Disable breakpoint
           Disable the breakpoint on the current line.

 Enable breakpoint
           Enable the breakpoint on the current line.

 Note:   The Set breakpoint choice is shown if the line does not have a
 breakpoint. The Clear breakpoint, Disable breakpoint, and Enable breakpoint
 choices are shown if the line has a breakpoint. The Disable choice is shown if
 the highlighted breakpoint is enabled. The Enable choice is shown if the
 highlighted breakpoint is disabled.

 Menu Bar Summary for the Source Windows

 File
           Start and end the debugger, and control the source window.

 View
           Search for strings in the text and select a different view of your
           program or change the current window to a notebook format.

 Breakpoints
           Set and manipulate breakpoints in your program.

 Monitors
           Display the other debugging windows.

 Run
           Run your program in several ways.

 Options
           Change the parameters that control how your program displays and
           runs.

 Windows
           Displays the active debugger windows.

 Help
           Display online help that compliments the information you get when
           you press F1 or select the Help push button.

 Tool Buttons Summary

 The following buttons are in the source windows to allow easy access to
 frequently used functions:

           Step over executes the current, highlighted line in the program, but
           does not enter any called function.

           Step into executes the current, highlighted line in the program and
           enters any called program or function.

           Step debug executes the current, highlighted line in the program.
           The debugger steps over any function for which debugging information
           is not available (for example, library and system routines), and
           steps into any function for which debugging information is
           available.

           Step return automatically executes the lines of code up to, and
           including, the return statement of the current function.

           Run runs the program, executing all enabled threads. Control returns
           to the debugger when:

           o the program ends

           o execution stops at an enabled breakpoint.

           When the debugger is running the run button changes to

           Debug Session Control displays the Debug Session Control window.

           Call Stack displays the Call Stack window.

           Register displays the Register window.

           Monitor expression displays the Monitor Expression window.

           Storage displays a new Storage window.

           Breakpoints displays the Breakpoints window.

           View cycles through the source windows.

 Related Information

 o Debug Session Control Window
 o Register Window
 o Call Stack Window
 o Local Variables Window
 o Program Monitor Window
 o Private Monitor Window
 o Popup Expression Window
 o Storage Window
 o Breakpoint List Window
 o Monitor Properties


ΓòÉΓòÉΓòÉ <hidden> Popup Expression Choice ΓòÉΓòÉΓòÉ

Select the Popup expression choice to show the highlighted variable or
expression in a popup expression window. If the Popup monitor radio button in
the Monitor Properties window is selected, the contents of the variable or
expression is updated when they change.


ΓòÉΓòÉΓòÉ <hidden> Add To Private Monitor Choice ΓòÉΓòÉΓòÉ

Select the Add to private monitor choice to add the highlighted variable or
expression to the Private Monitor window. If the Private monitor radio button
is enabled in the Monitor Properties window is selected, the contents of the
variable or expression is updated when they change.


ΓòÉΓòÉΓòÉ <hidden> Add To Program Monitor Choice ΓòÉΓòÉΓòÉ

Select the Add to program monitor choice to add the highlighted variable or
expression to the Program Monitor window. If the Program monitor radio button
in the Monitor Properties window is selected, the contents of the variable or
expression is updated when they change.


ΓòÉΓòÉΓòÉ <hidden> Add To Storage Monitor Choice ΓòÉΓòÉΓòÉ

Select the Add to storage monitor choice to add the highlighted variable or
expression to the Storage window. If the Storage monitor radio button in the
Monitor Properties window is selected, the contents of the variable or
expression is updated when they change.


ΓòÉΓòÉΓòÉ <hidden> Copy Choice ΓòÉΓòÉΓòÉ

Select the Copy choice to copy the highlighted variable or expression into the
copy buffer.

To copy a variable or expression:

  1. Highlight the variable or expression you want to copy.
  2. Select the Copy choice.
  3. Move to the desired location.
  4. Press Shift+Insert to paste the variable or expression in the current
     location.


ΓòÉΓòÉΓòÉ <hidden> Find Choice ΓòÉΓòÉΓòÉ

Select the Find choice to find the next occurrence of the highlighted variable
or expression.

To find a variable or expression:

  1. Highlight the variable or expression you want to find.
  2. Select the Find choice.

 The next occurrence of the variable or expression is shown in a source window.


ΓòÉΓòÉΓòÉ <hidden> Find Function Choice ΓòÉΓòÉΓòÉ

Select the Find function... choice to find the function which contains the
highlighted variable or expression.

To find the procedure:

  1. Highlight the variable or expression.
  2. Select the Find function... choice.

 The beginning of the function which contains the variable or expression is
 shown in a source window.


ΓòÉΓòÉΓòÉ <hidden> Set Function Breakpoint Choice ΓòÉΓòÉΓòÉ

Select the Set function breakpoint choice to set a function breakpoint on the
highlighted variable or expression. A function breakpoint stops the execution
of your program after calling a specific function.

To set a function breakpoint:

  1. Highlight the variable or expression.
  2. Select the Set function breakpoint choice.

 The Function Breakpoint window displays.


ΓòÉΓòÉΓòÉ <hidden> Set Breakpoint Choice ΓòÉΓòÉΓòÉ

Select the Set breakpoint choice to set a simple line breakpoint on the current
line.


ΓòÉΓòÉΓòÉ 4.1. Clear Breakpoint Choice ΓòÉΓòÉΓòÉ

Select the Clear breakpoint choice to delete the breakpoint on the current
line.

To clear the breakpoint:

  1. Highlight the line which has the breakpoint you want to delete.
  2. Select the Clear choice.


ΓòÉΓòÉΓòÉ <hidden> Disable Breakpoint Choice ΓòÉΓòÉΓòÉ

Select the Disable breakpoint choice to disable the breakpoint on the current
line.

To disable the breakpoint:

  1. Highlight the line which has the breakpoint you want to disable.
  2. Select the Disable choice.


ΓòÉΓòÉΓòÉ <hidden> Enable Breakpoint Choice ΓòÉΓòÉΓòÉ

Select the Enable breakpoint choice to enable the breakpoint on the current
line.

To enable the breakpoint:

  1. Highlight the line which has the breakpoint you want to enable.
  2. Select the Enable choice.


ΓòÉΓòÉΓòÉ <hidden> Step Over Button ΓòÉΓòÉΓòÉ

Executes the current, highlighted line in the program, but does not enter any
called function. You can also access the Step over function by placing the
mouse pointer in a source window and clicking mouse button two to execute one
line.

All enabled threads continue execution.

Note:   The debugger stops in a called function if it encounters a breakpoint.


ΓòÉΓòÉΓòÉ <hidden> Step Into Button ΓòÉΓòÉΓòÉ

Executes the current, highlighted line in the program and enters any called
program or function.

Note:   If you have multiple calls on the same source line and perform a step
into for which there is no source code available, the Disassembly view
displays.  To return to the Source window, you have to do a step return.  To
avoid this, perform step debug so that the debugger will step over any calls
for which debugging data is not available, such as library and system
functions, and steps into any function for which debugging information is
available.


ΓòÉΓòÉΓòÉ <hidden> Step Debug Button ΓòÉΓòÉΓòÉ

Executes the current, highlighted line in the program. The debugger steps over
any function for which debugging information is not available (for example,
library and system routines), and steps into any function for which debugging
information is available.


ΓòÉΓòÉΓòÉ <hidden> Step Return Button ΓòÉΓòÉΓòÉ

Automatically executes the lines of code up to, and including, the return
statement of the current function.


ΓòÉΓòÉΓòÉ <hidden> Run Button ΓòÉΓòÉΓòÉ

Runs the program, executing all enabled threads. Control returns to the
debugger when:

 o the program ends

 o execution stops at an enabled breakpoint.


ΓòÉΓòÉΓòÉ <hidden> Halt Button ΓòÉΓòÉΓòÉ

Stops the execution of your program.

Note:   The Halt button does not display in the tool bar if you are debugging
remotely.


ΓòÉΓòÉΓòÉ <hidden> Debug Session Control Button ΓòÉΓòÉΓòÉ

Displays the Debug Session Control window.


ΓòÉΓòÉΓòÉ <hidden> Call Stack Button ΓòÉΓòÉΓòÉ

Displays the Call Stack window.


ΓòÉΓòÉΓòÉ <hidden> Register Button ΓòÉΓòÉΓòÉ

Displays the Register window.


ΓòÉΓòÉΓòÉ <hidden> Program Monitor Button ΓòÉΓòÉΓòÉ

Displays the Monitor Expression window.


ΓòÉΓòÉΓòÉ <hidden> Storage Button ΓòÉΓòÉΓòÉ

Displays a new Storage window.


ΓòÉΓòÉΓòÉ <hidden> Breakpoints Button ΓòÉΓòÉΓòÉ

Displays the Breakpoints window.


ΓòÉΓòÉΓòÉ <hidden> View Button ΓòÉΓòÉΓòÉ

Cycles through the source windows.


ΓòÉΓòÉΓòÉ <hidden> Delete Highlighted Breakpoint Button ΓòÉΓòÉΓòÉ

Deletes the breakpoint that is highlighted in the Breakpoint List window.


ΓòÉΓòÉΓòÉ <hidden> Delete All Breakpoints Button ΓòÉΓòÉΓòÉ

Deletes all the breakpoints in the Breakpoint List window.


ΓòÉΓòÉΓòÉ <hidden> Growth Direction Button ΓòÉΓòÉΓòÉ

Allows you change the direction that items are displayed. Toggling changes the
growth to direction from:

 Up
           Displays new items at the top of the Call Stack window.

 Down
           Displays new items at the bottom of the Call Stack window.


ΓòÉΓòÉΓòÉ <hidden> 32-bit Button ΓòÉΓòÉΓòÉ

Displays the storage contents as a 32-bit floating point.


ΓòÉΓòÉΓòÉ <hidden> 64-bit Button ΓòÉΓòÉΓòÉ

Displays the storage contents as a 64-bit floating point.


ΓòÉΓòÉΓòÉ <hidden> 32-bit Unsigned Button ΓòÉΓòÉΓòÉ

Displays the storage contents as a 32-bit unsigned integer.


ΓòÉΓòÉΓòÉ <hidden> 32-bit Signed Button ΓòÉΓòÉΓòÉ

Displays the storage contents as a 32-bit signed integer.


ΓòÉΓòÉΓòÉ <hidden> Character Button ΓòÉΓòÉΓòÉ

Displays the storage contents in ASCII.


ΓòÉΓòÉΓòÉ <hidden> Hex Button ΓòÉΓòÉΓòÉ

Displays the storage contents in Hex and ASCII.


ΓòÉΓòÉΓòÉ 4.2. File Menu ΓòÉΓòÉΓòÉ

Select choices from the File menu of the source windows to start programs, find
the current line, replace your current program file with a program file from
another location or with a different name, restart the current debugging
session, restart a previous debugging session for this program, and end the
debugging session.

Menu Summary

 Open new source...
           Display a new source file.

 Find function...
           Open a source window to a particular function.

 Where is execution point
           Open a source window containing the next line to be executed.

 Startup
           Start the program you want to debug after ending the current
           program.

 Process list...
           Open the Process List window allows you to attach to a specific
           process that you want to debug.

 Close debugger
           Close the debugging session.


ΓòÉΓòÉΓòÉ 4.2.1. Open New Source Choice ΓòÉΓòÉΓòÉ

Select the Open new source... choice to open a new source file. When you select
Open new source, the Open New Source window displays.


ΓòÉΓòÉΓòÉ 4.2.1.1. Open New Source Window ΓòÉΓòÉΓòÉ

Use the Open New Source window to open a new source file.

To use the Open New Source window:

  1. Type the name of the object file you want to open the source for in the
     Source entry field. For example, to look for the source used to compile
     A123.OBJ, type the following:

              A123.ext

     If you are unsure of the file name, select the Browse... push button to
     view a list of the files that you can select.

  2. Type the name of the executable file in the Executable entry field.  The
     source files for the executable file display in the Source entry field.

     Note:   You have to disable the All executables check box option to search
     only one executable file.

  3. Select the appropriate push button to continue.

 All executables Check Box
           Enable this option if you want to search all the executable files.
           Disable this option to search only one executable file.

 Debugging information only Check Box
           Enable this option if you want to search only the source files that
           contain debugging information.


ΓòÉΓòÉΓòÉ 4.2.2. Find Function Choice ΓòÉΓòÉΓòÉ

Select the Find function... choice to open a source window to a particular
function. When you select Find function..., the Find Function window displays.


ΓòÉΓòÉΓòÉ 4.2.2.1. Find Function Window ΓòÉΓòÉΓòÉ

Use the Find Function window to open a source window to a particular function.

To use the Find Function window:

  1. Type the name of the function you want to search for in the Function entry
     field.

  2. Select the appropriate push button to continue.

 Debugging information only Check Box
           Enable this check box if you want to search only the object files
           that contain debugging information.

 Case sensitive Check Box
           Enable this check box if you want to search for the string exactly
           as typed. Disable this check box if you want to search for both
           uppercase and lowercase characters.

 If the function that you specify is not found, the following message displays:

     No matching function found

 This means it may be a static function or the function you specified does not
 exist.


ΓòÉΓòÉΓòÉ 4.2.3. Where Is Execution Point Choice ΓòÉΓòÉΓòÉ

Select the Where is execution point choice to locate the next line in the
thread to be executed.


ΓòÉΓòÉΓòÉ 4.2.4. Startup Choice ΓòÉΓòÉΓòÉ

Select the Startup choice to start a program for debugging. Startup allows you
to debug another program, while Restart allows you to restart the current
debugging session on the existing program.

When you select Startup, the Startup window displays.


ΓòÉΓòÉΓòÉ 4.2.4.1. Startup Information Window ΓòÉΓòÉΓòÉ

Use the Startup Information window to specify the program you want to start for
this debugging session.

  1. Select a program for debugging using one of the following methods:

    o Type the name of the program you want to start in the Program entry
      field.

    o Open the Program list by selecting the arrow then selecting a program
      name.

    o Select the Browse... push button and select a program from the Open
      window.

  2. Type any parameters you want to pass to your program in the Parameters
     entry field. Separate multiple parameters with a space.

  3. Select one of the push buttons to continue.

 Program Entry Field

 Type the name of the program you want to start for your debugging session. You
 do not need to include the file name extension when you type the program name.
 However, the extension does default to exe.

 Parameters Entry Field

 If the program accepts parameters, type the parameters that you want to pass
 to the program you are starting.

 Use program profile Check Box

 Select the Use program profile check box to start the debugging session with
 program profile information.

 Note:   The debugger saves the program profile information with a time stamp
 and checks the time stamp before the program starts with the profile
 information.

 Debug program initialization Check Box

 Select Debug program initialization to halt execution of the application
 before any initialization routines have been executed. This allows you to
 debug any DLL initialization routines.


ΓòÉΓòÉΓòÉ 4.2.5. Process List Choice ΓòÉΓòÉΓòÉ

Select the Process list... choice to select the process that you want to debug.

When you select Process list..., the Process List window displays.

Note:   This choice is not available for Windows95.


ΓòÉΓòÉΓòÉ 4.2.6. Close Debugger Choice ΓòÉΓòÉΓòÉ

Select the Close debugger choice to close your current debugging session.

When you select the Close debugger choice, a message box prompts you to confirm
that you want to end the debugging session.


ΓòÉΓòÉΓòÉ 4.3. View Menu ΓòÉΓòÉΓòÉ

Select choices from the View menu to search for strings in the text and select
a different view of your program or change the current window to a notebook
format. Menu Summary

 Find
           Search for text strings in the active window.

 Find next
           Find the next occurrence of a string.

 Scroll to line number
           Scroll to a particular line or set a breakpoint on a specified line.

 Select include
           Select to view the include files.

 Change text file
           Select the file name to use as the source in the current view.

 Source
           Displays the Source window.

 Disassembly
           Displays the Disassembly window.

 Mixed
           Displays the Mixed window.


ΓòÉΓòÉΓòÉ 4.3.1. Find Choice ΓòÉΓòÉΓòÉ

Select the Find choice to search for a text string in the active window. You
can search for simple text strings that do not use wildcards (*).

When you select Find, the Find window displays, prompting you for the text
string you want to find.

If you are searching in the same program component, the default is the text
string you typed the last time you completed the Find window for this
component.


ΓòÉΓòÉΓòÉ 4.3.1.1. Find Window ΓòÉΓòÉΓòÉ

To use the Find window to search for a text string:

  1. Type the text string you want to search for in the Text entry field.

  2. Select the appropriate push button to continue.

 Text Entry Field
           Type the text string you want to search for in this entry field.

 The search string can have:

 o Alphabetic and numeric characters
 o A maximum of 256 characters
 o Uppercase and lowercase characters.

 Case sensitive Check Box
           Enable this check box if you want to search for the string exactly
           as typed. Disable this check box to search for uppercase and
           lowercase characters.


ΓòÉΓòÉΓòÉ 4.3.2. Find Next Choice ΓòÉΓòÉΓòÉ

Select the Find next choice to search for the next occurrence of a text string.
If you are searching in the same program component, the default is the text
string you typed the last time you completed the Find window for this
component.


ΓòÉΓòÉΓòÉ 4.3.3. Scroll to Line Number Choice ΓòÉΓòÉΓòÉ

Select the Scroll to line number choice from the source windows to go to a
particular line in your program or set a line breakpoint.

When you select Scroll to line Number, the Scroll to Line Number window
displays.


ΓòÉΓòÉΓòÉ 4.3.3.1. Scroll to Line Number Window ΓòÉΓòÉΓòÉ

Use the Scroll to Line Number window to go to a specific line in your program
or set a line breakpoint.

To use the Scroll to Line Number window to scroll to a specific line:

  1. Type the line number you want to scroll to in the Line entry field.

  2. Select the OK push button to scroll to that line.

 Note:   If the Source window is active, you can type in a number and the
 Scroll to Line Number window displays.

 To use the Scroll to Line Number window to set a breakpoint:

  1. Type the line number you want to set the breakpoint on in the Line entry
     field.

  2. Select the Breakpoint push button to set the breakpoint on the specified
     line number.


ΓòÉΓòÉΓòÉ 4.3.4. Select Include Choice ΓòÉΓòÉΓòÉ

Use the Select include choice to select the include file you want to view.


ΓòÉΓòÉΓòÉ 4.3.4.1. Select Include File Window ΓòÉΓòÉΓòÉ

Use the Select Include File window to select the include file you want to view.

To use the Select Include File window:

  1. Select the include file.  The include file name is highlighted.

  2. Select the OK push button.  The selected include file view displays.


ΓòÉΓòÉΓòÉ 4.3.5. Change Text File Choice ΓòÉΓòÉΓòÉ

Select the Change text file choice to specify the file name to use as the
source in the current view.

This is useful if the debugger found the incorrect source file for your
program, so that you can specify the use of a different source file from a
different directory.

For information about how the debugger searches for source files, refer to
understanding the search path

When you select Change text file, the Change text file window displays.


ΓòÉΓòÉΓòÉ 4.3.5.1. Change Text File Window ΓòÉΓòÉΓòÉ

Use the Change Text File window to replace the path name or file name of the
program you are debugging with a new path name or file name.

This specifies a new file name to use as the source in the current source
window.

This is useful if the debugger found the incorrect source file for your
program, so that you can specify the use of a different source file from a
different directory.

To replace the file name:

  1. Type the new path name or file name in the File name entry field.

  2. Select the appropriate push button to continue.

 File name Entry Field
           Type the path name and file name of the program you want to replace
           with the program you are currently debugging.

 Related Information

 o Understanding The Search Path


ΓòÉΓòÉΓòÉ 4.3.6. Source Choice ΓòÉΓòÉΓòÉ

Select the Source choice to display the source code for your program.

The initial Source window displays the source code for the object that contains
the main function to the program being debugged. If it is available, the Source
window displays with the Debug Session Control window when the debugging
session starts. Otherwise, the Disassembly window displays.

Note:   You can change the order of the source windows that are opened by using
        the Debugger Properties window.


ΓòÉΓòÉΓòÉ 4.3.7. Disassembly Choice ΓòÉΓòÉΓòÉ

Select the Disassembly choice to display the assembler instructions for your
program, without symbolic information. The menu choices available in the
Disassembly window are the same as for the Source window except that the
Variable menu and the Change text file choice in the File menu are not
available.

Note:   You can change the order of the source window that are opened by using
        the Debugger Properties window.


ΓòÉΓòÉΓòÉ 4.3.8. Mixed Choice ΓòÉΓòÉΓòÉ

The Mixed window displays each line of source code followed by the assembler
instructions that the particular source line generates.

The Mixed window displays your program, as follows:

 o Each lines of source code is prefixed by its line number, as in the Source
   window.

 o Each disassembled line is prefixed by an address, as in the Disassembly
   view.

 o Source comment lines also display.

 o The lines of source code are treated as comments within the lines of
   disassembly code. You can only set breakpoints or run your program on lines
   of disassembly code.

 o The Mixed window cannot be opened if the source code is not available.

 Note:   You can change the order of the source windows that are opened by
 using the Debugger Properties window.


ΓòÉΓòÉΓòÉ 4.4. Breakpoints Menu ΓòÉΓòÉΓòÉ

Select choices from the Breakpoints menu to set breakpoints and to stop the
execution of your program at any point. You can set as many breakpoints as you
want.

Breakpoints can be set from the Debug Session Control window or from a source
window. When you set a breakpoint in one view of your program, it is reflected
in the other appropriate views.

There are five breakpoints that you can set. You can customize the breakpoints
using the various breakpoint windows.

Menu Summary

 Set line...
           Set a line breakpoint to stop the execution of your program at a
           specific line number.

 Set function...
           Set a function breakpoint to stop the execution of your program
           after calling a specific function.

 Set address...
           Set an address breakpoint to stop the execution of your program at a
           specific address.

 Set change address...
           Set a change address breakpoint to stop the execution of your
           program when contents of memory at a given address changes.

 Set load occurrence...
           Set a load occurrence breakpoint to stop the execution of your
           program after loading a DLL.

 List
           List the set breakpoints.

 Toggle at current line
           Set or delete a simple line breakpoint on the current line.

 Delete all
           Delete all the set breakpoints.

 You can also set simple line breakpoints. Double-click on one of the following
 for the procedures you use to set or clear simple line breakpoints:

 o Setting simple line breakpoints

 o Deleting simple line breakpoints


ΓòÉΓòÉΓòÉ 4.4.1. Set Line Choice ΓòÉΓòÉΓòÉ

Select the Set line choice to stop the execution of your program at the line
number you select. When you select Set line, the Line Breakpoint window
displays.

You can also set simple line breakpoints. Double-click on one of the following
for the procedures you use to set or clear simple line breakpoints:

 o Setting simple line breakpoints

 o Deleting simple line breakpoints


ΓòÉΓòÉΓòÉ 4.4.2. Set Function Choice ΓòÉΓòÉΓòÉ

Select the Set function choice to stop the execution of your program after the
function that you specify is called. When you select Set function, the Function
Breakpoint window displays.


ΓòÉΓòÉΓòÉ 4.4.3. Set Address Choice ΓòÉΓòÉΓòÉ

Select the Set address choice to stop the execution of your program at the
selected address. When you select Set address, the Address Breakpoint window
displays.


ΓòÉΓòÉΓòÉ 4.4.4. Set Change Address Choice ΓòÉΓòÉΓòÉ

Select the Set change address choice to stop the execution of your program
after the contents of memory at a given address changes. When you select Set
change address, the Change Address Breakpoint window displays.


ΓòÉΓòÉΓòÉ 4.4.5. Set Load Occurrence Choice ΓòÉΓòÉΓòÉ

Select the Set load occurrence choice to stop the execution of your program
after the DLL that you specify is loaded. When you select Set load occurrence,
the Load Occurrence Breakpoint window displays.


ΓòÉΓòÉΓòÉ 4.4.6. List Choice ΓòÉΓòÉΓòÉ

Select the List choice to list the breakpoints that you have set. When you
select List, the Breakpoints list window displays.


ΓòÉΓòÉΓòÉ 4.4.7. Toggle At Current Line Choice ΓòÉΓòÉΓòÉ

Select the Toggle at current line choice to set a breakpoint at the current
line or delete a breakpoint if one already exists at the current line.


ΓòÉΓòÉΓòÉ 4.4.8. Delete All Choice ΓòÉΓòÉΓòÉ

Select the Delete all choice to delete all the breakpoints that you have set.

When you select Delete all, an information box displays for verification that
you want to delete all the breakpoints.


ΓòÉΓòÉΓòÉ 4.5. Monitors Menu ΓòÉΓòÉΓòÉ

Select choices from the Monitors menu to monitor expressions and variables and
display other debugger windows.

Menu Summary

 Monitor expression
           Displays the Monitor Expression window to allow you to type the name
           of the variable or expression you want to monitor.

 Call stack
           Displays the Call Stack window to allow you to monitor the call
           stack for a particular thread.

 Registers
           Displays the Registers window to allow you to monitor registers and
           flags for a particular component or thread.

 Storage
           Displays the Storage window to allow you to monitor the storage in
           your program.

 Local variables
           Displays the local variables for the programs current function.


ΓòÉΓòÉΓòÉ 4.5.1. Monitor Expression Choice ΓòÉΓòÉΓòÉ

Select the Monitor expression choice if you want to use the keyboard to type
the name of a variable or an expression you want to monitor.

When you select Monitor expression, the Monitor Expression window displays.


ΓòÉΓòÉΓòÉ 4.5.1.1. Monitor Expression Window ΓòÉΓòÉΓòÉ

Use the Monitor Expression window to type in the expression you want to
monitor.

This window lists the following contextual information:

 o The component you are in.

 o The active line of the source code, which is highlighted.

 o The view of the program that is active.

 o The thread you are in.

 The expression language supported by the debugger is a subset of the C/C++
 language. You can monitor only expressions with:

 o A supported operand type

 o A supported operator

 o A supported typecasting operation

 To specify an expression to be monitored:

  1. Type the name of the variable or expression you want to monitor in the
     Expression entry field.

  2. Select the appropriate radio button from where you want to monitor your
     expression.

     Note:   The expression displays as specified in the Monitor Properties
     window. To change the default location, select Monitor properties from the
     Debugger settings choice from the Options menu in the source windows or
     the Debug Session Control window.


ΓòÉΓòÉΓòÉ <hidden> Selecting Variables with the Mouse ΓòÉΓòÉΓòÉ

To select a variable or expression for display using the mouse, use one of the
following methods:

 o Point to any character within the variable name and double-click mouse
   button one.

 o Highlight the variable name or expression by pressing and holding mouse
   button one and dragging the mouse pointer across the variable name or
   expression, and then double-click mouse button one anywhere within the name.

 o Highlight the variable name or expression and select Add to program monitor,
   Add to private monitor, or Popup expression from the Variable menu.


ΓòÉΓòÉΓòÉ <hidden> Selecting Variables with the Mouse and Monitor Expression Wi ΓòÉΓòÉΓòÉ

To monitor a variable or an expression using the mouse and the Monitor
Expression window, use one of the two following methods:

For a single variable name:

  1. Highlight the variable name using either of the following methods:

    o Point to the variable name and click on mouse button one.

    o Highlight the variable by placing the mouse pointer on the beginning of
      the variable and dragging the mouse across the entire variable while
      pressing mouse button one.

  2. Select Monitor expression from the Variable menu.

     The Monitor Expression window displays with the highlighted variable name
     in the Expression entry field.

 For an expression:

  1. Highlight the expression by placing the mouse pointer on the beginning of
     the expression and dragging the mouse across the entire expression while
     pressing mouse button one.

  2. Select Monitor expression from the Variable menu.

     The Monitor Expression window displays with the highlighted expression
     name in the Expression entry field.

 Select the appropriate push button to continue.


ΓòÉΓòÉΓòÉ <hidden> Selecting Variables with the Keyboard ΓòÉΓòÉΓòÉ

To monitor a variable or expression using the keyboard:

  1. Select Monitor expression from the Variable menu. The Monitor Expression
     window displays.

  2. Type the name of the variable or expression in the Expression entry field.

  3. To change the defaults that control how a variable or expression displays
     in a monitor or popup expression window, do the following:

     a) Select Monitor Properties push button to display the Monitor Properties
        window.

     b) Select OK to close the Monitor Properties window.

  4. Select OK to close the Monitor Expression window.


ΓòÉΓòÉΓòÉ 4.6. Run Menu ΓòÉΓòÉΓòÉ

Select choices from the Run menu to control the execution of your program. You
can step through your program in several ways, or you can run your program
until a breakpoint is encountered or your program is ended.

You can access any of the choices in the Run menu by using the shortcut keys
These keys are also listed in the Run menu. For the Step over command, you can
use the mouse.

When you select a choice from the Run menu, the mouse pointer changes to
indicate that the application is running and might require input to continue to
the next breakpoint or end of the program.

Menu Summary

 Step over
           Execute the current line in your program. If the current line is a
           call, execution stops when the call completes.

 Step into
           Execute the current line in your program. If the current line is a
           call, execution stops at the first statement in the called function.

 Step debug
           Execute the current line in the program. The debugger steps over any
           function for which debugging information is not available and steps
           into any function for which debugging information is available.

 Step return
           Step through the current function until the return is executed.

 Run
           Execute the program from the current line until a breakpoint is
           encountered or the program ends.

 Halt
           Interrupt the program you are debugging.

 Restart
           Restart the current debugging session.

 Run to location
           Execute your program from the current line up to the line that is
           highlighted in the prefix area.

 Jump to location
           Change the current line in the program without executing the code
           between the present current line and the new current line.

 Hide debugger on Run
           Hide the debugger windows while your application is running.

 Check heap when stopping
           Check all memory blocks allocated or freed by the compiler debug
           memory management functions to make sure that overwriting has not
           occurred outside the bounds of allocated blocks and free memory
           blocks have not been overwritten.

 Thread enabled
           Enable or disable threads.


ΓòÉΓòÉΓòÉ 4.6.1. Step Over Choice ΓòÉΓòÉΓòÉ

Select the Step over choice to execute the current line of the program. If the
current line is a call, execution stops when the call completes.  You can also
access the Step over function by placing the mouse pointer in a source window
and clicking mouse button two to execute one line.

All enabled threads continue execution.

Note:   The debugger stops in a called function if it encounters a breakpoint.


ΓòÉΓòÉΓòÉ 4.6.2. Step Into Choice ΓòÉΓòÉΓòÉ

Select the Step into choice to execute the current line in the program.  If the
current line is a call, execution stops at the first statement in the called
function.

Note:   If you have multiple calls on the same source line and perform a step
into for which there is no source code available, the Disassembly view
displays.  To return to the Source window, you have to do a step return.  To
avoid this, perform step debug so that the debugger will step over any calls
for which debugging data is not available, such as library and system
functions, and steps into any function for which debugging information is
available.


ΓòÉΓòÉΓòÉ 4.6.3. Step Return Choice ΓòÉΓòÉΓòÉ

Select the Step return choice to automatically execute the lines of code up to,
and including, the return statement of the current function.


ΓòÉΓòÉΓòÉ 4.6.4. Step Debug Choice ΓòÉΓòÉΓòÉ

Select the Step debug choice to execute the current line in the program. The
debugger steps over any function for which debugging data is not available,
such as library and system functions, and steps into any function for which
debugging information is available.


ΓòÉΓòÉΓòÉ 4.6.5. Run Choice ΓòÉΓòÉΓòÉ

Select the Run choice to execute the program, including all enabled threads,
from the current line until a breakpoint is encountered or the program ends.


ΓòÉΓòÉΓòÉ 4.6.6. Halt Choice ΓòÉΓòÉΓòÉ

Select the Halt choice to interrupt the program that you are debugging.


ΓòÉΓòÉΓòÉ 4.6.7. Restart Choice ΓòÉΓòÉΓòÉ

Select the Restart choice to start the debugging session again. Restart allows
you to restart the current debugging session on the existing program, while the
Startup choice allows you to debug another program.


ΓòÉΓòÉΓòÉ 4.6.8. Run to Location Choice ΓòÉΓòÉΓòÉ

Select the Run to Location choice to execute your program from the current line
up to the line that is highlighted in the prefix area.

To use the Run to location choice:

  1. Single-click in the prefix area of the line you want to become the current
     line. The prefix area turns black.

  2. Select the Run to location choice. The program runs up to the line that
     you marked.

 The Run to location choice stops only on executable lines. If a highlighted
 line is not executable, the run is not performed.


ΓòÉΓòÉΓòÉ 4.6.9. Jump to Location Choice ΓòÉΓòÉΓòÉ

Select the Jump to Location choice to change the current line in your program
without executing the lines between the present current line and the new
current line.

To use the Jump to location choice:

  1. Single-click in the prefix area of the line you want to become the current
     line. The prefix area turns black.

  2. Select the Jump to location choice. The current line is changed and the
     lines between are not executed.

 The Jump to location choice stops only on executable lines. If a highlighted
 line is not executable, the jump is not performed.

 Warning Jumping out of the current function may corrupt the call stack and
 cause your program to produce unpredictable results.


ΓòÉΓòÉΓòÉ 4.6.10. Hide Debugger on Run Choice ΓòÉΓòÉΓòÉ

Select the Hide debugger on Run choice to hide the debugger windows when your
program is running.


ΓòÉΓòÉΓòÉ 4.6.11. Check Heap When Stopping Choice ΓòÉΓòÉΓòÉ

Select the Check heap when stopping choice to check all memory blocks allocated
or freed by the compiler debug memory management functions.  This makes sure
that overwriting has not occurred outside the bounds of allocated blocks and
free memory blocks have not been overwritten.

When Check heap when stopping choice is enabled, each time the program stops,
the heap is checked.  For example, stopping at a breakpoint or at the end of a
step command would cause the heap check to be performed. If a heap error is
detected, your application terminates. The Termination window displays showing
the source line number where the application stopped and the heap check was
performed.

Notes

 o For the Check heap when stopping choice to work, you have to compile your
   application using the Tm+ compiler option.

 o If you enable the Check heap when stopping choice and you run your
   application to termination and the application contains a heap error, the
   heap check is not made. To check the heap just before termination, set a
   breakpoint on the last line of your application.


ΓòÉΓòÉΓòÉ 4.6.12. Thread Enabled Choice ΓòÉΓòÉΓòÉ

Select the Thread enabled choice to execute the thread associated with the
current source window, when the program runs.

When a thread is enabled, a check mark symbol displays beside the Thread
enabled choice. When a thread is not enabled, a check mark symbol does not
display and the highlighted thread is not executed.


ΓòÉΓòÉΓòÉ 4.7. Options Menu ΓòÉΓòÉΓòÉ

Select choices from the Options menu in the Source, Mixed or Disassembly source
windows to control the debugger windows.

Menu Summary

 Window Settings
           Select the font you want.

 Debugger settings
           Set various debugger options.


ΓòÉΓòÉΓòÉ 4.7.1. Window Settings Cascading Choice ΓòÉΓòÉΓòÉ

The following choices are available from the Window Settings cascading choice:

 Fonts
           Select the font for the source window.

 Restore defaults
           Reset all of the window settings to their original settings.

 Notebook
           Display the source windows in a notebook format.

 Tool buttons
           Enable or disable buttons from being displayed in the the window.

 Hover help
           Enable or disable the hover help from being displayed in the window.

 Infoarea
           Enable or disable the information area from being displayed in the
           window.


ΓòÉΓòÉΓòÉ 4.7.2. Fonts Choice ΓòÉΓòÉΓòÉ

Select the Fonts choice to set the font you want to use for the text that
displays in the active window.


ΓòÉΓòÉΓòÉ 4.7.2.1. Font Selection Window ΓòÉΓòÉΓòÉ

Use this window to change the font of the text in the current window.


ΓòÉΓòÉΓòÉ 4.7.3. Restore Defaults Choice ΓòÉΓòÉΓòÉ

Reset all of the source window settings to their original settings. This
includes the font, the style settings, and the presentation of tool buttons.


ΓòÉΓòÉΓòÉ 4.7.4. Notebook Choice ΓòÉΓòÉΓòÉ

Enable the Notebook choice to display the source windows in notebook format if
your source contains include files. Once you enable Notebook, it stays enabled
for all debugging sessions until you disable it.

You can enable or disable the Notebook choice by selecting it. When it is
enabled, a check mark symbol displays. If it is disabled, a check mark symbol
is not displayed.


ΓòÉΓòÉΓòÉ 4.7.5. Tool Buttons Choice ΓòÉΓòÉΓòÉ

Select the Tool buttons choice if you want the tool buttons to be shown in the
source windows.

If this choice is enabled, a check mark symbol displays beside the Tool buttons
choice and buttons display.


ΓòÉΓòÉΓòÉ 4.7.6. Hover Help Choice ΓòÉΓòÉΓòÉ

Select the Hover help choice if you want the hover help to be shown in the
source windows.

The hover help shows the names of the tool buttons.


ΓòÉΓòÉΓòÉ 4.7.7. Infoarea Choice ΓòÉΓòÉΓòÉ

Select the Infoarea choice if you want the information area to be shown in the
source windows.

The information area, which is located at the bottom of the window, provides a
brief description of each menu item.


ΓòÉΓòÉΓòÉ 4.7.8. Debugger Settings Cascading Choice ΓòÉΓòÉΓòÉ

Select choices from the Debugger settings cascading choice to set various
debugger options that control how the debugger windows display. These settings
affect the behavior of the debugger and remain in effect for the duration of
the debugging session.

Menu Summary

 Debugger properties...
           Select the view that is to be displayed when the debugger starts and
           how to process the views.

 Monitor properties...
           Select the settings for the variable monitor windows.

 Default data representation
           Select how you want your data displayed in the monitor windows.

 Program profiles
           Select where you want to store the debugger program profiles

 Exception filtering...
           Select exceptions that you want the debugger to recognize.

 Save debugger window positions
           Saves the window positions for this debugging session.  When you
           close the debugging session and start another session the default
           window position and sizes are displayed,

 Global font change...
           Change the font in the debugger windows.

 Enable window cascading
           Enable or disable the overlapping of debugger windows.

 Display tool buttons
           Enable or disable buttons from being displayed in all of the
           debugging windows.

 Display hover help
           Enable or disable the hover help from being displayed in all of the
           debugging window.

 Display inforarea
           Enable or disable the information area from being displayed in all
           of the debugging windows.

 Place tool buttons on title bar
           Enable or disable the tool buttons from being displayed in the title
           bar of all the debugging windows.


ΓòÉΓòÉΓòÉ 4.7.9. Debugger Properties Choice ΓòÉΓòÉΓòÉ

Select the Debugger properties choice to determine how your threads and source
files initially display and how they are handled when they stop or are no
longer active. When you select Debugger properties, the Debugger Properties
window displays.


ΓòÉΓòÉΓòÉ 4.7.10. Debugger Properties Window ΓòÉΓòÉΓòÉ

Use the Debugger Properties window to define:

 o How to process a source window from which control has just passed. The
   window can:

    - Remain displayed
    - Be turned into an icon
    - Be discarded.

 o Whether multiple views can be displayed.

 o Whether mouse button 2 performs a step function or displays a popup menu.

 Display at stop Group Box

 You can control how many source windows are displayed at once.

 The choices are:

 Only stopping thread
           Keeps, iconizes, or discards all views that are not the stopping
           thread.

 All threads
           Keeps, iconizes, or discards the views for old components within
           each thread.

 For example, if you select Only stopping thread, the Old source disposition
 applies to all of the source windows except the current view of the stopping
 thread. If you select All threads, the Old source disposition applies only to
 the source windows for the components from which execution has just left
 within a thread.

 Old source disposition Group Box

 In the course of debugging, these selections allow you to control the behavior
 of source windows from which control has just passed. The Old source
 disposition controls the behavior of source windows.

 The dispositions that the views can take are:

 Keep           Leaves open the source windows that contain the objects that
                you select with Display at stop.

 Iconize        Changes into icons the views that contain the objects that you
                select with Display at stop.

 Discard        Disposes of the windows that contain the objects that you
                select with Display at stop.

 Settings Group Box

 Multiple views Check Box

 You can choose to display more than one source window for a particular object.
 If this check box is enabled, when you open a new window for an object, the
 first window stays open and is overlaid by the second window. If this check
 box is disabled, the first window is closed when a second window is opened.
 The default is not to display multiple source windows.

 Mouse button 2 behavior Group Box

 Select one of the following radio buttons to perform the specified action:

 Popup menus    Displays the popup menus that are available from the window.

 Step always    Performs a step command.

 Popup menus and step in white space Displays the popup menus and performs a
                step command in the white space.
 Select the appropriate push button to continue.


ΓòÉΓòÉΓòÉ 4.7.11. Monitor Properties Choice ΓòÉΓòÉΓòÉ

Select the Monitor Properties choice to select the settings for monitoring
variables or expressions.

When you select Monitor properties, the Monitor Properties window displays.


ΓòÉΓòÉΓòÉ 4.7.11.1. Monitor Properties Window ΓòÉΓòÉΓòÉ

Use the Monitor Properties window to select the settings for monitoring
variables or expressions. You can set the following:

 o The window into which the variable or expression being monitored is placed.

 o For popup expression windows, how long the monitor windows display.

 After you have selected the settings you want from this window, select the
 appropriate push button to continue.

 For a description of the settings that are available from this window,
 double-click on one of the following topics:

 o Monitor Location

 o Popup Duration.


ΓòÉΓòÉΓòÉ 4.7.12. Show context Check Box ΓòÉΓòÉΓòÉ

Select the Show context check box to display the context for variables or
expressions when they are selected for monitoring.


ΓòÉΓòÉΓòÉ 4.7.13. Monitor Location Group Heading ΓòÉΓòÉΓòÉ

Choose one of the following radio buttons to select the monitor window that
opens when you select a variable or expression to monitor. The selections you
can make, and the corresponding windows, are:

 Popup
           Display the variable or expression in a popup expression window.

 Private monitor
           Display the variable or expression in the Private Monitor window.

 Program monitor
           Display the variable or expression in the Program Monitor window.

 Storage monitor
           Display the variable or expression in the Storage window.

 Related Information

 o Using the mouse
 o Selecting Variables with the Mouse and Monitor
 o Selecting Variables with the Keyboard


ΓòÉΓòÉΓòÉ 4.7.14. Enabled Check Box ΓòÉΓòÉΓòÉ

Select the Enabled check box to update the displayed contents of variables when
they are selected for monitoring.


ΓòÉΓòÉΓòÉ 4.7.15. Popup Duration ΓòÉΓòÉΓòÉ

If you select Popup from the Monitor location group heading, select one of the
following radio buttons to specify how long the popup expression window
displays:

 Step/run
           The monitor window closes when the next step command or Run is
           executed.

 New source
           The monitor window closes when execution stops in a new source.

 Permanent
           This monitor window is associated with a specific source window and
           is closed when the associated source window is closed.


ΓòÉΓòÉΓòÉ 4.7.16. Default Data Representation Cascading Choice ΓòÉΓòÉΓòÉ

When you select Default data representation, a cascaded menu displays with
language choices.  This lets you change the default representation for a data
type in the topguage that you select.


ΓòÉΓòÉΓòÉ 4.7.16.1. Default Representation Window ΓòÉΓòÉΓòÉ

Use the Default Representation window to select how you want your data
represented in the monitor windows. For example, you can change the default
representation for an integer in the C language from decimal to hexadecimal.

You change the representation of the value displayed in a monitor to:

 o Hexadecimal

 o Decimal

 o String

 o Character

 o Floating-point

 o Hexadecimal pointer

 o Decimal pointer

 o Array.

 Note:   The representation you can select varies with the data type being
 displayed.

 Select the appropriate radio button for the data type you want.

 Select the appropriate push button to continue.


ΓòÉΓòÉΓòÉ 4.7.17. Program Profiles Cascading Choice ΓòÉΓòÉΓòÉ

Select the Profile cascading choice to specify the where you want the debugger
program profiles stored or delete program profiles.

Menu Summary

 Select information
           Select the information to be saved in the program profile.

 Delete program profiles
           Delete program profiles for a program that you have debugged.

 Change location
           Change the location of the files that hold the debugger settings.


ΓòÉΓòÉΓòÉ 4.7.17.1. Select Information Choice ΓòÉΓòÉΓòÉ

Select the Select information choice to indicate what information you want
saved in the program profiles.  You may save breakpoints, breakpoint list
windows, settings for the Debug Session Control window, monitors, stack, and
source views.

When you select Select information, the Select information window displays.


ΓòÉΓòÉΓòÉ 4.7.17.1.1. Select Information Window ΓòÉΓòÉΓòÉ

Use the Select Information window to specify what information you want saved in
the program profile.

To specify what you want saved:

  1. Select from the list the items you want saved in your program profile.

  2. Select the appropriate push button.

 Save Profile Information Check Box

 Select the Save profile information check box to save the profile information
 you have highlighted.


ΓòÉΓòÉΓòÉ 4.7.17.2. Delete Program Profiles Choice ΓòÉΓòÉΓòÉ

Select the Delete program profiles choice to delete program profiles for a
program that you have previously debugged.

When you select Delete program profiles, the Delete Program Profiles window
displays.


ΓòÉΓòÉΓòÉ 4.7.17.2.1. Delete Program Profiles Window ΓòÉΓòÉΓòÉ

Use the Delete Program Profiles window to delete program profiles for a program
that you have previously debugged.

To delete program profiles:

  1. Select the path name and file name of the program whose program profiles
     you want to delete.

  2. Select the OK push button.

     Note:   You can delete program profiles to lessen the storage space
     required by the debugger files.


ΓòÉΓòÉΓòÉ 4.7.17.3. Change Location Choice ΓòÉΓòÉΓòÉ

Select the Change location choice to specify where you want the profile
information file stored. The debugger program profile file contains your
selections for most of the debugger settings and information. You choose
whether or not you want your selections saved for the next debugging session.

When you select Change location, the Change Location window displays.


ΓòÉΓòÉΓòÉ 4.7.17.3.1. Change Location Window ΓòÉΓòÉΓòÉ

Use the Change Location window to specify the directory where you want the
profile information (session settings and program profile) default options
saved.

To use specify the location, do the following:

  1. Type the full path name of the directory where you want the debugger
     profile information file stored in the Path entry field.

  2. Select the appropriate push button to continue.


ΓòÉΓòÉΓòÉ 4.7.18. Exception Filtering Choice ΓòÉΓòÉΓòÉ

When you select Exception filtering, the Exception Filtering window displays.
From this window, you select the exceptions that you want the debugger to
recognize.


ΓòÉΓòÉΓòÉ 4.7.18.1. Exception Filtering Window ΓòÉΓòÉΓòÉ

Use the Exception Filtering window to select exceptions that you want the
debugger to recognize.

To highlight an exception:

 o Select the exception by clicking on the name. It becomes highlighted.

 o Select the OK push button.

 If a highlighted exception is encountered during the execution of your
 program, the Exception window is displayed. Any other exceptions that are
 encountered are ignored.

 Select the appropriate push button to continue.


ΓòÉΓòÉΓòÉ 4.7.19. Save Debugger Window Position Choice ΓòÉΓòÉΓòÉ

Select the Save debugger window positions choice to save the position of all
debugger windows.

When you select this choice, the window positions are saved and the windows
display in the selected positions.


ΓòÉΓòÉΓòÉ 4.7.20. Global Font Change Choice ΓòÉΓòÉΓòÉ

Select the Global font change choice to change the font in the debugger
windows.

When you select Global font change, the Font window displays.

Note:   The Source window will not change.


ΓòÉΓòÉΓòÉ 4.7.21. Enable Window Cascading Choice ΓòÉΓòÉΓòÉ

When you enable this choice, successive windows that are opened overlap each
other on the screen. However, they are cascaded so that you can see the
underlying windows. When this choice is disabled, successive windows cover
previously displayed windows so that you do not see the underlying windows.


ΓòÉΓòÉΓòÉ 4.7.22. Display Tool Buttons Choice ΓòÉΓòÉΓòÉ

Select the Display tool buttons choice if you want the tool buttons to be shown
in all of the debugging windows.


ΓòÉΓòÉΓòÉ 4.7.23. Display Hover Help Choice ΓòÉΓòÉΓòÉ

Select the Display hover help choice if you want the hover help to be shown in
all of the debugging windows.


ΓòÉΓòÉΓòÉ 4.7.24. Display Infoarea Choice ΓòÉΓòÉΓòÉ

Select the Display infoarea choice if you want the information area to be shown
in all of the debugging windows.


ΓòÉΓòÉΓòÉ 4.7.25. Place Tool Buttons on Title Bar Choice ΓòÉΓòÉΓòÉ

Select the Place tool buttons on title bar choice if you want the tool buttons
to be shown in the title bar of all the debugging windows.


ΓòÉΓòÉΓòÉ 4.8. Windows Menu ΓòÉΓòÉΓòÉ

Select the Windows menu to display a list of all the open debugger windows.

Menu Summary

 Local variables
           Display the local variables for the current line of the program.

 Registers
           Monitor registers and flags for a particular thread.

 Call stack
           Monitor the call stack for a particular thread.

 Program monitor
           Display the Program Monitor window.

 Storage
           Monitor the storage that a program uses.

 Breakpoints
           Lists the set breakpoints.

 Debug session control
           Display the Debug Session Control window.


ΓòÉΓòÉΓòÉ 4.8.1. Local Variables Choice ΓòÉΓòÉΓòÉ

Select the Local variables choice to display the local variables (static,
automatic, and parameters) for the current function.

When you select Local variables, the Local Variables window displays.


ΓòÉΓòÉΓòÉ 4.8.2. Registers Choice ΓòÉΓòÉΓòÉ

Select the Registers choice to display the processor and math coprocessor
registers.


ΓòÉΓòÉΓòÉ 4.8.3. Call Stack Choice ΓòÉΓòÉΓòÉ

Select the Call stack choice to list the active functions or procedures for a
particular thread. When you select Call stack, the Call Stack window displays.


ΓòÉΓòÉΓòÉ 4.8.4. Storage Choice ΓòÉΓòÉΓòÉ

Select the Storage choice to display the contents of storage used by your
program.


ΓòÉΓòÉΓòÉ <hidden> Using the Storage Window ΓòÉΓòÉΓòÉ

You can scroll through storage using the up or down arrow keys and the PageUp
or PageDown keys.

To update the storage contents, type over the contents displayed in the Storage
window. The display is updated when an elapsed time of one second occurs after
the last keystroke has been typed. The contents of all affected windows are
updated for each character changed in the Storage window.

To specify a new address location, type over the address field displayed in the
Storage window. When an elapsed time of one second occurs after the last
keystroke has been typed, the window scrolls to the appropriate storage
location.


ΓòÉΓòÉΓòÉ 4.9. Help Menu ΓòÉΓòÉΓòÉ

Select choices from the Help menu to complement the online help information
that you can get for the debugger when you press F1 or select the Help push
button.

Menu Summary

 Help index
           An alphabetical index of all available debugger help topics.

 General help
           Help information for the active window.

 Using help
           How to use the IBM C/C++ Debugger help facility.

 How do I
           Display the debugger task help.

 Product information
           Display product information.

 The central portion of the Help menu is dedicated to all the online
 documentation that is shipped with VisualAge for C++. Making a selection from
 any of these cascade menus launches the VisualAge for C++ documentation
 associated with the menu item. You can find the same documentation in the
 Information notebook found in the VisualAge for C++ Desktop folder.

 The cascaded menus are organized as follows:

 At A Glance
           Provides general information about VisualAge for C++, such as
           installing the product, a notebook that accesses the sample
           programs, and answers to frequently asked questions.

 Using VisualAge for C++
           Provides direct access to the individual sections of the User's
           Guide. For example, if you are using the Browser, you would look in
           the Browsing section for more information.

 How Do I... Selections
           Provides access to the How Do I... information for each component of
           VisualAge for C++. Use How Do I... information to find out how to
           perform common tasks within VisualAge for C++.

 C/C++
           Provides access to the information that is specific to programming
           in C and C++.

 Class Libraries
           Provides access to the VisualAge for C++ Open Class Library
           documentation.

 Visual Programming
           Provides access to the information that is specific to creating your
           programs visually.

 IPF, and Editing
           Provides access to the IPF and Editor references.

 SOM
           Provides access to the information specific to SOM.

 Windows Programming
           Provides access to information about programming with the Win32
           Software Development Kit.

 Project Menu Help

 The Project menu gives you direct access to all of the actions that you can
 perform from your current location.


ΓòÉΓòÉΓòÉ 4.9.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Help index choice display an alphabetical list of index topics for
the debugger. Use the Find choice provided with the online help facility to
locate topics in the index.


ΓòÉΓòÉΓòÉ 4.9.2. Using Help Choice ΓòÉΓòÉΓòÉ

Select the Using help choice to display online help information about the help
facility.


ΓòÉΓòÉΓòÉ 4.9.3. General Help Choice ΓòÉΓòÉΓòÉ

Select the General help choice to display online help for the active debugger
window. The online help panel displayed is the same panel that displays when
you place your cursor inside the window and press F1.


ΓòÉΓòÉΓòÉ 4.9.4. How Do I Choice ΓòÉΓòÉΓòÉ

Select the How do I choice to display the online task help. This lists tasks
that you may want to do and instructions on how to complete these tasks.
functions, including the new C++ features.


ΓòÉΓòÉΓòÉ 4.9.5. Product Information Choice ΓòÉΓòÉΓòÉ

Select the Product information choice to display the product information.


ΓòÉΓòÉΓòÉ 5. Register Window ΓòÉΓòÉΓòÉ

Use the Register window to view or modify the contents of the registers
monitored for your program. One set of processor registers exists for each
thread.

In the Register window, floating-point registers display as floating-point
decimal numbers or as hexadecimal. They are updated based on the current
representation.

Register popup menu

The Register popup menu contains a choice that allows you to edit.

The following are the popup choices:

 Edit

 There are tool buttons active in this window. Double-click on any of the
 following for a description of that button.

 Menu Bar Summary

 File
           End your debugging session.

 Options
           Change the font used for the text in the Register window.

 Windows
           Displays the active debugger windows.

 Help
           Displays online help that compliments the information you get when
           you press F1 or select a Help push button.

 Related Information

 o Expression Language Guidelines


ΓòÉΓòÉΓòÉ 5.1. File Menu ΓòÉΓòÉΓòÉ

Select the File menu to end the debugging session.

Menu Summary

 Close debugger
           End the  current debugging session.


ΓòÉΓòÉΓòÉ 5.2. Edit Popup Choice ΓòÉΓòÉΓòÉ

Use the Edit choice to edit the registers.  When you select Edit, a multiple
line entry (MLE) displays allowing you to type in a new variable or expression.


ΓòÉΓòÉΓòÉ 5.2.1. Close Debugger Choice ΓòÉΓòÉΓòÉ

Select the Close debugger choice to close your current debugging session.

When you select the Close debugger choice, a message box prompts you to confirm
that you want to end the debugging session.


ΓòÉΓòÉΓòÉ 5.3. Options Menu ΓòÉΓòÉΓòÉ

Select the Options menu to change the fonts used for the text in the Register
window, and set debugger options.

Menu Summary

 Fonts
           Change the fonts for the text in the Register window.

 Display style...
           Select the items you want displayed in the window and how you want
           them displayed.

 Restore defaults
           Reset all of the window settings to their original settings.

 Tool buttons
           Enable or disable buttons from being displayed in the window.

 Hover help
           Enable or disable the hover help from being displayed in the window.

 Infoarea
           Enable or disable the information area from being displayed in the
           window.


ΓòÉΓòÉΓòÉ 5.3.1. Fonts Choice ΓòÉΓòÉΓòÉ

Select the Fonts choice to set the font you want to use for the text that
displays in the active window.

When you select Fonts, a Fonts window displays.


ΓòÉΓòÉΓòÉ 5.3.2. Display Style Choice ΓòÉΓòÉΓòÉ

Select the Display style choice to select the items you want displayed in the
window.

When you select Display style, the Display Style window displays.


ΓòÉΓòÉΓòÉ 5.3.2.1. Display Style Window ΓòÉΓòÉΓòÉ

Use the Display Style window to select the items you want to display in the
Register

To select the items you want:

  1. Select one or more items from the Groups Box. The items become
     highlighted.

  2. Select the OK push button.

 Orientation Group Box

 Select how you want the items by selecting one of the following radio buttons:

 Vertical     Display the items in the window in a vertical format.

 Horizontal   Display the items in the window in a horizontal format.

 Column titles Check Box

 Enable the Column titles check box to display column titles. When a check mark
 symbol displays, the titles are shown. When a check mark symbol is not
 displayed, the titles are not shown.

 Save split bars Check Box

 Enable the Save split bars check box to save the position of the split bars.
 When a check mark symbol displays, the position of the bars are saved. When a
 check mark symbol is not displayed, the position of the bars are not saved.


ΓòÉΓòÉΓòÉ 5.3.3. Restore Defaults Choice ΓòÉΓòÉΓòÉ

Reset all of the Register window settings to their original settings. This
includes the font, the style settings, and the presentation of tool buttons.


ΓòÉΓòÉΓòÉ 5.3.4. Tool Buttons Choice ΓòÉΓòÉΓòÉ

Select the Tool buttons choice if you want the tool buttons to be shown in the
window.

If this choice is enabled, a check mark symbol displays beside the Tool buttons
choice and the tool buttons will be shown.


ΓòÉΓòÉΓòÉ 5.3.5. Hover Help Choice ΓòÉΓòÉΓòÉ

Select the Hover help choice if you want the hover help to be shown in the
source windows.

The hover help shows the names of the tool buttons.


ΓòÉΓòÉΓòÉ 5.3.6. Infoarea Choice ΓòÉΓòÉΓòÉ

Select the Infoarea choice if you want the information area to be shown in the
source windows.

The information area, which is located at the bottom of the window, provides a
brief description of each menu item.


ΓòÉΓòÉΓòÉ 5.4. Windows Menu ΓòÉΓòÉΓòÉ

Select the Windows menu to display a list of all the open debugger windows.

Menu Summary

 Local variables
           Display the local variables for the current line of the program.

 Registers
           Monitor registers and flags for a particular thread.

 Call Stack
           Monitor the call stack for a particular thread.

 Private monitor
           Display the Private Monitor window. Collect variables or expressions
           that you want to monitor.

 Program monitor
           Display the Program Monitor window.

 Storage
           Monitor the storage that a program uses.

 Breakpoints
           Lists the set breakpoints.

 Debug session control
           Display the Debug Session Control window.


ΓòÉΓòÉΓòÉ 5.5. Help Menu ΓòÉΓòÉΓòÉ

Select choices from the Help menu to complement the online help information
that you can get for the debugger when you press F1 or select the Help push
button.

 Menu Summary

 Help index
           An alphabetical index of all available debugger help topics.

 General help
           Help information for the active window.

 Using help
           How to use the IBM C/C++ Debugger help facility.

 How do I
           Display the debugger task help.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 5.5.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Index choice display an alphabetical list of index topics for the
debugger. Use the Find choice provided with the online help facility to locate
topics in the index.


ΓòÉΓòÉΓòÉ 5.5.2. General Help Choice ΓòÉΓòÉΓòÉ

Select the General help choice to display online help for the active debugger
window. The online help panel displayed is the same panel that displays when
you place your cursor inside the window and press F1.


ΓòÉΓòÉΓòÉ 5.5.3. Using Help Choice ΓòÉΓòÉΓòÉ

Select the Using help choice to display online help information about the help
facility.


ΓòÉΓòÉΓòÉ 5.5.4. How Do I Choice ΓòÉΓòÉΓòÉ

Select the How do I choice to display the online task help. This lists tasks
that you may want to do and instructions on how to complete these tasks.
functions, including the new C++ features.


ΓòÉΓòÉΓòÉ 5.5.5. Product Information Choice ΓòÉΓòÉΓòÉ

Select the Product information choice to display the product information.


ΓòÉΓòÉΓòÉ 6. Call Stack Window ΓòÉΓòÉΓòÉ

The Call Stack window lists all of the active functions for a particular
thread.  The default is to display the functions in the upward growth
direction.  However, you can change the direction by selecting Options->Display
style and then selecting the Down radio button under the Growth direction group
heading.

Each Call Stack window displays call stack information for one thread only.
When the state of the program changes, such as when you execute the program or
you update displayed data, the Call Stack window changes to reflect the current
state. You can double-click on any call stack entry to display the source code
for that entry. The line that calls the next call stack entry is highlighted.
The remaining call stack size shows the bytes left in the stack for the thread.

Note:   If you do not follow the standard C++ calling conventions or if you
step into optimized code, the stack may not display correctly.

Tool buttons are provided for easy access to frequently used features.
Double-click on any of the following for a description of that button.

Function Popup Menu

The Function Popup Menu contains an option to display the function in the
current source window. The popup menu is shown when you click mouse button 2
with the mouse pointer on a highlighted function, unless the Step with mouse
button 2 check box on the Debugger Properties window is enabled. (If the check
box is enabled, clicking mouse button 2 performs a step over command.)

The following choice is available from the popup menu:

 View
   Show the function in the Source window.

 Menu Bar Summary

 File
           End your debugging session.

 Options
           Select the font you want to use for the text in the Call Stack
           window and select the parameters that control how the items on the
           call stack display.

 Windows
           Displays the active debugger windows.

 Help
           Provides you with online help information.


ΓòÉΓòÉΓòÉ <hidden> View Choice ΓòÉΓòÉΓòÉ

Select the View choice to show the highlighted function in the current source
window.


ΓòÉΓòÉΓòÉ 6.1. File Menu ΓòÉΓòÉΓòÉ

Select the File menu choice to end your debugging session.

Menu Summary

 Close debugger
           End your debugging session.


ΓòÉΓòÉΓòÉ 6.1.1. Close Debugger Choice ΓòÉΓòÉΓòÉ

Select the Close debugger choice to close your current debugging session.

When you select the Close debugger choice, a message box prompts you to confirm
that you want to end the debugging session.


ΓòÉΓòÉΓòÉ 6.2. Options Menu ΓòÉΓòÉΓòÉ

Select the Options menu choice to control how the items on the call stack
display, and to set various debugger options.

Menu Summary

 Fonts...
           Select the font you want displayed in the window.

 Display style...
           Control which items are displayed in the window.

 Restore defaults
           Reset all of the window settings to their original settings.

 Tool buttons
           Enable or disable the tool buttons from being displayed in the
           window.

 Hover help
           Enable or disable the hover help from being displayed in the window.

 Infoarea
           Enable or disable the information area from being displayed in the
           window.


ΓòÉΓòÉΓòÉ 6.2.1. Fonts Choice ΓòÉΓòÉΓòÉ

Select the Fonts choice to select the font you want for the Call Stack window.

When you select Fonts, the Fonts window displays.


ΓòÉΓòÉΓòÉ 6.2.2. Display Style Choice ΓòÉΓòÉΓòÉ

Select the Display style choice to control how the items on the call stack
display. You can select the type of information you want displayed for all of
the call stack items and you can choose to display new call stack items on the
top or the bottom of the stack.

When you select Display style, the Display Style window displays.


ΓòÉΓòÉΓòÉ 6.2.2.1. Display Style Window ΓòÉΓòÉΓòÉ

Use the Display Style window to select the items you want to display in the
Call Stack window.

To select the items you want:

  1. Select one or more items from the Select Items group box.  The items
     become highlighted.

  2. Select the OK push button.

 Growth Direction Group Box

 Select one of the following Growth direction radio buttons to determine how
 new items are displayed on the call stack.

 Up
           Displays new items at the top of the Call Stack window.

 Down
           Displays new items at the bottom of the Call Stack window.


ΓòÉΓòÉΓòÉ 6.2.3. Restore Defaults Choice ΓòÉΓòÉΓòÉ

Reset all of the Call Stack window settings to their original settings. This
includes the font, the style settings, and the presentation of tool buttons.


ΓòÉΓòÉΓòÉ 6.2.4. Tool Buttons Choice ΓòÉΓòÉΓòÉ

You can select if you want to display the buttons in the Stack window.

The tool buttons provide quick and easy access to frequently used features of
the debugger. If this choice is enabled, a check mark symbol displays beside
the Tool buttons choice and buttons display.


ΓòÉΓòÉΓòÉ 6.2.5. Hover Help Choice ΓòÉΓòÉΓòÉ

Select the Hover help choice if you want the hover help to be shown in the
window.

The hover help provides the name of the tool button.


ΓòÉΓòÉΓòÉ 6.2.6. Infoarea Choice ΓòÉΓòÉΓòÉ

Select the Infoarea choice if you want the information area to be shown in the
window.

The information area, which is located at the bottom of the window, provides a
brief description of each menu item.


ΓòÉΓòÉΓòÉ 6.3. Windows Menu ΓòÉΓòÉΓòÉ

Select the Windows menu to display a list of all the open debugger windows.

Menu Summary

 Local variables
           Display the local variables for the current line of the program.

 Registers
           Monitor registers and flags for a particular thread.

 Call Stack
           Monitor the call stack for a particular thread.

 Private monitor
           Display the Private Monitor window. Collect variables or expressions
           that you want to monitor.

 Program monitor
           Display the Program Monitor window.

 Storage
           Monitor the storage that a program uses.

 Breakpoints
           Lists the set breakpoints.

 Debug session control
           Display the Debug Session Control window.


ΓòÉΓòÉΓòÉ 6.4. Help Menu ΓòÉΓòÉΓòÉ

Select choices from the Help menu to complement the online help information
that you can get for the debugger when you press F1 or, if available, select
the Help push button.

Menu Summary

 Help index
           An alphabetical index of all available debugger help topics.

 General help
           Help information for the active window.

 Using help
           How to use the IBM C/C++ Debugger help facility.

 How do I
           Display the debugger task help.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 6.4.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Index choice display an alphabetical list of index topics for the
debugger. Use the Find choice provided with the online help facility to locate
topics in the index.


ΓòÉΓòÉΓòÉ 6.4.2. General Help Choice ΓòÉΓòÉΓòÉ

Select the General help choice to display online help for the active debugger
window. The online help panel displayed is the same panel that displays when
you place your cursor inside the window and press F1.


ΓòÉΓòÉΓòÉ 6.4.3. Using Help Choice ΓòÉΓòÉΓòÉ

Select the Using help choice to display online help information about the help
facility.


ΓòÉΓòÉΓòÉ 6.4.4. How do I Choice ΓòÉΓòÉΓòÉ

Select the How do I choice to display the online task help. This lists tasks
that you may want to do and instructions on how to complete these tasks.


ΓòÉΓòÉΓòÉ 6.4.5. Product Information Choice ΓòÉΓòÉΓòÉ

Select the Product information choice to display the product information.


ΓòÉΓòÉΓòÉ 7. Local Variables Window ΓòÉΓòÉΓòÉ

The Local Variables window displays the local variables for the current
execution point in a given thread. As execution moves from function to
function, the window updates with the new local variables.

Note:   When your program returns from a called function, the data display
options you previously selected (for example, representation) are lost. If you
want to save these display options, monitor the variable or expression in a
Private Monitor window, the Program Monitor window, or a popup expression
window.

To monitor only specific variables or expressions, instead of all the local
variables of a function, use the Program Monitor window.

There are tool buttons that may be active in this window. Double-click on any
of the following for a description of that button.

 Menu Bar Summary

 File
           End your debugging session.

 Edit
           Edit text and search for strings in the text.

 Options
           Control how the contents of variables display and set the debugger
           options.

 Windows
           Displays the active debugger windows.

 Help
           Displays online help that compliments the information you get when
           you press F1 or select a Help push button.

 Related Information

 o Monitor Properties
 o Program Monitor Window
 o Private Monitor Window
 o Popup Expression Window


ΓòÉΓòÉΓòÉ 7.1. File Menu ΓòÉΓòÉΓòÉ

Select the choice from the File menu to close the debugging session.

 Menu Summary

 Close debugger
           Close the debugging session.


ΓòÉΓòÉΓòÉ 7.1.1. Close Debugger Choice ΓòÉΓòÉΓòÉ

Select the Close debugger choice to close the current debugging session.

When you select the Close debugger choice, a message box prompts you to confirm
that you want to end the debugging session.


ΓòÉΓòÉΓòÉ 7.2. Edit Menu ΓòÉΓòÉΓòÉ

Select choices from the Edit menu to delete, select, and deselect expressions.

 Menu Summary

 Delete
           Delete all the selected expressions.

 Select all
           Select all expressions.

 Deselect all
           Deselect all expressions.

 Other elements
           Show the next 50 items that are associated with the selected
           variable or expression in the window.

 Representation
           Display the contents of a monitored variable in a different format.


ΓòÉΓòÉΓòÉ 7.2.1. Delete Choice ΓòÉΓòÉΓòÉ

Select the Delete choice to delete variables or expressions that are being
monitored from a monitor window.

To delete a variable or expression from a monitor window:

  1. Select the variable or expression with your mouse. The monitor for the
     variable or expression highlights.

  2. Select the Delete choice from the Options menu.


ΓòÉΓòÉΓòÉ 7.2.2. Select All Choice ΓòÉΓòÉΓòÉ

Select the Select all choice to select all the expressions in the window.


ΓòÉΓòÉΓòÉ 7.2.3. Deselect All Choice ΓòÉΓòÉΓòÉ

Select the Deselect all choice to cancel the selection of all the expressions
in the window.


ΓòÉΓòÉΓòÉ 7.2.4. Other Elements Choice ΓòÉΓòÉΓòÉ

Select the Other elements choice to view the next 50 items (classes, arrays, or
structures) that are related to the variable or expression that you are
monitoring.


ΓòÉΓòÉΓòÉ <hidden> Other Elements Window ΓòÉΓòÉΓòÉ

Enter the starting array index you wish to view.  50 elements of the array
starting with the element you entered will be shown.


ΓòÉΓòÉΓòÉ 7.2.5. Representation Cascading Choice ΓòÉΓòÉΓòÉ

Select the Representation cascading choice to display the contents of the
variable in a new representation. The types of representation that display on
the menu depend on the data type of the variable you are monitoring.

The following are possible representations:

 Hexadecimal
           Displays the contents of the monitored variable in hexadecimal
           notation.

 Decimal
           Displays the contents of the monitored variable in decimal notation.

 String
           Displays the contents of the monitored variable as a character
           string.

 Hexadecimal pointer
           Displays the contents of the monitored variable as a hexadecimal
           pointer.

 Decimal pointer
           Displays the contents of the monitored variable as a decimal
           pointer.

 Array
           Displays the contents of the monitored variable as an array.

 Floating point
           Displays the contents of the monitored variable in floating-point
           notation.

 Character
           Displays the contents of the monitored variable in character form.

 Note:   Floating point registers or variables display as either a
 floating-point decimal number or as a hexadecimal string. However, they cannot
 be updated with a hexadecimal string that represents a floating-point number.
 If you need to update a floating-point variable with a hexadecimal
 representation of a floating-point number, you must step through the
 Disassembly window to see when the variable loads into a register and then
 change the value in the Register window.


ΓòÉΓòÉΓòÉ 7.2.6. Representation Choices ΓòÉΓòÉΓòÉ

Select the Hexadecimal choice to display the contents of a variable that is
being monitored in hexadecimal notation.

Select the Decimal choice to display the contents of a variable that is being
monitored in decimal notation.

Select the String choice to display the contents of a monitored variable as a
character string.

Select the Hexadecimal pointer choice to display the contents of a monitored
variable as a hexadecimal pointer.

Select the Decimal pointer choice to display the contents of a monitored
variable as a decimal pointer.

Select the Array choice to display the contents of a monitored variable as an
array.

Select the Floating point choice to display the contents of a monitored
variable in floating-point notation.

Select the Character choice to display the contents of a monitored variable in
the form of a character.


ΓòÉΓòÉΓòÉ 7.2.7. Representation Choices ΓòÉΓòÉΓòÉ

Select the Hexadecimal choice to display the contents of a variable that is
being monitored in hexadecimal notation.

Select the Decimal choice to display the contents of a variable that is being
monitored in decimal notation.

Select the String choice to display the contents of a monitored variable as a
character string.

Select the Hexadecimal pointer choice to display the contents of a monitored
variable as a hexadecimal pointer.

Select the Decimal pointer choice to display the contents of a monitored
variable as a decimal pointer.

Select the Array choice to display the contents of a monitored variable as an
array.

Select the Floating point choice to display the contents of a monitored
variable in floating-point notation.

Select the Character choice to display the contents of a monitored variable in
the form of a character.


ΓòÉΓòÉΓòÉ 7.2.8. Representation Choices ΓòÉΓòÉΓòÉ

Select the Hexadecimal choice to display the contents of a variable that is
being monitored in hexadecimal notation.

Select the Decimal choice to display the contents of a variable that is being
monitored in decimal notation.

Select the String choice to display the contents of a monitored variable as a
character string.

Select the Hexadecimal pointer choice to display the contents of a monitored
variable as a hexadecimal pointer.

Select the Decimal pointer choice to display the contents of a monitored
variable as a decimal pointer.

Select the Array choice to display the contents of a monitored variable as an
array.

Select the Floating point choice to display the contents of a monitored
variable in floating-point notation.

Select the Character choice to display the contents of a monitored variable in
the form of a character.


ΓòÉΓòÉΓòÉ 7.2.9. Representation Choices ΓòÉΓòÉΓòÉ

Select the Hexadecimal choice to display the contents of a variable that is
being monitored in hexadecimal notation.

Select the Decimal choice to display the contents of a variable that is being
monitored in decimal notation.

Select the String choice to display the contents of a monitored variable as a
character string.

Select the Hexadecimal pointer choice to display the contents of a monitored
variable as a hexadecimal pointer.

Select the Decimal pointer choice to display the contents of a monitored
variable as a decimal pointer.

Select the Array choice to display the contents of a monitored variable as an
array.

Select the Floating point choice to display the contents of a monitored
variable in floating-point notation.

Select the Character choice to display the contents of a monitored variable in
the form of a character.


ΓòÉΓòÉΓòÉ 7.3. Options Menu ΓòÉΓòÉΓòÉ

Select choices from the Options menu to control how the contents of variables
display and to set the debugger options.

 Menu Summary

 Fonts
           Select the font for the text in the Local Variables window.

 Restore defaults
           Reset all of the window settings to their original settings.

 Show context
           Display the contextual information for all selected expressions.

 Tool buttons
           Enable or disable buttons from being displayed in the window.

 Hover help
           Enable or disable the hover help from being displayed in the window.

 Infoarea
           Enable or disable the information area from being displayed in the
           window.


ΓòÉΓòÉΓòÉ 7.3.1. Fonts Choice ΓòÉΓòÉΓòÉ

Select the Fonts choice to set the font you want to use for the text that
displays in the active window.


ΓòÉΓòÉΓòÉ 7.3.2. Restore Defaults Choice ΓòÉΓòÉΓòÉ

Reset all of the Local Variables window settings to their original settings.
This includes the font, the style settings, and the presentation of tool
buttons.


ΓòÉΓòÉΓòÉ 7.3.3. Show Context Choice ΓòÉΓòÉΓòÉ

Select the Show context choice to display the contextual information for the
variable you are monitoring. The following information displays:

 o Source

 o File

 o Line

 o Thread.


ΓòÉΓòÉΓòÉ 7.3.4. Tool Buttons Choice ΓòÉΓòÉΓòÉ

Select the Tool buttons choice if you want the tool buttons to be shown in the
window.

The tool buttons provide quick and easy access to frequently used features of
the debugger. If this choice is enabled, a check mark symbol displays beside
the Tool buttons choice and buttons display.


ΓòÉΓòÉΓòÉ 7.3.5. Hover Help Choice ΓòÉΓòÉΓòÉ

Select the Hover help choice if you want the hover help to be shown in the
window.

The hover help provides the name of the tool button.


ΓòÉΓòÉΓòÉ 7.3.6. Infoarea Choice ΓòÉΓòÉΓòÉ

Select the Infoarea choice if you want the information area to be shown in the
window.

The information area, which is located at the bottom of the window, provides a
brief description of each menu item.


ΓòÉΓòÉΓòÉ 7.4. Windows Menu ΓòÉΓòÉΓòÉ

Select the Windows menu to display a list of all the open debugger windows.

Menu Summary

 Local variables
           Display the local variables for the current line of the program.

 Registers
           Monitor registers and flags for a particular thread.

 Call Stack
           Monitor the call stack for a particular thread.

 Private monitor
           Display the Private Monitor window. Collect variables or expressions
           that you want to monitor.

 Program monitor
           Display the Program Monitor window.

 Storage
           Monitor the storage that a program uses.

 Breakpoints
           Lists the set breakpoints.

 Debug session control
           Display the Debug Session Control window.


ΓòÉΓòÉΓòÉ 7.5. Help Menu ΓòÉΓòÉΓòÉ

Select choices from the Help menu to complement the online help information
that you can get for the debugger when you press F1 or select the Help push
button.

Menu Summary

 Help index
           An alphabetical index of all available debugger help topics.

 General help
           Help information for the active window.

 Using help
           How to use the debugger help facility.

 How do I
           Display the debugger task help.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 7.5.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Index choice display an alphabetical list of index topics for the
debugger. Use the Find choice provided with the online help facility to locate
topics in the index.


ΓòÉΓòÉΓòÉ 7.5.2. General Help Choice ΓòÉΓòÉΓòÉ

Select the General help choice to display online help for the active debugger
window. The online help panel displayed is the same panel that displays when
you place your cursor inside the window and press F1.


ΓòÉΓòÉΓòÉ 7.5.3. Using Help Choice ΓòÉΓòÉΓòÉ

Select the Using help choice to display online help information about the help
facility.


ΓòÉΓòÉΓòÉ 7.5.4. How do I Choice ΓòÉΓòÉΓòÉ

Select the How do I choice to display the online task help. This lists tasks
that you may want to do and instructions on how to complete these tasks.


ΓòÉΓòÉΓòÉ 7.5.5. Product Information Choice ΓòÉΓòÉΓòÉ

Select the Product information choice to display the product information.


ΓòÉΓòÉΓòÉ 8. Program Monitor Window ΓòÉΓòÉΓòÉ

Use the Program Monitor window to collect variables or expressions that you
want to monitor. This window is not associated with any specific source window
and remains open at all times unless you close it.

You can select the variables or expressions you want to display from the source
window by:

 o Using the mouse
 o Using the mouse and monitor expression window
 o Using the keyboard.

 You must select an expression with a valid:

 o Operand type
 o Operator
 o Typecasting operation.

 There are tool buttons active in this window. Double-click on any of the
 following for a description of that button.

 Monitor Popup Menu

 The Monitor Popup Menu contains options that you can perform on the variables
 or expressions in the monitor. The popup menu is shown when you click mouse
 button 2 with the mouse pointer on a variable or expression in the monitor,
 unless the Step with mouse button 2 check box on the Debugger Properties
 window is enabled. (If the check box is enabled, clicking mouse button 2
 performs a step over command.)

 Popup Menu Summary

 Delete
   Delete the selected variable or expression that is being monitored.

 Disable
   Prevent the displayed contents of a variable or expression from updating.

 Enable
   Display the contents of a variable or expression as it changes.

 Edit
   Change the variable or expression.

 Next representation
   Change the representation of the variable or expression to the next on the
   list.

 Change font
   Change the font of the variable or expression in the window.

 Dereference
   Show the value to which the pointer points.

 Other elements
   Show the next 50 items that are associated with the selected variable or
   expression in the window.

 Menu Bar Summary

 File
           End your debugging session.

 Edit
           Edit text and search for strings in the text.

 Options
           Control how the contents of variables display, to set the debugger
           options, and end your debugging session.

 Windows
           Displays the active debugger windows.

 Help
           Displays online help that compliments the information you get when
           you press F1 or select a Help push button.


ΓòÉΓòÉΓòÉ 8.1. Edit Choice ΓòÉΓòÉΓòÉ

Select the Edit choice to change the variable or expression.


ΓòÉΓòÉΓòÉ 8.2. Enable Choice ΓòÉΓòÉΓòÉ

Select the Enable choice to allow the expression to be monitored.


ΓòÉΓòÉΓòÉ 8.2.1. Delete Choice ΓòÉΓòÉΓòÉ

Select the Delete choice to delete variables or expressions that are being
monitored from a monitor window.

To delete a variable or expression from a monitor window:

  1. Select the variable or expression with your mouse. The monitor for the
     variable or expression highlights.

  2. Select the Delete choice from the Options menu.


ΓòÉΓòÉΓòÉ 8.3. Disable Choice ΓòÉΓòÉΓòÉ

Select the Disable choice to disable the expression from being monitored.


ΓòÉΓòÉΓòÉ 8.4. Change Font Choice ΓòÉΓòÉΓòÉ

Select the Change font choice to change the font of the text  a in the window.
When you select this choice, the Fonts window displays.


ΓòÉΓòÉΓòÉ 8.5. Dereference ΓòÉΓòÉΓòÉ

Select the Dereference choice to show the storage contents of a pointer.


ΓòÉΓòÉΓòÉ 8.6. Other Elements Choice ΓòÉΓòÉΓòÉ

Select the Other Elements choice to show an alternate range of an array or
structure.

Related Information

 o Monitor Properties
 o Program Monitor Window
 o Private Monitor Window
 o Popup Expression Window


ΓòÉΓòÉΓòÉ 8.7. Next Representation Choice ΓòÉΓòÉΓòÉ

Select the Next representation choice to change the representation of the
variable or expression to the next representation on the list.


ΓòÉΓòÉΓòÉ <hidden> Run Button ΓòÉΓòÉΓòÉ

Runs the program, executing all enabled threads. Control returns to the
debugger when:

 o the program ends

 o execution stops at an enabled breakpoint.

 When the debugger is running the run button changes to


ΓòÉΓòÉΓòÉ <hidden> Halt Button ΓòÉΓòÉΓòÉ

Stops the execution of your program.

Note:   The Halt button does not display in the tool bar if you are debugging
remotely.


ΓòÉΓòÉΓòÉ <hidden> Debug Session Control Button ΓòÉΓòÉΓòÉ

Displays the Debug Session Control window.


ΓòÉΓòÉΓòÉ <hidden> Change Representation Button ΓòÉΓòÉΓòÉ

Allows you to change the data representation of a variable or expression.


ΓòÉΓòÉΓòÉ <hidden> Delete Button ΓòÉΓòÉΓòÉ

Deletes the highlighted expression.


ΓòÉΓòÉΓòÉ <hidden> Delete All Button ΓòÉΓòÉΓòÉ

Deletes all occurrences of the highlighted expression.


ΓòÉΓòÉΓòÉ 8.8. File Menu ΓòÉΓòÉΓòÉ

Select choice from the File menu to close current debugging session.

 Menu Summary

 Close Debugger
           End your current debugging session.


ΓòÉΓòÉΓòÉ 8.8.1. Close Debugger Choice ΓòÉΓòÉΓòÉ

Select the Close debugger choice to close the current debugging session.

When you select the Close debugger choice, a message box prompts you to confirm
that you want to end the debugging session.


ΓòÉΓòÉΓòÉ 8.9. Edit Menu ΓòÉΓòÉΓòÉ

Select choices from the Edit menu to delete, select, and deselect expressions.

 Menu Summary

 Delete
           Delete all the selected expressions.

 Delete all
           Delete all variables or monitored expressions.

 Select all
           Select all expressions.

 Deselect all
           Deselect all expressions.

 Enable
           Display the contents of a variable or expression as it changes.

 Disable
           Prevent the displayed contents of a variable or expression from
           updating.

 Other elements
           Select a range of 50 items to view.

 Representation
           Display the contents of a monitored variable in a different format.


ΓòÉΓòÉΓòÉ 8.9.1. Delete Choice ΓòÉΓòÉΓòÉ

Select the Delete choice to delete variables or expressions that are being
monitored from a monitor window.

To delete a variable or expression from a monitor window:

  1. Select the variable or expression with your mouse. The monitor for the
     variable or expression highlights.

  2. Select the Delete choice from the Options menu.


ΓòÉΓòÉΓòÉ 8.9.2. Delete All Choice ΓòÉΓòÉΓòÉ

Select the Delete all choice to delte all variables or expressions that are
being monitored from a monitor window.


ΓòÉΓòÉΓòÉ 8.9.3. Select All Choice ΓòÉΓòÉΓòÉ

Select the Select all choice to select all the expressions in the window.


ΓòÉΓòÉΓòÉ 8.9.4. Deselect All Choice ΓòÉΓòÉΓòÉ

Select the Deselect all choice to cancel the selection of all the expressions
in the window.


ΓòÉΓòÉΓòÉ 8.9.5. Enable Choice ΓòÉΓòÉΓòÉ

Select the Enable choice to have the displayed contents of a variable or
expression updated as the state of the program changes.


ΓòÉΓòÉΓòÉ 8.9.6. Disable Choice ΓòÉΓòÉΓòÉ

Select the Disable choice to prevent the displayed contents of a variable or
expression from updating as the state of the program changes.


ΓòÉΓòÉΓòÉ 8.9.7. Other Elements Choice ΓòÉΓòÉΓòÉ

Select the Other elements choice to view the next 50 items (classes, arrays, or
structures) that are related to the variable or expression that you are
monitoring.


ΓòÉΓòÉΓòÉ 8.9.8. Representation Cascading Choice ΓòÉΓòÉΓòÉ

Select the Representation cascading choice to display the contents of the
variable in a new representation. The types of representation that display on
the menu depend on the data type of the variable you are monitoring.

The following are possible representations:

 Hexadecimal
           Displays the contents of the monitored variable in hexadecimal
           notation.

 Decimal
           Displays the contents of the monitored variable in decimal notation.

 String
           Displays the contents of the monitored variable as a character
           string.

 Hexadecimal pointer
           Displays the contents of the monitored variable as a hexadecimal
           pointer.

 Decimal pointer
           Displays the contents of the monitored variable as a decimal
           pointer.

 Array
           Displays the contents of the monitored variable as an array.

 Floating point
           Displays the contents of the monitored variable in floating-point
           notation.

 Character
           Displays the contents of the monitored variable in character form.

 Note:   Floating point registers or variables display as either a
 floating-point decimal number or as a hexadecimal string. However, they cannot
 be updated with a hexadecimal string that represents a floating-point number.
 If you need to update a floating-point variable with a hexadecimal
 representation of a floating-point number, you must step through the
 Disassembly window to see when the variable loads into a register and then
 change the value in the Register window.


ΓòÉΓòÉΓòÉ 8.9.9. Representation Choices ΓòÉΓòÉΓòÉ

Select the Hexadecimal choice to display the contents of a variable that is
being monitored in hexadecimal notation.

Select the Decimal choice to display the contents of a variable that is being
monitored in decimal notation.

Select the String choice to display the contents of a monitored variable as a
character string.

Select the Hexadecimal pointer choice to display the contents of a monitored
variable as a hexadecimal pointer.

Select the Decimal pointer choice to display the contents of a monitored
variable as a decimal pointer.

Select the Array choice to display the contents of a monitored variable as an
array.

Select the Floating point choice to display the contents of a monitored
variable in floating-point notation.

Select the Character choice to display the contents of a monitored variable in
the form of a character.


ΓòÉΓòÉΓòÉ 8.9.10. Representation Choices ΓòÉΓòÉΓòÉ

Select the Hexadecimal choice to display the contents of a variable that is
being monitored in hexadecimal notation.

Select the Decimal choice to display the contents of a variable that is being
monitored in decimal notation.

Select the String choice to display the contents of a monitored variable as a
character string.

Select the Hexadecimal pointer choice to display the contents of a monitored
variable as a hexadecimal pointer.

Select the Decimal pointer choice to display the contents of a monitored
variable as a decimal pointer.

Select the Array choice to display the contents of a monitored variable as an
array.

Select the Floating point choice to display the contents of a monitored
variable in floating-point notation.

Select the Character choice to display the contents of a monitored variable in
the form of a character.


ΓòÉΓòÉΓòÉ 8.9.11. Representation Choices ΓòÉΓòÉΓòÉ

Select the Hexadecimal choice to display the contents of a variable that is
being monitored in hexadecimal notation.

Select the Decimal choice to display the contents of a variable that is being
monitored in decimal notation.

Select the String choice to display the contents of a monitored variable as a
character string.

Select the Hexadecimal pointer choice to display the contents of a monitored
variable as a hexadecimal pointer.

Select the Decimal pointer choice to display the contents of a monitored
variable as a decimal pointer.

Select the Array choice to display the contents of a monitored variable as an
array.

Select the Floating point choice to display the contents of a monitored
variable in floating-point notation.

Select the Character choice to display the contents of a monitored variable in
the form of a character.


ΓòÉΓòÉΓòÉ 8.9.12. Representation Choices ΓòÉΓòÉΓòÉ

Select the Hexadecimal choice to display the contents of a variable that is
being monitored in hexadecimal notation.

Select the Decimal choice to display the contents of a variable that is being
monitored in decimal notation.

Select the String choice to display the contents of a monitored variable as a
character string.

Select the Hexadecimal pointer choice to display the contents of a monitored
variable as a hexadecimal pointer.

Select the Decimal pointer choice to display the contents of a monitored
variable as a decimal pointer.

Select the Array choice to display the contents of a monitored variable as an
array.

Select the Floating point choice to display the contents of a monitored
variable in floating-point notation.

Select the Character choice to display the contents of a monitored variable in
the form of a character.


ΓòÉΓòÉΓòÉ 8.10. Options Menu ΓòÉΓòÉΓòÉ

Select choices from the Options menu to control how the contents of variables
display and to set the debugger options.

 Menu Summary

 Fonts
           Select the font for the text in the Local Variables window.

 Restore defaults
           Reset all of the window settings to their original settings.

 Show enablement
           Show the enablement status of variables and expressions on the
           Program Monitor window.

 Show context
           Display the contextual information for all selected expressions.

 Tool buttons
           Enable or disable buttons from being displayed in the window.

 Hover help
           Enable or disable the hover help from being displayed in the window.

 Infoarea
           Enable or disable the information area from being displayed in the
           window.


ΓòÉΓòÉΓòÉ 8.10.1. Fonts Choice ΓòÉΓòÉΓòÉ

Select the Fonts choice to set the font you want to use for the text that
displays in the active window.


ΓòÉΓòÉΓòÉ 8.10.2. Restore Defaults Choice ΓòÉΓòÉΓòÉ

Reset all of the Program Monitor window settings to their original settings.
This includes the font, the style settings, and the presentation of tool
buttons.


ΓòÉΓòÉΓòÉ 8.10.3. Show Enablement Choice ΓòÉΓòÉΓòÉ

Select the Show enablement choice to show the enablement status of a variable
or expression. If a variable or expression is enabled, the displayed contents
is updated as they change.

If this choice is enabled, a check mark symbol displays beside the Show
enablement choice and the enablement status is shown.

If you disable this choice, the enablement status is not shown.


ΓòÉΓòÉΓòÉ 8.10.4. Show Context Choice ΓòÉΓòÉΓòÉ

Select the Show context choice to display the contextual information for the
variable you are monitoring. The following information displays:

 o Source

 o File

 o Line

 o Thread.


ΓòÉΓòÉΓòÉ 8.10.5. Tool Buttons Choice ΓòÉΓòÉΓòÉ

Select the Tool buttons choice if you want the tool buttons to be shown in the
window.

The tool buttons provide quick and easy access to frequently used features of
the debugger. If this choice is enabled, a check mark symbol displays beside
the Tool buttons choice and buttons display.


ΓòÉΓòÉΓòÉ 8.10.6. Hover Help Choice ΓòÉΓòÉΓòÉ

Select the Hover help choice if you want the hover help to be shown in the
window.

The hover help provides the name of the tool button.


ΓòÉΓòÉΓòÉ 8.10.7. Infoarea Choice ΓòÉΓòÉΓòÉ

Select the Infoarea choice if you want the information area to be shown in the
window.

The information area, which is located at the bottom of the window, provides a
brief description of each menu item.


ΓòÉΓòÉΓòÉ 8.11. Windows Menu ΓòÉΓòÉΓòÉ

Select the Windows menu to display a list of all the open debugger windows.

Menu Summary

 Local variables
           Display the local variables for the current line of the program.

 Registers
           Monitor registers and flags for a particular thread.

 Call Stack
           Monitor the call stack for a particular thread.

 Private monitor
           Display the Private Monitor window. Collect variables or expressions
           that you want to monitor.

 Program monitor
           Display the Program Monitor window.

 Storage
           Monitor the storage that a program uses.

 Breakpoints
           Lists the set breakpoints.

 Debug session control
           Display the Debug Session Control window.


ΓòÉΓòÉΓòÉ 8.12. Help Menu ΓòÉΓòÉΓòÉ

Select choices from the Help menu to complement the online help information
that you can get for the debugger when you press F1 or select the Help push
button.

Menu Summary

 Help index
           An alphabetical index of all available debugger help topics.

 General help
           Help information for the active window.

 Using help
           How to use the debugger help facility.

 How do I
           Display the debugger task help.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 8.12.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Index choice display an alphabetical list of index topics for the
debugger. Use the Find choice provided with the online help facility to locate
topics in the index.


ΓòÉΓòÉΓòÉ 8.12.2. General Help Choice ΓòÉΓòÉΓòÉ

Select the General help choice to display online help for the active debugger
window. The online help panel displayed is the same panel that displays when
you place your cursor inside the window and press F1.


ΓòÉΓòÉΓòÉ 8.12.3. Using Help Choice ΓòÉΓòÉΓòÉ

Select the Using help choice to display online help information about the help
facility.


ΓòÉΓòÉΓòÉ 8.12.4. How do I Choice ΓòÉΓòÉΓòÉ

Select the How do I choice to display the online task help. This lists tasks
that you may want to do and instructions on how to complete these tasks.


ΓòÉΓòÉΓòÉ 8.12.5. Product Information Choice ΓòÉΓòÉΓòÉ

Select the Product information choice to display the product information.


ΓòÉΓòÉΓòÉ 9. Popup Expression Window ΓòÉΓòÉΓòÉ

The Popup Expression window displays the variable or expression you select for
monitoring. It is associated with a specific source window and is closed when
the associated window is closed.

You can select the variables or expressions you want to display:

 o Using the mouse

 o Using the mouse and the Monitor window

 o Using the keyboard.

 You must select an expression with a valid:

 o Operand type

 o Operator

 o Typecasting operation.
 Related Information

 o Local Variables Window
 o Monitor Properties
 o Program Monitor Window
 o Private Monitor Window


ΓòÉΓòÉΓòÉ 10. Private Monitor Window ΓòÉΓòÉΓòÉ

Use the Private Monitor window to collect variables or expressions that you
want to monitor. This window is associated with a specific source window and is
closed when the associated source window is closed.

You can select the variables or expressions you want to display from a window:

 o Using the mouse

 o Using the mouse and the Monitor window

 o Using the keyboard.

 You must select an expression with a valid:

 o Operand type

 o Operator

 o Typecasting operation.

 There are tool buttons available from this window. Double-click on any of the
 following for a description of that button.

  Menu Bar Summary

 Edit
           Edit text and search for strings in the text.

 Options
           Control how the contents of variables display, to set the debugger
           options, and end your debugging session.

 Help
           Displays online help that compliments the information you get when
           you press F1 or select a Help push button.

 Related Information

 o Monitor Properties
 o Program Monitor Window
 o Private Monitor Window
 o Popup Expression Window


ΓòÉΓòÉΓòÉ 10.1. Edit Menu ΓòÉΓòÉΓòÉ

Select choices from the Edit menu to delete, select, and deselect expressions.

 Menu Summary

 Delete
           Delete all the selected expressions.

 Delete all
           Delete all variables or monitored expressions.

 Select all
           Select all expressions.

 Deselect all
           Deselect all expressions.

 Enable
           Display the contents of a variable or expression as it changes.

 Disable
           Prevent the displayed contents of a variable or expression from
           updating.

 Other elements
           Select a range of 50 items to view.

 Representation
           Display the contents of a monitored variable in a different format.


ΓòÉΓòÉΓòÉ 10.1.1. Delete Choice ΓòÉΓòÉΓòÉ

Select the Delete choice to delete variables or expressions that are being
monitored from a monitor window.

To delete a variable or expression from a monitor window:

  1. Select the variable or expression with your mouse. The monitor for the
     variable or expression highlights.

  2. Select the Delete choice from the Options menu.


ΓòÉΓòÉΓòÉ 10.1.2. Delete All Choice ΓòÉΓòÉΓòÉ

Select the Delete all choice to delte all variables or expressions that are
being monitored from a monitor window.


ΓòÉΓòÉΓòÉ 10.1.3. Select All Choice ΓòÉΓòÉΓòÉ

Select the Select all choice to select all the expressions in the window.


ΓòÉΓòÉΓòÉ 10.1.4. Deselect All Choice ΓòÉΓòÉΓòÉ

Select the Deselect all choice to cancel the selection of all the expressions
in the window.


ΓòÉΓòÉΓòÉ 10.1.5. Enable Choice ΓòÉΓòÉΓòÉ

Select the Enable choice to have the displayed contents of a variable or
expression updated as the state of the program changes.


ΓòÉΓòÉΓòÉ 10.1.6. Disable Choice ΓòÉΓòÉΓòÉ

Select the Disable choice to prevent the displayed contents of a variable or
expression from updating as the state of the program changes.


ΓòÉΓòÉΓòÉ 10.1.7. Other Elements Choice ΓòÉΓòÉΓòÉ

Select the Other elements choice to view the next 50 items (classes, arrays, or
structures) that are related to the variable or expression that you are
monitoring.


ΓòÉΓòÉΓòÉ 10.1.8. Representation Cascading Choice ΓòÉΓòÉΓòÉ

Select the Representation cascading choice to display the contents of the
variable in a new representation. The types of representation that display on
the menu depend on the data type of the variable you are monitoring.

The following are possible representations:

 Hexadecimal
           Displays the contents of the monitored variable in hexadecimal
           notation.

 Decimal
           Displays the contents of the monitored variable in decimal notation.

 String
           Displays the contents of the monitored variable as a character
           string.

 Hexadecimal pointer
           Displays the contents of the monitored variable as a hexadecimal
           pointer.

 Decimal pointer
           Displays the contents of the monitored variable as a decimal
           pointer.

 Array
           Displays the contents of the monitored variable as an array.

 Floating point
           Displays the contents of the monitored variable in floating-point
           notation.

 Character
           Displays the contents of the monitored variable in character form.

 Note:   Floating point registers or variables display as either a
 floating-point decimal number or as a hexadecimal string. However, they cannot
 be updated with a hexadecimal string that represents a floating-point number.
 If you need to update a floating-point variable with a hexadecimal
 representation of a floating-point number, you must step through the
 Disassembly window to see when the variable loads into a register and then
 change the value in the Register window.


ΓòÉΓòÉΓòÉ 10.1.9. Representation Choices ΓòÉΓòÉΓòÉ

Select the Hexadecimal choice to display the contents of a variable that is
being monitored in hexadecimal notation.

Select the Decimal choice to display the contents of a variable that is being
monitored in decimal notation.

Select the String choice to display the contents of a monitored variable as a
character string.

Select the Hexadecimal pointer choice to display the contents of a monitored
variable as a hexadecimal pointer.

Select the Decimal pointer choice to display the contents of a monitored
variable as a decimal pointer.

Select the Array choice to display the contents of a monitored variable as an
array.

Select the Floating point choice to display the contents of a monitored
variable in floating-point notation.

Select the Character choice to display the contents of a monitored variable in
the form of a character.


ΓòÉΓòÉΓòÉ 10.1.10. Representation Choices ΓòÉΓòÉΓòÉ

Select the Hexadecimal choice to display the contents of a variable that is
being monitored in hexadecimal notation.

Select the Decimal choice to display the contents of a variable that is being
monitored in decimal notation.

Select the String choice to display the contents of a monitored variable as a
character string.

Select the Hexadecimal pointer choice to display the contents of a monitored
variable as a hexadecimal pointer.

Select the Decimal pointer choice to display the contents of a monitored
variable as a decimal pointer.

Select the Array choice to display the contents of a monitored variable as an
array.

Select the Floating point choice to display the contents of a monitored
variable in floating-point notation.

Select the Character choice to display the contents of a monitored variable in
the form of a character.


ΓòÉΓòÉΓòÉ 10.1.11. Representation Choices ΓòÉΓòÉΓòÉ

Select the Hexadecimal choice to display the contents of a variable that is
being monitored in hexadecimal notation.

Select the Decimal choice to display the contents of a variable that is being
monitored in decimal notation.

Select the String choice to display the contents of a monitored variable as a
character string.

Select the Hexadecimal pointer choice to display the contents of a monitored
variable as a hexadecimal pointer.

Select the Decimal pointer choice to display the contents of a monitored
variable as a decimal pointer.

Select the Array choice to display the contents of a monitored variable as an
array.

Select the Floating point choice to display the contents of a monitored
variable in floating-point notation.

Select the Character choice to display the contents of a monitored variable in
the form of a character.


ΓòÉΓòÉΓòÉ 10.1.12. Representation Choices ΓòÉΓòÉΓòÉ

Select the Hexadecimal choice to display the contents of a variable that is
being monitored in hexadecimal notation.

Select the Decimal choice to display the contents of a variable that is being
monitored in decimal notation.

Select the String choice to display the contents of a monitored variable as a
character string.

Select the Hexadecimal pointer choice to display the contents of a monitored
variable as a hexadecimal pointer.

Select the Decimal pointer choice to display the contents of a monitored
variable as a decimal pointer.

Select the Array choice to display the contents of a monitored variable as an
array.

Select the Floating point choice to display the contents of a monitored
variable in floating-point notation.

Select the Character choice to display the contents of a monitored variable in
the form of a character.


ΓòÉΓòÉΓòÉ 10.2. Options Menu ΓòÉΓòÉΓòÉ

Select choices from the Options menu to control how the contents of variables
display and to set the debugger options.

 Menu Summary

 Fonts
           Select the font for the text in the Local Variables window.

 Restore defaults
           Reset all of the window settings to their original settings.

 Show enablement
           Show the enablement status of variables and expressions on the
           Private Monitor window.

 Show context
           Display the contextual information for all selected expressions.

 Tool buttons
           Enable or disable buttons from being displayed in the window.

 Hover help
           Enable or disable the hover help from being displayed in the window.

 Infoarea
           Enable or disable the information area from being displayed in the
           window.


ΓòÉΓòÉΓòÉ 10.2.1. Fonts Choice ΓòÉΓòÉΓòÉ

Select the Fonts choice to set the font you want to use for the text that
displays in the active window.


ΓòÉΓòÉΓòÉ 10.2.2. Restore Defaults Choice ΓòÉΓòÉΓòÉ

Reset all of the Private Monitor window settings to their original settings.
This includes the font, the style settings, and the presentation of tool
buttons.


ΓòÉΓòÉΓòÉ 10.2.3. Show Enablement Choice ΓòÉΓòÉΓòÉ

Select the Show enablement choice to show enablement of a monitored expression
in the active wiindow.


ΓòÉΓòÉΓòÉ 10.2.4. Show Context Choice ΓòÉΓòÉΓòÉ

Select the Show context choice to display the contextual information for the
variable you are monitoring. The following information displays:

 o Source

 o File

 o Line

 o Thread.


ΓòÉΓòÉΓòÉ 10.2.5. Tool Buttons Choice ΓòÉΓòÉΓòÉ

Select the Tool buttons choice if you want the tool buttons to be shown in the
window.

The tool buttons provide quick and easy access to frequently used features of
the debugger. If this choice is enabled, a check mark symbol displays beside
the Tool buttons choice and buttons display.


ΓòÉΓòÉΓòÉ 10.2.6. Hover Help Choice ΓòÉΓòÉΓòÉ

Select the Hover help choice if you want the hover help to be shown in the
window.

The hover help provides the name of the tool button.


ΓòÉΓòÉΓòÉ 10.2.7. Infoarea Choice ΓòÉΓòÉΓòÉ

Select the Infoarea choice if you want the information area to be shown in the
window.

The information area, which is located at the bottom of the window, provides a
brief description of each menu item.


ΓòÉΓòÉΓòÉ 10.3. Windows Menu ΓòÉΓòÉΓòÉ

Select the Windows menu to display a list of all the open debugger windows.

Menu Summary

 Local variables
           Display the local variables for the current line of the program.

 Registers
           Monitor registers and flags for a particular thread.

 Call Stack
           Monitor the call stack for a particular thread.

 Private monitor
           Display the Private Monitor window. Collect variables or expressions
           that you want to monitor.

 Program monitor
           Display the Program Monitor window.

 Storage
           Monitor the storage that a program uses.

 Breakpoints
           Lists the set breakpoints.

 Debug session control
           Display the Debug Session Control window.


ΓòÉΓòÉΓòÉ 10.4. Help Menu ΓòÉΓòÉΓòÉ

Select choices from the Help menu to complement the online help information
that you can get for the debugger when you press F1 or select the Help push
button.

Menu Summary

 Help index
           An alphabetical index of all available debugger help topics.

 General help
           Help information for the active window.

 Using help
           How to use the debugger help facility.

 How do I
           Display the debugger task help.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 10.4.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Index choice display an alphabetical list of index topics for the
debugger. Use the Find choice provided with the online help facility to locate
topics in the index.


ΓòÉΓòÉΓòÉ 10.4.2. General Help Choice ΓòÉΓòÉΓòÉ

Select the General help choice to display online help for the active debugger
window. The online help panel displayed is the same panel that displays when
you place your cursor inside the window and press F1.


ΓòÉΓòÉΓòÉ 10.4.3. Using Help Choice ΓòÉΓòÉΓòÉ

Select the Using help choice to display online help information about the help
facility.


ΓòÉΓòÉΓòÉ 10.4.4. How do I Choice ΓòÉΓòÉΓòÉ

Select the How do I choice to display the online task help. This lists tasks
that you may want to do and instructions on how to complete these tasks.


ΓòÉΓòÉΓòÉ 10.4.5. Product Information Choice ΓòÉΓòÉΓòÉ

Select the Product information choice to display the product information.


ΓòÉΓòÉΓòÉ <hidden> Using the Variable Monitors ΓòÉΓòÉΓòÉ

After you have selected a variable or expression for monitoring, you can:

 o Enable or disable monitors

 o Display context

 o Change the value of a variable

 o Change the representation of a variable or expression.


ΓòÉΓòÉΓòÉ <hidden> Enabling and Disabling Monitors ΓòÉΓòÉΓòÉ

You can enable and disable monitors. When enabled, the monitor updates the stop
value of the program to actual value in storage. However, a disabled monitor
suspends this updating and reflects the stop value or the value held when the
monitor was disabled.

You cannot change the value of a disabled monitor. When you enable a disabled
monitor, the current value displays.


ΓòÉΓòÉΓòÉ <hidden> Displaying Context ΓòÉΓòÉΓòÉ

Monitors display the data value in their context. The context consists of:

 o Source

 o File

 o Line

 o Thread.


ΓòÉΓòÉΓòÉ <hidden> Changing the Value of a Variable ΓòÉΓòÉΓòÉ

You can change the value of a variable or expression that displays in a
monitor. To change the value, do the following:

  1. Select the variable or expression with your mouse or the Tab key.

  2. Type in the new value.

  3. Press Enter (or select another part of the debugger).


ΓòÉΓòÉΓòÉ <hidden> Changing the Representation ΓòÉΓòÉΓòÉ

To change the representation, do the following:

  1. Select the expression.

  2. Select an alternate representation from the Options -> Default data
     representation choice. The new representation takes effect immediately.

 You change the representation of the value displayed in a monitor to:

 o Hexadecimal

 o Decimal

 o String

 o Character

 o Floating-point

 o Hexadecimal pointer

 o Decimal pointer

 o Array.

 Note:   The representation you can select varies with the data type being
 displayed.


ΓòÉΓòÉΓòÉ <hidden> Supported Expression Operands ΓòÉΓòÉΓòÉ

You can monitor an expression that uses the following types of operands only:

 Operand             Definition

 Variable            A variable used in your program.

 Constant            The constant can be one of the following types:

                     o Fixed or floating-point constant.

                       Note:   The largest floating-point constant is 1.8E308.
                       The smallest floating-point is 2.23E-308.

                     o A string constant, enclosed in quotation marks (" ")

                     o A character constant, enclosed in single quote marks ('
                       ')

 Register            One of the following register names:
                     AX, BX, CX, DX, AL, BL, CL, DL, AH, BH, CH, DH, EAX, EBX,
                     ECX, EDX, ESP, EBP, ESI, EDI, EIP, CS, DS, ES, FS, GS, SS,
                     EFLAGS.
                     One of the following floating-point register names:
                     ST0 through ST7, FPCW, FPSW, FPTW, FPEIP, FPCS, FPEDP,
                     FPDS.

                     In the case of conflicting names, the program variable
                     names take precedence over the register names. For
                     conversions that are done automatically when the registers
                     display in mixed-mode expressions, general purpose
                     registers are treated as unsigned arithmetic items with a
                     length appropriate to the register. For example, EAX is
                     32-bits, AX is 16-bits, and AL is 8-bits.

 If you monitor an enumerated variable, a comment displays to the right of the
 value.  If the value of the variable matches one of the enumerated types, the
 comment contains the name of the first enumerated type that matches the value
 of the variable. If the length of the enumerated name does not fit in the
 monitor, the contents display as an empty entry field.

 The comment (empty or not) lets you distinguish between a valid enumerated
 value and an invalid value. An invalid value does not have a comment to the
 right of the value.

 You can not update an enumerated variable by entering an enumerated type. You
 must enter a value or expression. If the value is a valid enumerated value,
 the comment to the right of the value updates.

 Bit fields are supported for C/C++ compiled code only. You can display and
 update bit fields, but you cannot use them in expressions. You cannot look at
 variables that have been defined using the define preprocessor directive.


ΓòÉΓòÉΓòÉ <hidden> Supported Expression Operators ΓòÉΓòÉΓòÉ

You can monitor an expression that uses the following operators only:

 Operator                      Coded as

 Global scope resolution       ::a

 Class scope resolution        a::b

 Subscripting                  a[b]

 Member selection              a.b or a->b

 Size                          sizeof a or sizeof (type)

 Logical not                   !a

 Ones complement               ~a

 Unary minus                   -a

 Unary plus                    +a

 Dereference                   *a

 Type cast                     (type) a

 Multiply                      a * b

 Divide                        a / b

 Modulo                        a % b

 Add                           a + b

 Subtract                      a - b

 Left shift                    a << b

 Right shift                   a >> b

 Less than                     a < b

 Greater than                  a > b

 Less than or equal to         a <= b

 Greater than or equal to      a >= b

 Equal                         a == b

 Not equal                     a != b

 Bitwise AND                   a & b

 Bitwise OR                    a | b

 Bitwise exclusive OR          a ^ b

 Logical AND                   a && b

 Logical OR                    a || b


ΓòÉΓòÉΓòÉ <hidden> Supported Data Types ΓòÉΓòÉΓòÉ

You can monitor an expression that uses the following typecasting operations
only:

 o 8-bit signed byte

 o 8-bit unsigned byte

 o 16-bit signed integer

 o 16-bit unsigned integer

 o 32-bit signed integer

 o 32-bit unsigned integer

 o 32-bit floating-point

 o 64-bit floating-point

 o 80-bit floating-point

 o Pointers

 o User-defined types.

 These data types include int, short, char and so on.


ΓòÉΓòÉΓòÉ 11. Storage Window ΓòÉΓòÉΓòÉ

Use the Storage window to view and update the contents of the storage used by
your program. The following storage data displays in the Storage window:

 o Field for the displayed addresses. You may select the following storage
   model for the addresses that display:

    - Flat storage model addresses

 o Fields for the data storage contents. Storage can be displayed in various
   styles. However, you can display only one storage style at a time.

 o Titles for the displayed addresses and storage content fields.

 You can open multiple storage windows to view different storage locations at
 once.  When the state of your program changes, the contents of the Storage
 window updates to reflect the change.

 To scroll through memory, use one of the following methods:

 o Scroll bars

 o Up and Down arrow keys

 o PageUp and PageDown keys.

 The address of the cursor displays in the window of the Storage window.

 You can update the contents of storage or view the contents of storage at a
 new address location.

 Storage popup menu

 The Storage popup menu contains choices that allow you to edit or change the
 address.

 The following are the popup choices:

 Edit
   Displays a Mutiple Line Entry (MLE) that allows you to type in a new
   address.

 Change address
   Allows you to view storage at a different address.

 There are tool buttons available from this window. Double-click on any of the
 following for a description of that button.

 You can also access any debugger window that is already open and hidden or
 minimized by selecting the menu choice that displays that window from the
 Windows menu.

 Menu Bar Summary

 File
           End your debugging session.

 Options
           Set options that control how the storage content and addresses
           display.

 Windows
           Displays the active debugger windows.

 Help
           Displays online help that compliments the information you get when
           you press F1 or select a Help push button.

 Double-click on one of the following topics to find out how to update the
 contents of storage or specify a new address location:

 Related Information

 o Updating Storage
 o Specifying an Address Location
 o Expression Language Guidelines


ΓòÉΓòÉΓòÉ 11.1. Edit Popup Choice ΓòÉΓòÉΓòÉ

Use the Edit popup choice to type a new address. When you select Edit, a
multiple line entry (MLE) displays allowing you to type in a new address.


ΓòÉΓòÉΓòÉ <hidden> Edit Popup Choice ΓòÉΓòÉΓòÉ

Use the Edit popup choice to type a new address. When you select Edit, a
multiple line entry (MLE) displays allowing you to type in a new address.


ΓòÉΓòÉΓòÉ <hidden> Change Address Popup Choice ΓòÉΓòÉΓòÉ

Use the Change address popup choice to view the storage at a new address.


ΓòÉΓòÉΓòÉ 11.2. File Menu ΓòÉΓòÉΓòÉ

Select choice from the File menu to end your debugging session.

Menu Summary

 Close debugger
           End your debugging session.


ΓòÉΓòÉΓòÉ 11.2.1. Close Debugger Choice ΓòÉΓòÉΓòÉ

Select the Close debugger choice to close the current debugging session.

When you select the Close debugger choice, a message box prompts you to confirm
that you want to end the debugging session.


ΓòÉΓòÉΓòÉ 11.3. Options Menu ΓòÉΓòÉΓòÉ

Select choices from the Options menu to control how the storage contents and
addresses display, control the display of the storage window control
attributes, and end your debugging session.

Menu Summary

 Fonts
           Select the font for the text in the Storage window.

 Display style...
           Change the storage display format.

 Monitor expression
           Type the name of the variable or expression you want to monitor.

 Restore defaults
           Reset all of the window settings to their original settings.

 Tool buttons
           Enable or disable buttons from being displayed in the window.

 Hover help
           Enable or disable the hover help from being displayed in the window.

 Infoarea
           Enable or disable the information area from being displayed in the
           window.


ΓòÉΓòÉΓòÉ 11.3.1. Fonts Choice ΓòÉΓòÉΓòÉ

Select the Fonts choice to set the font you want to use for the text that
displays in the active window.


ΓòÉΓòÉΓòÉ 11.3.2. Display Style Choice ΓòÉΓòÉΓòÉ

Select the Display style choice to display the format for the storage contents
and storage addresses, and change the columns per line that display. You can
select from several storage display styles.

When you select Display style, the Display Style window displays.


ΓòÉΓòÉΓòÉ 11.3.2.1. Display Style Window ΓòÉΓòÉΓòÉ

Use the Display Style window to select the parameters that control how the
storage contents display and set how the storage addresses display.

Content Style

Select how you want the storage contents displayed. You can select from several
storage display styles.

To select the storage content style:

  1. Scroll to the content style you want.

  2. Select the content style.

  3. The style becomes highlighted.

 Address Style

 Select how you want the address style displayed.

 To select an address style:

  1. Scroll to the address style you want.

  2. Select the address style.

  3. The address style becomes highlighted.

 Columns per line

 Select the number of columns per line you want displayed in the Storage
 window.

 Use the Up or Down arrow keys to select the number of columns you want
 displayed in the Storage window. The available number of columns per line are
 1-16.

 Column titles

 Select this check box to display the titles of the columns in the Storage
 window.


ΓòÉΓòÉΓòÉ 11.3.3. Monitor Expression Choice ΓòÉΓòÉΓòÉ

Select the Monitor expression choice to type in the expression or variable that
you want to monitor.

When you select Monitor expression, the Monitor Expression In Storage window
displays.


ΓòÉΓòÉΓòÉ 11.3.3.1. Monitor Expression In Storage Window ΓòÉΓòÉΓòÉ

Use the Monitor Expression In Storage window to type in the expression you want
to monitor.

To specify an expression:

  1. Type the name of the variable or expression you want to monitor in the
     Expression entry field.

 You must select an expression with:

 o A valid operand type

 o A valid operator

 o A valid typecasting operation

 The expression evaluator used is based on the context.  For example if you
 display the Storage window by selecting the Monitor expression choice from the
 Variable menu, the evaluator used is based on the context in the Monitor
 Expression window.  However, if you display the Storage window first and then
 select the Monitor expression choice from the Options menu of the Storage
 window, the evaluator used is based on the context of the stopping thread.

 Note:   You cannot look at variables that have been defined using the define
 preprocessor directive. If the variable is not in scope when the monitor is
 opened, the default address is displayed.  If the variable goes out of scope,
 the address is changed to a hex constant.

 If you enable the Enabled monitor check box, the monitor updates the stop
 value of the program to the actual value in storage. However, a disabled
 monitor suspends this updating and reflects the stop value or the value held
 when the monitor was disabled.

 Related Information

 o Expression Language Guidelines.


ΓòÉΓòÉΓòÉ 11.3.4. Restore Defaults Choice ΓòÉΓòÉΓòÉ

Reset all of the Storage window settings to their original settings. This
includes the font, the style settings, and the presentation of tool buttons.


ΓòÉΓòÉΓòÉ 11.3.5. Tool Buttons Choice ΓòÉΓòÉΓòÉ

Select the Tool buttons choice if you want the tool buttons to be shown in the
window.

The tool buttons provide quick and easy access to frequently used features of
the debugger. If this choice is enabled, a check mark symbol displays beside
the Tool buttons choice and buttons display.


ΓòÉΓòÉΓòÉ 11.3.6. Hover Help Choice ΓòÉΓòÉΓòÉ

Select the Hover help choice if you want the hover help to be shown in the
window.

The hover help provides the name of the tool button.


ΓòÉΓòÉΓòÉ 11.3.7. Infoarea Choice ΓòÉΓòÉΓòÉ

Select the Infoarea choice if you want the information area to be shown in the
window.

The information area, which is located at the bottom of the window, provides a
brief description of each menu item.


ΓòÉΓòÉΓòÉ 11.4. Windows Menu ΓòÉΓòÉΓòÉ

Select the Windows menu to display a list of all the open debugger windows.

Menu Summary

 Local variables
           Display the local variables for the current line of the program.

 Registers
           Monitor registers and flags for a particular thread.

 Call Stack
           Monitor the call stack for a particular thread.

 Private monitor
           Display the Private Monitor window. Collect variables or expressions
           that you want to monitor.

 Program monitor
           Display the Program Monitor window.

 Storage
           Monitor the storage that a program uses.

 Breakpoints
           Lists the set breakpoints.

 Debug session control
           Display the Debug Session Control window.


ΓòÉΓòÉΓòÉ 11.5. Help Menu ΓòÉΓòÉΓòÉ

Select choices from the Help menu to complement the online help information
that you can get for the debugger when you press F1 or select the Help push
button.

Menu Summary

 Help index
           An alphabetical index of all available debugger help topics.

 General help
           Help information for the active window.

 Using help
           How to use the debugger help facility.

 How do I
           Display the debugger task help.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 11.5.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Index choice display an alphabetical list of index topics for the
debugger. Use the Find choice provided with the online help facility to locate
topics in the index.


ΓòÉΓòÉΓòÉ 11.5.2. General Help Choice ΓòÉΓòÉΓòÉ

Select the General help choice to display online help for the active debugger
window. The online help panel displayed is the same panel that displays when
you place your cursor inside the window and press F1.


ΓòÉΓòÉΓòÉ 11.5.3. Using Help Choice ΓòÉΓòÉΓòÉ

Select the Using help choice to display online help information about the help
facility.


ΓòÉΓòÉΓòÉ 11.5.4. How do I Choice ΓòÉΓòÉΓòÉ

Select the How do I choice to display the online task help. This lists tasks
that you may want to do and instructions on how to complete these tasks.


ΓòÉΓòÉΓòÉ 11.5.5. Product Information Choice ΓòÉΓòÉΓòÉ

Select the Product information choice to display the product information.


ΓòÉΓòÉΓòÉ <hidden> Storage Display Styles ΓòÉΓòÉΓòÉ

You can display storage content in the following value styles:

 o Hexadecimal and character text

 o Character text

 o 16-bit integer

 o 16-bit unsigned integer

 o 16-bit integer in hexadecimal (byte reversed)

 o 32-bit integer

 o 32-bit unsigned integer

 o 32-bit integer in hexadecimal (byte reversed)

 o 32-bit floating-point

 o 64-bit floating-point

 o 16-bit near pointers

 o 32-bit flat pointers.

 o Hexadecimal and EBCDIC

 o EBCDIC

 You can display storage in the following address style:

 o Flat only

 You can also change the number of columns per line that display. This number
 varies depending on the content style you have selected.


ΓòÉΓòÉΓòÉ <hidden> Updating Storage ΓòÉΓòÉΓòÉ

To update the contents of storage in the Storage window, use one of the
following methods:

 o Highlight the appropriate line and press Enter.  An entry field displays,
   Type the new storage information in the entry field.

 o Double-click on the appropriate column.  An entry field displays. Type in
   the new storage information.

 To move around in the Storage window, press the Tab key to move the selected
 column to the right or press Shift+Tab to move the selected column to the
 left. The up and down arrow keys move the highlighted line up and down.

 After you have made a change in the Storage window, click anywhere in the
 window and it saves your changes.  If you enter an incorrect storage address,
 a prompt box displays and the previous storage address is returned in the
 column.


ΓòÉΓòÉΓòÉ <hidden> Specifying an Address Location ΓòÉΓòÉΓòÉ

To view the storage at a different address, double-click on the address which
causes a Multiple Line Entry (MLE) field to display. Type the new address in
the MLE field. You can choose to update the Flat address field. The Storage
window scrolls to the appropriate address.


ΓòÉΓòÉΓòÉ 12. Breakpoint List Window ΓòÉΓòÉΓòÉ

Use the Breakpoints window to display a list of the breakpoints that have been
set. The following information is provided for each breakpoint:

 o The enablement state
 o The type of breakpoint
 o The position of the breakpoint
 o The conditions under which the breakpoint is activated.

 Tool buttons are provide for easy access to frequently used features.
 Double-click on any of the following for a description of that button.

 Note:   The Halt button is not shown does not display in the tool bar when
 debugging remotely.

 Breakpoints List popup menu

 The Breakpoints List Popup Menu contains options that you can perform on a
 breakpoint. The popup menu is shown when you click mouse button 2 with the
 mouse pointer on a highlighted breakpoint, unless the Step with mouse button 2
 check box on the Debugger Properties window is enabled. (If the check box is
 enabled, clicking mouse button 2 performs a step over command.)

 View
   Show the highlighted breakpoint in the Source window.

 Delete
   Delete the highlighted breakpoint.

 Disable
   Disable the highlighted breakpoint.

 Enable
   Enable the highlighted breakpoint.

   Note:   Enabling a breakpoint will not cause the internal counters
   associated with the From, Every, and To fields to be reset.

 Modify
   Modify the highlighted breakpoint.

 Delete all
   Delete all breakpoints.

 Note:   The Disable choice is shown if the highlighted breakpoint is enabled.
 The Enable choice is shown if the highlighted breakpoint is disabled.

 Menu Bar Summary

 File
           End the debugging session.

 Edit
           Delete, disable, or modify breakpoints.

 Set
           Set and manipulate breakpoints in your program.

 Options
           Control how items are displayed, change the font and sort items.

 Windows
           Displays the active debugger windows.

 Help
           Displays online help that compliments the information you get when
           you press F1 or select a Help push button.

 Related Information

 o Breakpoints Menu
 o Sort Breakpoint List Window


ΓòÉΓòÉΓòÉ <hidden> View Choice ΓòÉΓòÉΓòÉ

Select the View choice to show the highlighted breakpoint in the current source
window.


ΓòÉΓòÉΓòÉ <hidden> Delete Choice ΓòÉΓòÉΓòÉ

Select the Delete choice to delete the highlighted breakpoint.

To delete a breakpoint:

  1. Highlight the breakpoint you want to delete.
  2. Select the Delete choice.


ΓòÉΓòÉΓòÉ <hidden> Disable Choice ΓòÉΓòÉΓòÉ

Select the Disable choice to disable the highlighted breakpoint.

To disable a breakpoint:

  1. Highlight the breakpoint you want to disable.
  2. Select the Disable choice.


ΓòÉΓòÉΓòÉ 12.1. Enable Choice ΓòÉΓòÉΓòÉ

Select the Enable choice to enable the highlighted breakpoint.

To enable a breakpoint:

  1. Highlight the breakpoint you want to enable.
  2. Select the Enable choice.


ΓòÉΓòÉΓòÉ <hidden> Modify Choice ΓòÉΓòÉΓòÉ

Use the Modify choice to change the highlighted breakpoint.

To modify a breakpoint:

  1. Highlight the breakpoint you want to change.

  2. Select the Modify choice. The Line Breakpoint window is shown.

  3. The entry fields contain the information pertaining to that breakpoint.
     Make your changes to the entry fields.

  4. Select OK to accept the changes and close the window. If you want to make
     other changes, select Set to accept the changes and keep the window open.

 Note:   Modifying a breakpoint will cause the internal counters associated
 with the From, Every, and To fields to be reset.


ΓòÉΓòÉΓòÉ <hidden> Delete All Choice ΓòÉΓòÉΓòÉ

Delete all breakpoints that are currently set in your program.

To delete all the breakpoints:

  1. Select the Delete all choice. The Delete All Breakpoints window is shown.
  2. Select Yes on the Delete All Breakpoints window.


ΓòÉΓòÉΓòÉ 12.2. File Menu ΓòÉΓòÉΓòÉ

Select the choice from the File menu of the Breakpoint window to end the
debugging session.

Menu Summary

 Close debugger
           End the debugging session.


ΓòÉΓòÉΓòÉ 12.2.1. Close Debugger Choice ΓòÉΓòÉΓòÉ

Select the Close debugger choice to close your current debugging session.

When you select the Close debugger choice, a message box prompts you to confirm
that you want to end the debugging session.


ΓòÉΓòÉΓòÉ 12.3. Edit Menu ΓòÉΓòÉΓòÉ

Select choices from the Edit menu to delete, disable, modify, and enable
breakpoints.

Menu Bar Summary

 Delete
           Delete a breakpoint.

 Disable/Enable
           Disable a breakpoint or enable a breakpoint depending on the
           breakpoint status.

 Modify
           Modify a breakpoint.

 Delete all
           Deletes all breakpoints.

 Disable all
           Disable all breakpoints.

 Enable all
           Enable all breakpoints.


ΓòÉΓòÉΓòÉ 12.3.1. Delete Choice ΓòÉΓòÉΓòÉ

Select the Delete choice to delete the highlighted breakpoint.

To delete a breakpoint:

  1. Highlight the breakpoint you want to delete.
  2. Select the Delete choice.


ΓòÉΓòÉΓòÉ 12.3.2. Delete All Choice ΓòÉΓòÉΓòÉ

Delete all breakpoints that are currently set in your program.

To delete all the breakpoints:

  1. Select the Delete all choice. The Delete All Breakpoints window is shown.
  2. Select Yes on the Delete All Breakpoints window.


ΓòÉΓòÉΓòÉ 12.3.3. Disable/Enable Choice ΓòÉΓòÉΓòÉ

Select the Disable choice to disable the highlighted breakpoint or use the
Enable choice to make the breakpoint active.

To disable a breakpoint:

  1. Highlight the breakpoint you want to disable.
  2. Select the Disable choice.

 Select the Enable choice to make the breakpoint active.

 To enable a breakpoint:

  1. Highlight the breakpoint you want to enable.
  2. Select the Enable choice.


ΓòÉΓòÉΓòÉ 12.3.4. Modify Choice ΓòÉΓòÉΓòÉ

Use the Modify choice to change the breakpoints that have been set in your
program.

To modify a breakpoint:

  1. Highlight the breakpoint you want to change.

  2. Select the Modify choice.

  3. The entry fields contain the information pertaining to that breakpoint.
     Make your changes to the entry fields.

  4. Accepts the changes and close the window. If you want to make other
     changes, select Set to accept the changes and keep the window open.


ΓòÉΓòÉΓòÉ 12.3.5. Disable All Choice ΓòÉΓòÉΓòÉ

Use the Disable all choice to disable all the breakpoints that have been set in
your program.


ΓòÉΓòÉΓòÉ 12.3.6. Enable All Choice ΓòÉΓòÉΓòÉ

Use the Enable all choice to enable all the breakpoints that have been set in
your program.


ΓòÉΓòÉΓòÉ 12.4. Set Menu ΓòÉΓòÉΓòÉ

Select choices from the Set menu to set breakpoints and to stop the execution
of your program at any point. You can set as many breakpoints as you want.

Breakpoints can be set from the Debug Session Control window or from a source
window. When you set a breakpoint in one view of your program, it is reflected
in the other appropriate views.

There are five types of breakpoints that you can set. You can customize the
breakpoints using the various breakpoint windows.

Menu Summary

 Set line...
           Set a line breakpoint to stop the execution of your program at a
           specific line number.

 Set function...
           Set a function breakpoint to stop the execution of your program
           after calling a specific function.

 Set address...
           Set an address breakpoint to stop the execution of your program at a
           specific address.

 Set change address...
           Set a change address breakpoint to stop the execution of your
           program when contents of memory at a given address changes.

 Set load occurrence...
           Set a load occurrence breakpoint to stop the execution of your
           program after loading a DLL.


ΓòÉΓòÉΓòÉ 12.4.1. Set Address Choice ΓòÉΓòÉΓòÉ

Select the Address choice to stop the execution of your program at the selected
address. When you select Address, the Address Breakpoint window displays.


ΓòÉΓòÉΓòÉ 12.4.2. Set Change Address Choice ΓòÉΓòÉΓòÉ

Select the Change address choice to stop the execution of your program after
the contents of memory at a given address changes. When you select Change
address, the Change Address Breakpoint


ΓòÉΓòÉΓòÉ 12.4.3. Set Function Choice ΓòÉΓòÉΓòÉ

Select the Function choice to stop the execution of your program after the
function that you specify is called. When you select Function, the Function
Breakpoint window displays.


ΓòÉΓòÉΓòÉ 12.4.4. Set Line Choice ΓòÉΓòÉΓòÉ

Select the Line choice to stop the execution of your program at the line number
you select. When you select Line, the Line Breakpoint window displays.

You can also set simple line breakpoints. Double-click on one of the following
for the procedures you use to set or clear simple line breakpoints:

 o Setting simple line breakpoints

 o Deleting simple line breakpoints.


ΓòÉΓòÉΓòÉ 12.4.5. Set Load Occurrence Choice ΓòÉΓòÉΓòÉ

Select the Load Occurrence choice to stop the execution of your program after
the DLL that you specify is loaded. When you select Load Occurrence, the Load
Occurrence Breakpoint window displays.


ΓòÉΓòÉΓòÉ 12.5. Options Menu ΓòÉΓòÉΓòÉ

 Fonts
           Choose the font for the active window.

 Display style...
           Choose how the breakpoints display.

 Sort
           Sort the breakpoints.

 Restore defaults
           Reset all of the window settings to their original settings.

 Tool buttons
           Enable or disable buttons from being displayed in the window.

 Hover help
           Enable or disable the hover help from being displayed in the window.

 Infoarea
           Enable or disable the information area from being displayed in the
           window.


ΓòÉΓòÉΓòÉ 12.5.1. Display Style Choice ΓòÉΓòÉΓòÉ

Select the Display style choice to select the characteristics of the breakpoint
you want displayed. When you select Display style, the Display Style window
displays.


ΓòÉΓòÉΓòÉ <hidden> Display Style Window ΓòÉΓòÉΓòÉ

Use the Display Style window to control how the items in the breakpoint list
display. You can select the type of descriptive information you want to display
for all of the breakpoint items.

To change how breakpoint items display:

 o Select one or more of the items under Select Items group box to select the
   information you want displayed. Each item you select causes a new column to
   be added to the Breakpoint List window.


ΓòÉΓòÉΓòÉ 12.5.2. Sort Choice ΓòÉΓòÉΓòÉ

Select the Sort choice to sort the breakpoints by characteristics of the
breakpoint. When you select Sort, the Sort Breakpoints window displays.


ΓòÉΓòÉΓòÉ <hidden> Sort Breakpoints Window ΓòÉΓòÉΓòÉ

Use the Sort Breakpoints window to sort the breakpoints that have been set in
your program.

Breakpoints can be sorted according to the following categories:

 o Type
 o Executable
 o Source
 o File
 o Function
 o Line
 o Address
 o State
 o Status
 o Thread
 o Expression
 o From
 o To
 o Every.

 Select  the category that represents how you want the breakpoints sorted and
 then select the OK push button.


ΓòÉΓòÉΓòÉ 12.5.3. Fonts Choice ΓòÉΓòÉΓòÉ

Select the Fonts choice to set the font you want to use for the text that
displays in the active window.

When you select Fonts, a Fonts window displays.


ΓòÉΓòÉΓòÉ 12.5.4. Restore Defaults Choice ΓòÉΓòÉΓòÉ

Reset all of the Breakpoint List window settings to their original settings.
This includes the font, the style settings, and the diplay of tool buttons.


ΓòÉΓòÉΓòÉ 12.5.5. Tool Buttons Choice ΓòÉΓòÉΓòÉ

Select the Tool buttons choice if you want the tool buttons to be shown in the
window.

The tool buttons provide quick and easy access to frequently used features of
the debugger. If this choice is enabled, a check mark symbol displays beside
the Tool buttons choice and buttons display.


ΓòÉΓòÉΓòÉ 12.5.6. Hover Help Choice ΓòÉΓòÉΓòÉ

Select the Hover help choice if you want the hover help to be shown in the
window.

The hover help provides the name of the tool button.


ΓòÉΓòÉΓòÉ 12.5.7. Infoarea Choice ΓòÉΓòÉΓòÉ

Select the Infoarea choice if you want the information area to be shown in the
window.

The information area, which is located at the bottom of the window, provides a
brief description of each menu item.


ΓòÉΓòÉΓòÉ 12.6. Windows Menu ΓòÉΓòÉΓòÉ

Select the Windows menu to display a list of all the open debugger windows.

Menu Summary

 Local variables
           Display the local variables for the current line of the program.

 Registers
           Monitor registers and flags for a particular thread.

 Call Stack
           Monitor the call stack for a particular thread.

 Private monitor
           Display the Private Monitor window. Collect variables or expressions
           that you want to monitor.

 Program monitor
           Display the Program Monitor window.

 Storage
           Monitor the storage that a program uses.

 Breakpoints
           List the set breakpoints.

 Debug session control
           Display the Debug Session Control window.


ΓòÉΓòÉΓòÉ 12.7. Help Menu ΓòÉΓòÉΓòÉ

Select choices from the Help menu to complement the online help information
that you can get for the debugger when you press F1 or select the Help push
button.

Menu Summary

 Help index
           An alphabetical index of all available debugger help topics.

 General help
           Help information for the active window.

 Using help
           How to use the IBM C/C++ Debugger help facility.

 How do I
           Display the debugger task help.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 12.7.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Index choice display an alphabetical list of index topics for the
debugger. Use the Find choice provided with the online help facility to locate
topics in the index.


ΓòÉΓòÉΓòÉ 12.7.2. General Help Choice ΓòÉΓòÉΓòÉ

Select the General help choice to display online help for the active debugger
window. The online help panel displayed is the same panel that displays when
you place your cursor inside the window and press F1.


ΓòÉΓòÉΓòÉ 12.7.3. Using Help Choice ΓòÉΓòÉΓòÉ

Select the Using help choice to display online help information about the help
facility.


ΓòÉΓòÉΓòÉ 12.7.4. How Do I Choice ΓòÉΓòÉΓòÉ

Select the How do I choice to display the online task help. This lists tasks
that you may want to do and instructions on how to complete these tasks.


ΓòÉΓòÉΓòÉ 12.7.5. Product Information Choice ΓòÉΓòÉΓòÉ

Select the Product information choice to display the product information.


ΓòÉΓòÉΓòÉ <hidden> Line Breakpoint Window ΓòÉΓòÉΓòÉ

Use the Line Breakpoint window to set a breakpoint on a specific line.

For a description of the entry fields in the window, double-click on one of the
following topics:

 o Executable

 o Source

 o Include file (optional)

 o Line

 o Thread

 o From

 o To

 o Every

 o Expression

 Defer breakpoint Check Box

 Enable this check box if you want to set a breakpoint in a DLL that is not
 currently loaded.

 Note:   If your application consists of an EXE or preloaded DLLs, do not use
 this choice. If your application consists of DLLs that are dynamically loaded,
 you must use this choice to set breakpoints in the dynamically loaded DLLs
 that have not been loaded yet.

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

 The state of the breakpoints will change from active state to deferred state
 depending on whether the DLL has been loaded or not.  For example, if the DLL
 has been loaded and a deferred breakpoint has been set, the breakpoint becomes
 active. If you stop the program and the DLL has been freed, the breakpoint
 changes from active state to deferred state.

 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 DLL is
 loaded.

 Refer to the Breakpoints window for the current state of the breakpoints that
 have been set.

 Select the appropriate  push button to continue.


ΓòÉΓòÉΓòÉ 12.7.6. Setting Simple Line Breakpoints ΓòÉΓòÉΓòÉ

To set a simple line breakpoint in all threads, double-click in the prefix area
of an executable statement in the source windows:

 Source
           Sets the breakpoint at a specific statement.

 Disassembly
           Sets the breakpoint at a specific assembler instruction.

 Mixed
           Sets the breakpoint at a specific assembler instruction. (The lines
           of source code displayed in the Mixed window are treated as comment
           lines only.)

 The prefix area turns red indicating that the breakpoint has been set.

 To set a thread-specific breakpoint for the thread shown in a source view,
 hold down the CTRL key as you double-click in the prefix area.


ΓòÉΓòÉΓòÉ 12.7.7. Deleting Simple Line Breakpoints ΓòÉΓòÉΓòÉ

To remove a simple line breakpoint in all threads, double-click in a red prefix
area of the Source, Disassembly, or Mixed window. The color changes indicating
that the breakpoint cleared.

If the prefix area turns black instead, double-click again to make sure the
breakpoint clears.


ΓòÉΓòÉΓòÉ <hidden> Executable Entry Field ΓòÉΓòÉΓòÉ

To select a component from the Executable list:

  1. Open the Executable list by selecting the arrow with your mouse.

  2. Highlight the executable where you want to set the breakpoint.

     OR

     Type the executable name in the entry field.


ΓòÉΓòÉΓòÉ <hidden> Source Entry Field ΓòÉΓòÉΓòÉ

To select a component from the Source list:

  1. Open the Source list by selecting the arrow with your mouse.

  2. Highlight the source where you want to set the breakpoint.

     OR

     Type the source name in the entry field.


ΓòÉΓòÉΓòÉ <hidden> Line Number Entry Field ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 12.7.8. Modify Choice ΓòÉΓòÉΓòÉ

Use the Modify choice to change the breakpoints that have been set in your
program.

To modify a breakpoint:

  1. Highlight the breakpoint you want to change.

  2. Select the Modify choice.

  3. The entry fields contain the information pertaining to that breakpoint.
     Make your changes to the entry fields.

  4. Accepts the changes and close the window. If you want to make other
     changes, select Set to accept the changes and keep the window open.


ΓòÉΓòÉΓòÉ 13. Exception Window ΓòÉΓòÉΓòÉ

The Exception window displays whenever an exception occurs.  The exception may
have occurred in the application or the system code. In either case, the
debugger displays and highlights the line where the exception occurred in the
Source window.

You can do three things from this window:

 Examine/Retry
           Allows you to investigate the cause of the exception and if desired,
           retry execution of the line that caused the original fault. The
           debugger begins with the line causing the error and attempts to
           continue.

           This is the default.

 Step Exception
           Causes the debugger to step into the first registered exception
           handler. Execution stops at the first executable line of code in
           that exception handler.  You control what happens next.

 Run Exception
           Causes the debugger to run the normal exception handlers.

 Note:   The Step exception and Run exception choices are not available when a
 Win32s application causes the exception.


ΓòÉΓòÉΓòÉ 14. Overloaded Window ΓòÉΓòÉΓòÉ

Use the Overloaded window to select the appropriate function. This window
displays when you have an overloaded function.

To use the Overloaded window:

  1. Select the name of the function you want from the list.

  2. Select the appropriate push button to continue.

 Signature
           Displays the function name and any parameters that the function has.


ΓòÉΓòÉΓòÉ 15. Source Filename Window ΓòÉΓòÉΓòÉ

The Source Filename window displays when you try to open a component for which
you have debugging data, but the debugger cannot locate the source code.

To use the Source Filename window, do one of the following:

 o If the source code is located in another directory on the system, type in
   the path name and select OK.

 o If you do not have the source code for this component, select Cancel. The
   Disassembly window opens for this component.


ΓòÉΓòÉΓòÉ 16. Program Termination Window ΓòÉΓòÉΓòÉ

Use the Program Termination window to end the debugging session, restart the
debugging session, or display the Startup window.

Select the appropriate push button to continue.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

 Restart
           Restarts the debugging session.

 Startup
           Displays the startup window.

 Close Debugger
           Closes the debugging session.

 Help
           Displays help information for this window.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

 OK
           Accepts the information you have typed and closes this window.

 Browse...
           Displays the Open window, which lists the file names that you can
           select.

 Cancel
           Closes the window without saving any changes.

 Help
           Displays help information for this window.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

 OK
           Accepts the information you have typed and closes this window.

 Apply
           Substitutes the file and leaves the window open.

 Cancel
           Closes this window without saving any changes.

 Browse...
           Displays a list of the files that you can select.

 Help
           Displays help information for this window.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

 OK
           Accepts the information you have typed and closes this window.

 Reset
           Changes the information to the previously saved setting.

 Default
           Defaults to the default setting.

 Cancel
           Closes the window without saving any changes.

 Help
           Displays help information for this window.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

 OK
           Accepts the information you have typed and closes this window.

 Apply
           Applies the change to the window. The change applies only until you
           close the window. Select OK to close the window and keep the
           changes.

 Reset
           Changes the information to the previously saved setting.

 Default
           Replaces the current settings with the default settings.

 Cancel
           Closes the window without saving any changes.

 Help
           Displays help information for this window.


ΓòÉΓòÉΓòÉ 16.1. Push Buttons ΓòÉΓòÉΓòÉ

 OK
           Accepts the information you have typed and closes this window.

 Apply
           Applies the change to the window. The change applies only until you
           close the window. Select OK to select the new font.

 Reset
           Changes the font back to your earlier selection.

 Default
           Replaces the current selection with the default. The default font is
           System Monospaced 8x8.

 Cancel
           Closes the window without saving any changes.

 Help
           Displays help information for this window.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

 OK
           Accepts the information you have typed and closes this window.

 Set
           Select Set to set a breakpoint.

 Default
           Defaults to the default settings.

 Cancel
           Closes the window without saving any changes.

 Help
           Displays help information for this window.


ΓòÉΓòÉΓòÉ 16.2. Push Buttons ΓòÉΓòÉΓòÉ

 OK
           Accepts the information you have typed and closes this window.

 Set
           Select Set to set the breakpoints.

 Cancel
           Closes the window without saving any changes.

 Default
           Defaults to the default settings.

 Browse...
           Displays a list of the files that you can select.

 Help
           Displays help information for this window.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

 OK
           Select OK to set the breakpoint and close this window.

 Cancel
           Closes the window without saving any changes.

 Help
           Displays help information for this window.

 Default
           Defaults the current window information to the debugger defaults.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

 OK
           Accepts the information you have typed and close this window.

 Delete
           Remove the highlighted breakpoint.

 Delete all
           Remove all of the breakpoints displayed in the window.

 Sort
           Sort the breakpoints by different categories.

 Disable/Enable
           Disable or enable the highlighted breakpoint.

 Modify
           Modify the existing breakpoints.

 Help
           Displays the online help for this window.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

 Add
           Select Add to add the new message you have defined.

 Update
           Select Update to update a message that previously existed.

 Delete
           Select Delete to delete a message that previously existed.

 Cancel
           Select Cancel to ignore any changes that were made and close this
           window.

 Help
           Displays help information for this window.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

 OK
           Accepts the information you have typed and to close this window.

 Reset
           Select Reset to clear any changes you have made in this session.

 Default
           Select Default to replace the current default display style with
           default display style.

 Cancel
           Closes the window without saving any changes.

 Help
           Displays Help information for this window.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

 OK
           Accepts the information you have selected in this window.

 Reset
           Select Reset to clear any changes you have made in this window.

 Default
           Select Default to replace the default selection in this window.

 Cancel
           Closes the window without saving any changes.

 Help
           Displays help information for this window.


ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ

 OK
           Accepts the information you have typed and closes this window.

 Apply
           Apply the changes to the window.

 Reset
           Select Reset to change the colors back to what they were when you
           opened this window.

 Default
           Select Default to change the color back to the default color.

 Cancel
           Closes the window without saving any changes.

 Help
           Displays Help information for this window.


ΓòÉΓòÉΓòÉ 17. Glossary ΓòÉΓòÉΓòÉ

Double-click on any term for a definition:

 o Automatic variable

 o Breakpoint

 o Component

 o Context

 o Debugging information

 o Disable

 o Enable

 o Event breakpoint

 o Executable files

 o Executable statement

 o Functions

 o Local variables

 o Location breakpoint

 o Object files

 o Overloaded

 o Prefix area

 o Process

 o Program generated breakpoint

 o Program profiles

 o Recursion level

 o Search path

 o Session

 o Shortcut keys

 o Stopping thread

 o Storage

 o Thread

 o Time stamp
 ---------------------------------------------------------------


ΓòÉΓòÉΓòÉ 17.1. Automatic variable ΓòÉΓòÉΓòÉ

A variable that is allocated during the invocation of the function containing
the variable is called an automatic variable. Every time a function is invoked,
a new copy of the variable is placed in storage.


ΓòÉΓòÉΓòÉ 17.2. Breakpoint ΓòÉΓòÉΓòÉ

A breakpoint is a defined location or condition in a program that, when it is
met, stops the execution of the program.


ΓòÉΓòÉΓòÉ 17.3. Component ΓòÉΓòÉΓòÉ

Components are the executable files, source files or object files, and the
functions that comprise a program.


ΓòÉΓòÉΓòÉ 17.4. Context ΓòÉΓòÉΓòÉ

Context is the information relating to an expression or variable when it is
valid. The information consists of the source file, line number, and thread.


ΓòÉΓòÉΓòÉ 17.5. Debugging data ΓòÉΓòÉΓòÉ

Debugging data is the symbolic and line number information contained in the
executable file.


ΓòÉΓòÉΓòÉ 17.6. Disable ΓòÉΓòÉΓòÉ

Disable prevents a thread from executing.


ΓòÉΓòÉΓòÉ 17.7. Enable ΓòÉΓòÉΓòÉ

Enable allows a thread to execute.


ΓòÉΓòÉΓòÉ 17.8. Event breakpoint ΓòÉΓòÉΓòÉ

An event breakpoint is one of the following:

 o A load occurrence breakpoint

 o A change address breakpoint.


ΓòÉΓòÉΓòÉ 17.9. Executable files ΓòÉΓòÉΓòÉ

Executable files are the EXE or DLL files.


ΓòÉΓòÉΓòÉ 17.10. Executable statement ΓòÉΓòÉΓòÉ

An executable statement is a statement where you can stop the execution of your
program by setting breakpoints. These statements are initially displayed in
blue.


ΓòÉΓòÉΓòÉ 17.11. Functions ΓòÉΓòÉΓòÉ

A Function is a block of statements executed by a function call. Synonymous
with procedures.


ΓòÉΓòÉΓòÉ 17.12. Load occurrence breakpoints ΓòÉΓòÉΓòÉ

A load occurrence breakpoint allows you to stop the execution of your program
after the DLL that you specify is loaded.


ΓòÉΓòÉΓòÉ 17.13. Local variables ΓòÉΓòÉΓòÉ

A local variable is a variable that is specific to a function. The debugger
displays the following types of local variables:

 o Static

 o Automatic

 o Parameters.


ΓòÉΓòÉΓòÉ 17.14. Location breakpoint ΓòÉΓòÉΓòÉ

A location breakpoint is one of the following:

 o A line breakpoint

 o An address breakpoint

 o A function breakpoint.


ΓòÉΓòÉΓòÉ 17.15. Object files ΓòÉΓòÉΓòÉ

Object files are the object (OBJ) files.


ΓòÉΓòÉΓòÉ 17.16. Overloaded function ΓòÉΓòÉΓòÉ

An overloaded function in C++ is when you have two or more functions with the
same name with different parameters. An overloaded function also occurs when
you have the same function in different modules (EXE or DLLs).


ΓòÉΓòÉΓòÉ 17.17. Prefix area ΓòÉΓòÉΓòÉ

Prefix area is the area within the source views where line numbers or address
numbers are located.


ΓòÉΓòÉΓòÉ 17.18. Process ΓòÉΓòÉΓòÉ

Process is the collection of one or more threads and their associated system
resources, such as storage, open files, and devices.


ΓòÉΓòÉΓòÉ 17.19. Program generated breakpoint ΓòÉΓòÉΓòÉ

 A program generated breakpoint is the trap instruction, which is this case is
a CC instruction, that causes the program to stop as if a breakpoint has been
encountered.  If this occurs, use the jump to location feature to go to the
next instruction or source line.


ΓòÉΓòÉΓòÉ 17.20. Program profiles ΓòÉΓòÉΓòÉ

Program profiles are used to restore the breakpoints, monitor expressions, and
source windows when debugging a program more than once. They are stored
separately for each program debugged and are stored when the debugger is closed
or when starting to debug a different program. The file extension for the files
that contain this information is @5R.

Note:   All breakpoints are saved.  All other information such as monitors and
source windows is saved only for the primary thread and only for executables
and preloaded DLLs.


ΓòÉΓòÉΓòÉ 17.21. Recursion level ΓòÉΓòÉΓòÉ

The number that represents the level of recursion of a function, where the
number 0 represents the first invocation. A recursive function is a function
that calls itself.


ΓòÉΓòÉΓòÉ 17.22. Search Path ΓòÉΓòÉΓòÉ

The search path tells the debugger where to find the source file used in the
Source and Mixed windows. The debugger searches for the source files in the
following order:

  1. The path defined by the CAT_LOCAL_PATH environment variable.

  2. The path where the executable file is located.

  3. The path defined by the CAT_PATH environment variable, if specified.

  4. The current path.

 To override the normal search order, use the CAT_OVERRIDE environment
 variable. To set the CAT_OVERRIDE environment variable, type the following at
 the command prompt:

       Set CAT_OVERRIDE=path

 where, path is the location of your source files. If the source file is not
 found in the defined override path, the debugger uses the normal search order.

 To set the CAT_PATH environment variable, type the following at the command
 prompt:

       Set CAT_PATH=path

 where, path is the location of your source files.

 To set the number of spaces between tab stops in your source code, type the
 following at the command prompt:

       Set CATTABGRID=n

 where, n is the increment number of spaces between tab stops. For example, if
 n is 5, tab stops would be 5, 10, 15, and so on.


ΓòÉΓòÉΓòÉ 17.23. Session ΓòÉΓòÉΓòÉ

Session is the collection of one or more processes associated with a virtual
console such as keyboard, video display, or mouse.


ΓòÉΓòÉΓòÉ 17.24. Shortcut keys ΓòÉΓòÉΓòÉ

Shortcut keys are the keyboard keys that you use to invoke the menu choices.


ΓòÉΓòÉΓòÉ 17.25. Stopping thread ΓòÉΓòÉΓòÉ

A stopping thread is the thread that caused the program being debugged to stop.


ΓòÉΓòÉΓòÉ 17.26. Storage ΓòÉΓòÉΓòÉ

The storage is the computer memory space in use during the execution of a
program.


ΓòÉΓòÉΓòÉ 17.27. Thread ΓòÉΓòÉΓòÉ

A thread is the basic unit of execution. A thread gives a program its context,
including registers, stack, and processor mode. Multiple threads can be running
at the same time, and any particular thread can start another thread.


ΓòÉΓòÉΓòÉ 17.27.1. Time Stamp Check ΓòÉΓòÉΓòÉ

Information that is program profile information includes the time stamps on the
executable files that make up the application. When you select to start a
program with program profile, the debugger compares the time stamp in the
executable program file (and the pre-loaded dynamic link libraries) with the
time stamp on the program profile. If these time stamps do not match, a message
box displays.

Select Yes from the message box to start the program with program profile,
select No to load the program without the program profile, or select Cancel to
cancel the startup process and return to the Debug Session Control window.

If the source file changed but was not compiled, breakpoints might be invalid
or display on the wrong lines.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of Windows