OS/2 Shareware BBS: 10 Tools/10-Tools.zip/icat.zip/icatos2.zip/icatos2/help/gam5help.hlp

OS/2 Help File | 2000-11-26 | 196KB | 7,984 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 in the United States and/or other
countries:

     IBM

     Operating System/2

     OS/2


ΓòÉΓòÉΓòÉ 2. Initialization Window ΓòÉΓòÉΓòÉ

Use the Initialization window to attach to the OS2KRNL.

To attach to the OS2KRNL, select the Attach push button.

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 process so that you can begin debugging.

 Settings
           Displays the Debugger Properties Window, which allows you to select
           how threads and source files initially display and set environment
           variables.

 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 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 can be sized. One pane contains the
threads and corresponding process IDs, process names, kernel thread IDs, and
process number (when applicable). The other pane shows the components for the
program that you are debugging.

The Threads:Slots pane contains the threads. It shows the state of the threads
and the priority 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.

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, 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 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 Registers window.

 Call stack
   Display the Call Stack window.

 Local variables
   Display the Local variables window.

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

 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 the current source window. The popup menu displays
 when you click mouse button 2 with the mouse pointer on a highlighted object
 or function name, 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 choices in the popup menu are:

 View
                Bring up the object or function a source window.

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

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

 Set instruction fetch breakpoint
                Sets a watchpoint for the selected address.

 You can display any component by double-clicking on the component name that
 displays in the components pane or by highlighting the component name and
 selecting a view from the View menu.

 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 a debugging session, open a new source file, locate a
           specific function, or open a source window that contains the next
           line to be executed.

 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

     Source Windows
     Registers Window
     Call Stack Window
     Local Variables Window
     Messages Window
     Passthru Window
     Program Monitor Window
     Private Monitor Window
     Popup Expression Window
     Storage Window
     Breakpoints List Window
     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 the
current source window.


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

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

To set a function breakpoint:

   1. Highlight the function.
   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.


ΓòÉΓòÉΓòÉ <hidden> Set Instruction Fetch Breakpoint ΓòÉΓòÉΓòÉ

Select the Set instruction fetch breakpoint choice to set a watchpoint for the
selected function's address. When the code at this address is to be executed by
the processor, a watchpoint notification will be generated.


ΓòÉΓòÉΓòÉ 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, 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.

 Reboot target
           Reboots the victim machine while the debugger stays attached.

 Save thread list in file
           Save the contents of the Threads pane into a file.

 Save component list in file
           Save the contents of the Components pane into a file.

 Initialization...
           Display the Initialization window.

 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.2.1. List Window ΓòÉΓòÉΓòÉ

This window displays a list of items derived from your search criteria. Select
an item and then click OK to display it.

Push Buttons

 OK
           Displays the item you selected.

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

 Help.
           Displays help information for this window.


ΓòÉΓòÉΓòÉ 3.1.2.2. List Window ΓòÉΓòÉΓòÉ

This window displays a list of items derived from your search criteria. Select
an item and then click OK to display it.

Push Buttons

 OK
           Displays the item you selected.

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

 Help.
           Displays help information for this window.


ΓòÉΓòÉΓòÉ 3.1.2.3. List Window ΓòÉΓòÉΓòÉ

This window displays a list of items derived from your search criteria. Select
an item and then click OK to display it.

Push Buttons

 OK
           Displays the item you selected.

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

 Help.
           Displays help information for this window.


ΓòÉΓòÉΓòÉ 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. Reboot target ΓòÉΓòÉΓòÉ

Reboots the victim machine while the debugger stays attached.


ΓòÉΓòÉΓòÉ 3.1.5. Save Thread List in File Choice ΓòÉΓòÉΓòÉ

Saves the contents of the Threads pane into a file.  The default file name is
threads.out.  To change the default file name, select Options -> Window
settings -> Display style... from the Debug Session Control window.


ΓòÉΓòÉΓòÉ 3.1.6. Save Component List in File Choice ΓòÉΓòÉΓòÉ

Saves the contents of the Components pane into a file.  The default file name
is comps.out.  To change the default file name, select Options -> Window
settings -> Display style... from the Debug Session Control window.


ΓòÉΓòÉΓòÉ 3.1.7. Initialization Choice ΓòÉΓòÉΓòÉ

Select the Initialization choice to start a debugging session by attaching to
the OS2KRNL.

When you select Initialization, the Initialization window displays.


ΓòÉΓòÉΓòÉ 3.1.8. 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 the
current source window. If a source window is not currently active, the Source
window is shown. If the Source window is not available, the Disassembly window
is shown.


ΓòÉΓòÉΓòÉ 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 watchpoint
           Set a watchpoint 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:

     Setting simple line breakpoints

     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:

     Setting simple line breakpoints

     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:

     Executable (optional)

     Source (optional)

     Function

     Expression

     Thread

     From

     To

     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 List 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
displays.


ΓòÉΓòÉΓòÉ <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:

     Thread

     Every

     From

     To

     Expression

 Select the appropriate push button to continue.


ΓòÉΓòÉΓòÉ 3.3.4. Set Watchpoint Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ <hidden> Watchpoint Window ΓòÉΓòÉΓòÉ

Use the Watchpoint window to set a watchpoint.  To do so, type a hexadecimal
address or an expression and select the range of bytes. The range of bytes can
only be 8.

Note:  The debugger supports up to 4 enabled watchpoints. However, you can set
as many disabled watchpoints as you want.

To set a watchpoint, complete the fields as follows:

Address (or Expression) or Port # Entry Field

Type the following in the Address (or Expression) or Port # entry field to set
a watchpoint for the expression 0xA1FCC.

     0xA1FCC

Note:  If you type ABC in the Address (or Expression) or Port # 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) or Port
# entry field to set the watchpoint on the address of a variable a.

Bytes to Monitor Radio Buttons

The debugger will monitor 1, 2, or 4 bytes for the type of watchpoint operation
that you select.  This choice is made for you on the Instruction fetch type.

Watchpoint Radio Buttons

The debugger supports four types of watchpoints. They are as follows:

 I/O Port            Causes a break when the port address is read from or
                     written to.

 Write               Causes a break when the address is written to.

 Read or write       Causes a break when the address is read from or written
                     to.

 Instruction fetch   Causes a break when the instruction at that address is
                     fetched.

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

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

     Thread

     From

     To

     Every

 Select the appropriate push button to continue.

 Related Information

     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 module in the Module Name entry field. Execution stops
when the module is loaded.

Module Name Entry Field

To set a load occurrence breakpoint when MY.DLL is loaded, type the following
in the Module 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:

     Thread

     From

     To

     Every

 Select the appropriate push button to continue.


ΓòÉΓòÉΓòÉ <hidden> File List ΓòÉΓòÉΓòÉ

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

   1. Open the File 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 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.

 Messages
           Displays the printfs and direct COM port messages from the device
           drivers.

 Passthru
           Allows you to send commands to KDB and displays the formatted KDB
           response.


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

Select choices from the Run menu to execute your program or halt execution.

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

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.

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

 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. Hide Debugger on Run Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 3.5.4. 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.1.1. Fonts Choice ΓòÉΓòÉΓòÉ

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

When you select Fonts, a Fonts window displays.


ΓòÉΓòÉΓòÉ 3.6.1.2. 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, the components under the Modules heading will be
sorted in alphabetical order. 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 displayed.

Sort components Check Box

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

Show status line Check Box

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

Component output file Entry Field

Specify the name of the file where the component names are saved.

Threads output file Entry Field

Specify the name of the file where the thread names are saved.


ΓòÉΓòÉΓòÉ 3.6.1.3. Restore Defaults Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 3.6.1.4. Tool Buttons Choice ΓòÉΓòÉΓòÉ

You can select to display the buttons in the Debug Session Control window.

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


ΓòÉΓòÉΓòÉ 3.6.1.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.


ΓòÉΓòÉΓòÉ 3.6.1.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.


ΓòÉΓòÉΓòÉ 3.6.2. 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.

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

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

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

 Display tool buttons
           Display tool buttons in all the debugger windows.

 Display hover help
           Display hover help in all the windows.

 Display infoarea
           Display the information area in all debugger windows.

 Place tool buttons on title bar
           Display the tool buttons on the title bar of each window.


ΓòÉΓòÉΓòÉ 3.6.2.1. 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 Source Windows
Properties window displays.


ΓòÉΓòÉΓòÉ 3.6.2.2. 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.2.3. 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.2.3.1. 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.2.3.2. System Choice ΓòÉΓòÉΓòÉ

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.2.4. 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.2.4.1. Select Information Choice ΓòÉΓòÉΓòÉ

Select the Select information choice to indicate what information you want
saved in the program profiles.  You may save breakpoints, breakpoints 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.2.4.2. 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.2.4.3. 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.2.5. Save Debugger Window Positions Choice ΓòÉΓòÉΓòÉ

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


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

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

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


ΓòÉΓòÉΓòÉ 3.6.2.7. 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.2.8. Display Tool Buttons Choice ΓòÉΓòÉΓòÉ

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

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


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

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

The hover help shows the names of the tool buttons.


ΓòÉΓòÉΓòÉ 3.6.2.10. Display Infoarea Choice ΓòÉΓòÉΓòÉ

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

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


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

Select the Place buttons on title bar choice if you want the tool buttons to be
shown in the title bar of the debugger windows.


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

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


ΓòÉΓòÉΓòÉ 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. Messages Choice ΓòÉΓòÉΓòÉ

Select the Messages choice to display kernel printfs and direct COM port
messages from device drivers. When you select Messages, the Messages window
displays.


ΓòÉΓòÉΓòÉ 3.7.3. Passthru Choice ΓòÉΓòÉΓòÉ

Select the Passthru choice to send commands to KDB and display the formatted
KDB response. When you select Passthru, the Passthru window displays.


ΓòÉΓòÉΓòÉ 3.7.4. Registers Choice ΓòÉΓòÉΓòÉ

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

When you select Registers, the Registers window displays.


ΓòÉΓòÉΓòÉ 3.7.5. 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.6. 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.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 debugger help facility.

 Product information
           Display product information.


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

Select the Help index choice to 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 OS/2
help facility.


ΓòÉΓòÉΓòÉ 3.8.4. 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

 Halt
           SysRq


ΓòÉΓòÉΓòÉ 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.

Note:  You can change the view priority of the source windows using the
Debugger Properties window.

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 shown in the window can also be accessed from several of the menu
items in 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:

     Select the View menu from a source window and then select the view you
      want displayed.
     Select the View button located in the tool bar.  This allows you to cycle
      through the source windows. The order depends on the view priority.

 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 List.

 Single stepping your program Press mouse button two to single step your
           program. This 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:

     Program monitor
     Private monitor
     Popup expression
     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.

 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 Set 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 tool bar of 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:

               the program ends

               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.

           Program Monitor displays the Program Monitor window.

           Storage displays a new Storage window.

           Breakpoints displays the Breakpoints List window.

           View cycles through the source windows, depending on the view
           priority.

 Related Information

     Debug Session Control Window
     Register Window
     Call Stack Window
     Local Variables Window
     Program Monitor Window
     Private Monitor Window
     Popup Expression Window
     Storage Window
     Breakpoints List Window
     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, 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:

     the program ends

     execution stops at an enabled breakpoint.

 When the debugger is running the run button changes to


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

Select the Halt button to interrupt the program that you are debugging. You can
also access this choice by pressing SysRq (Alt+PrintScreen).


ΓòÉΓòÉΓòÉ <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 Program Monitor window.


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

Displays a new Storage window.


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

Displays the Breakpoints List window.


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

Cycles through the source windows, depending on the view priority.


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

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


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

Deletes all the breakpoints in the Breakpoints List window.


ΓòÉΓòÉΓòÉ <hidden> Messages ΓòÉΓòÉΓòÉ

Displays the Messages window.


ΓòÉΓòÉΓòÉ <hidden> Passthru Button ΓòÉΓòÉΓòÉ

Displays the Passthru window.

The Passthru window sends commands to KDB and displays the formatted KDB
response.


ΓòÉΓòÉΓòÉ <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.


ΓòÉΓòÉΓòÉ 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.

 Save window in file
           Save the source window's contents into a file.

 Reboot target
           Reboots the target computer while the debugger stays attached.

 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 File List 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. Save Window in File Choice ΓòÉΓòÉΓòÉ

Select the Save Window in File choice to have the debugger save the source
window's contents in a file. You can choose the name of the file from the Save
to File window.


ΓòÉΓòÉΓòÉ 4.2.4.1. Save to File Window ΓòÉΓòÉΓòÉ

Use the Save to File window to name the file into which you want to save the
source window's contents. To use the Save to File window:

   1. Type the name of the file in the File Name entry field.

   2. Select the appropriate push button to continue.


ΓòÉΓòÉΓòÉ 4.2.5. Reboot target ΓòÉΓòÉΓòÉ

Reboots the victim machine while the debugger stays attached.


ΓòÉΓòÉΓòÉ 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:

     Alphabetic and numeric characters
     A maximum of 256 characters
     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 Set 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

     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.


ΓòÉΓòÉΓòÉ 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 ΓòÉΓòÉΓòÉ

Select the Mixed choice to display each line of source code followed by the
assembler instructions that the particular source line generates.

The Mixed window displays your program, as follows:

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

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

     Source comment lines also display.

     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.

     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 watchpoint
           Set a watchpoint 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:

     Setting simple line breakpoints

     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:

     Setting simple line breakpoints

     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 Watchpoint Choice ΓòÉΓòÉΓòÉ

Select the Set watchpoint choice to stop the execution of your program after
the contents of memory at a given address changes. When you select Set
watchpoint, the Watchpoint 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.

 Passthru
           Allows you to send commands to KDB and displays the formatted KDB
           response.


ΓòÉΓòÉΓòÉ 4.5.1. Passthru Choice ΓòÉΓòÉΓòÉ

Select the Passthru choice to send commands to KDB and display the formatted
KDB response.

When you select Passthru, Passthru window displays.


ΓòÉΓòÉΓòÉ 4.5.2. 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.2.1. Monitor Expression ΓòÉΓòÉΓòÉ

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

This window lists the following contextual information:

     The component you are in.

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

     The view of the program that is active.

     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:

     A supported operand type

     A supported operator

     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 button for the location 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:

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

     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.

     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 Window ΓòÉΓòÉΓòÉ

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:

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

          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 the 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 a
clock icon 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.

 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.

 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 use
the mouse button 2 to step if Step always is set as the default in the Debugger
Properties window.

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. You can
also access this choice by pressing SysRq (Alt+PrintScreen).


ΓòÉΓòÉΓòÉ 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.

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 is highlighted.

   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 is highlighted.

   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. 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 color and 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:

 Colors
           Change the color of various window elements.

 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 tool bar.

 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.1.1. Colors Choice ΓòÉΓòÉΓòÉ

Use the Colors choice to change the color of the lines in the source windows.

When you select Colors, the Colors window displays.


ΓòÉΓòÉΓòÉ 4.7.1.1.1. Source Window Colors ΓòÉΓòÉΓòÉ

Use the Source Window Colors window to change the color of the of the
background and foreground (text) in the source windows.

To change the color of the background in the source window:

     Open the OS/2 Color Palette window.

     Using the mouse pointer, select a color from the color palette.

     Hold down mouse button two and drag the selected color to the line that
      you want to change the background color of in the Source Window Colors
      window.

     Release mouse button two and select the Apply push button.

     Select the appropriate

 To change the color of the foreground in the source window:

     Open the OS/2 Color Palette window.

     Using the mouse pointer, select a color from the color palette.

     Hold down the Ctrl key and mouse button two and drag the selected color
      to the line that you want to change the foreground color of in the Source
      Window Colors window.

     Release the Ctrl key and mouse button two.

     Select the Apply push button.

 To continue, select the appropriate push button


ΓòÉΓòÉΓòÉ 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 color, 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 ΓòÉΓòÉΓòÉ

You can select to display the buttons in the tool bar of the window.

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
window.

The hover help provides the name of the tool button.


ΓòÉΓòÉΓòÉ 4.7.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.


ΓòÉΓòÉΓòÉ 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

 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 all the debugger windows.

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

 Display hover help
           Display hover help in all the windows.

 Display infoarea
           Display the information area in all debugger windows.

 Place tool buttons on title bar of each window.
           Display the tool buttons on the tile bar of each window.


ΓòÉΓòÉΓòÉ 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 ΓòÉΓòÉΓòÉ

Displays the Debugger Properties window, which allows you to select how the
threads and source files initially display. This window contains the following
three tabs:

     Source
     Remote
     Modules

 The Remote page displays by default if you open the window using the
 Initialization window.  If not, the Source Page displays.


ΓòÉΓòÉΓòÉ 4.7.10.1. Remote Page ΓòÉΓòÉΓòÉ

When you select the Remote tab, the Remote Page displays.

Use this window to do the following tasks:

     Set the communication baud rate for the debugger.
     Set the communication port.
     Set the communication baud rate for KDB or initialization and after
      exiting.
     Set the path where the debugger finds source.
     Set the path where the debugger finds the debug binary modules.
     View the communication mode. (ASYNC_SIGBRK or UDP).
     Set modem communication information, if used.
     Set a string to initialize KDB.
     Set the option for recursive subdirectory searching of the source and
      binary paths.
 This window's values are dithered and cannot be changed after communication
 has been established with the target machine.

 Baud Rate Group Heading

 This group of radio buttons allows you to select communication baud rates from
 9600 to 115200.  Ensure that your machine can handle rates greater than 19200
 if you choose them.  You must have buffered UARTs on both machines in this
 case. If you choose a rate of 115200, your host machine must have a COM.SYS
 different than the default supplied with OS/2.

 KDB Baud Rate Group Heading

 This group of radio buttons allows you to select the initial (setup)
 communication rate that the debugger uses to communicate with KDB. If any rate
 other than default is selected, that same rate will be used to reset the
 target machine's communication port when the debugger is exited.

 Communications Port Spin Button

 This spin button allows you to select the communication port number for the
 debugger on the host machine.

 Environment Variables Group Heading

 These entry fields correspond respectively to the following environment
 variables:

     CAT_HOST_SOURCE_PATH
     CAT_HOST_BIN_PATH
     CAT_COMMUNICATION_TYPE
     CAT_DIAL
     CAT_MODEM_INIT
     CAT_KDB_INIT

 By adjusting these fields, you can alter your communication and serial paths
 dynamically before communication is established with the target machine.

 Path Recursion Check Box

 This check box, when selected, forces the debugger to search all source and
 binary path subdirectories recursively.


ΓòÉΓòÉΓòÉ 4.7.10.2. Source Page ΓòÉΓòÉΓòÉ

When you select the Source tab, the Source Page displays.

Use this window to determine:

     when a source window first displays during a debugging session.
     how to process a source window from which execution has just left.  The
      window can remain displayed, be turned into an icon, or be discarded.

 Display at stop Group Heading

 You can control how many source windows are displayed using the following
 radio buttons:

 The choices are:

 Only stopping thread     Show only the thread that caused to application to
                          stop.

 All threads              Show where all threads are when the application
                          stops.

 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 Heading

 In the course of debugging, these selections allow you to control the behavior
 of source windows from which execution has just left. The Old Source
 Disposition radio buttons control the behavior of source windows within a
 thread.

 The dispositions that the views can take are:

 Keep        Leaves open the source windows that contain the components and
             threads that you select with Display at stop.

 Minimize    Changes into icons the views that contain the components and
             threads that you select with Display at stop.

 Discard     Disposes of the views that contain the components and threads that
             you select with Display at stop.

 Settings Group Heading

 You can choose to display more than one source window for a particular source
 file.  Enable the Multiple views check box if you want to have multiple source
 windows open at the same time.

 Mouse button 2 behavior Group Heading

 Select the radio button that represents the action that you want mouse button
 2 to perform.


ΓòÉΓòÉΓòÉ 4.7.10.3. Modules Page ΓòÉΓòÉΓòÉ

When you select the Modules tab, the Modules page displays.

Use this window to add a module name to or delete a module name from the
CAT_MODULE_LIST environment variable.

Modules List Box

This contains a list of modules which the debugger obtains information about if
or when they are loaded. If a module is loaded and it is not in the list, the
debugger ignores the module.

New Module Entry Field

Type the name of the module that you want to add or delete. Select the
appropriate push button to perform this task.

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:

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

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

 After you have selected the settings you want from this window, select one of
 the push buttons to continue.

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

     Monitor Location

     Popup Duration.


ΓòÉΓòÉΓòÉ 4.7.12. 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.

 Save to file Entry Field

 Use this field to identify the file where all monitor windows will write their
 contents  when the Save to file choice is selected.

 Number of elements to show Entry Field

 Use this field to enter the number of elements that you want shown.

 Related Information

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


ΓòÉΓòÉΓòÉ 4.7.13. Enabled Check Box ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 4.7.14. 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.15. 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.


ΓòÉΓòÉΓòÉ 4.7.15.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:

     Hexadecimal

     Decimal

     String

     Character

     Floating-point

     Hexadecimal pointer

     Decimal pointer

     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.16. 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.16.1. Select Information Choice ΓòÉΓòÉΓòÉ

Select the Select information choice to indicate what information you want
saved in the program profiles.  You may save breakpoints, breakpoints 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.16.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.16.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.16.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.16.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.16.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.17. 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.18. Global Font Change Choice ΓòÉΓòÉΓòÉ

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

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


ΓòÉΓòÉΓòÉ 4.7.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.


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

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

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


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

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

The hover help shows the names of the tool buttons.


ΓòÉΓòÉΓòÉ 4.7.19.3. Display Infoarea Choice ΓòÉΓòÉΓòÉ

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

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


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

Select the Place buttons on tile bar choice if you want the tool buttons to be
shown in the title bar of the debugger windows.


ΓòÉΓòÉΓòÉ 4.8. Windows Menu ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 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 Cascading Choice ΓòÉΓòÉΓòÉ

Select the Storage conditional choice to display the contents of storage used
by your program. You can choose to open a new storage window, or you can locate
a storage window that is already open by selecting the arrow.


ΓòÉΓòÉΓòÉ <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 debugger help facility.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 4.9.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Help index choice to 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 OS/2
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. Product Information Choice ΓòÉΓòÉΓòÉ

Select the Product information choice to display the product information.


ΓòÉΓòÉΓòÉ 5. Registers Window ΓòÉΓòÉΓòÉ

Use the Registers 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 Registers window, floating-point registers display as floating-point
decimal numbers or as hexadecimal. They are updated based on the current
representation.

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

Register Popup Menu

The Register 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.)

Menu Summary

 Edit
   Edit text and search for strings in the text.

 Menu Bar Summary

 File
           End your debugging session.

 Options
           Change the font used for the text in the Registers 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

     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.1.1. Edit ΓòÉΓòÉΓòÉ

Select choices from the Edit menu to delete, select, and deselect expressions.


ΓòÉΓòÉΓòÉ 5.1.2. 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.2. Options Menu ΓòÉΓòÉΓòÉ

Select the Options menu to change the fonts used for the text in the Registers
window, and set debugger options.

Menu Summary

 Fonts
           Change the fonts for the text in the Registers 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 tool bar.

 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.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.

When you select Fonts, a Fonts window displays.


ΓòÉΓòÉΓòÉ 5.2.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.2.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 if you want to save the adjustment of the
 split bars for the next time you open the Registers window.


ΓòÉΓòÉΓòÉ 5.2.3. Restore Defaults Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 5.2.4. Tool Buttons Choice ΓòÉΓòÉΓòÉ

You can select to display the buttons in the tool bar of the window.

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


ΓòÉΓòÉΓòÉ 5.2.5. Hover Help Choice ΓòÉΓòÉΓòÉ

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

The hover help shows the names of the tool buttons.


ΓòÉΓòÉΓòÉ 5.2.6. Infoarea Choice ΓòÉΓòÉΓòÉ

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

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


ΓòÉΓòÉΓòÉ 5.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.


ΓòÉΓòÉΓòÉ 5.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.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 5.4.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Help index choice to 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.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.


ΓòÉΓòÉΓòÉ 5.4.3. Using Help Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 5.4.4. 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, including all system calls. The functions display in the order that
they were called.

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.

Tool buttons are provide 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 current 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

 Save to file
           Save the contents of the Call Stack window to an output file.

 Close debugger
           End your debugging session.


ΓòÉΓòÉΓòÉ 6.1.1. Save to File Choice ΓòÉΓòÉΓòÉ

Select the Save to file choice to save the Call Stack window contents to an
output file.

When you select the Save to file choice, the contents of the Call Stack window
are saved to the output file specified from the Options  Display Style window
for the Call Stack window.


ΓòÉΓòÉΓòÉ 6.1.2. 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
           Select if you want to display the buttons in the tool bar of 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.

 Unwind rings Check Box

 Enable the Unwind rings check box to have the debugger unwind the call stack
 across ring (privilege) transitions.  This allows you to view the call
 sequence from user applications into the kernel.

 Save file Entry Field

 This field specifies the name of the output file that is used to save the Call
 Stack window contents when the File menu choice Save to file is selected.


ΓòÉΓòÉΓòÉ 6.2.3. Restore Defaults Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 6.2.4. Tool Buttons Choice ΓòÉΓòÉΓòÉ

You can select to display the buttons in the tool bar of the window.

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


ΓòÉΓòÉΓòÉ 6.2.4.1. 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.4.2. 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 debugger help facility.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 6.4.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Help index choice to 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 OS/2
help facility.


ΓòÉΓòÉΓòÉ 6.4.4. 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.

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.)

Menu Summary

 Edit
   Change the variable or expression.

 Dereference
   Show the value to which the pointer points.

 Delete
   Delete the selected variable or expression that is being monitored.

 Next representation
   Change the representation of the variable or expression to the next on the
   list.

  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.

 Related Information

     Monitor Properties
     Program Monitor Window
     Private Monitor Window
     Popup Expression Window


ΓòÉΓòÉΓòÉ 7.1. File Menu ΓòÉΓòÉΓòÉ

Select choice from the File menu to close current debugging session.

 Menu Summary

 Delete
           Delete all the selected expressions.


ΓòÉΓòÉΓòÉ 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
           Display the  structure's elements beginning with the nth element.

 Representation
           Display the contents of a monitored variable in a different format.

 Copy to clipboard
           Copy the selected data to the clipboard.

 Save window in file
           Save the Local Variables window contents in a file.


ΓòÉΓòÉΓòÉ 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 Edit 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 range of elements (classes,
arrays, or structures) that are related to the variable or expression that you
are monitoring.


ΓòÉΓòÉΓòÉ 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 Registers window.


ΓòÉΓòÉΓòÉ 7.2.6. Representations ΓòÉΓòÉΓòÉ

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. Copy to Clipboard Choice ΓòÉΓòÉΓòÉ

Select the Copy to clipboard choice to copy data to the clipboard.


ΓòÉΓòÉΓòÉ 7.2.8. Save Window in File Choice ΓòÉΓòÉΓòÉ

Select the Save window in file choice to save the Local Variables window
contents in a file.  You can choose the file name by selecting Options ->
Debugger settings -> Monitor properties from the Debug Session Control window
or any of the source windows and filling in the Save File entry field. You can
also choose the file name by selecting Options -> Monitor properties from the
Monitor Properties window.


ΓòÉΓòÉΓòÉ 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 enablement
           Show the enablement status of variables and expressions on the
           Program Monitor window.

 Show context
           Display the contextual information for all selected expressions.

 Monitor properties
           Select the settings for the variable monitor windows.

 Tool buttons
           Enable or disable buttons from being displayed in the tool bar.

 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 color, the style settings, and the presentation of
tool buttons.


ΓòÉΓòÉΓòÉ 7.3.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
are 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.


ΓòÉΓòÉΓòÉ 7.3.4. Show Context Choice ΓòÉΓòÉΓòÉ

Select the Show context choice to display the contextual information for the
variable you are monitoring. The following information displays:

     Source

     File

     Line

     Thread.


ΓòÉΓòÉΓòÉ 7.3.5. 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.


ΓòÉΓòÉΓòÉ 7.3.6. Tool Buttons Choice ΓòÉΓòÉΓòÉ

You can select to display the buttons in the tool bar of the window.

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


ΓòÉΓòÉΓòÉ 7.3.7. 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.8. 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.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 7.5.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Help index choice to 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 OS/2
help facility.


ΓòÉΓòÉΓòÉ 7.5.4. 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:

     Using the mouse
     Using the mouse and monitor expression window
     Using the keyboard.

 You must select an expression with a valid:

     Operand type
     Operator
     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.

 Dereference
   Show the value to which the pointer points.

 Other elements
   Display the  structure's elements beginning with the nth element.

  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.

 Related Information

     Monitor Properties
     Program Monitor Window
     Private Monitor Window
     Popup Expression Window


ΓòÉΓòÉΓòÉ 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 highlighted thread to be executed.


ΓòÉΓòÉΓòÉ 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 prevent the displayed contents of a variable or
expression from updating.


ΓòÉΓòÉΓòÉ 8.4. Dereference ΓòÉΓòÉΓòÉ

Select the Dereference choice to show the contents of     a pointer.


ΓòÉΓòÉΓòÉ 8.5. Other Elements Choice ΓòÉΓòÉΓòÉ

Select theOther elements choice to view the next range of elements (classes,
arrays, or structures) that are related to the variable or expression that you
are monitoring.


ΓòÉΓòÉΓòÉ 8.6. 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:

     the program ends

     execution stops at an enabled breakpoint.

 When the debugger is running the run button changes to


ΓòÉΓòÉΓòÉ <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.7. File Menu ΓòÉΓòÉΓòÉ

Select choice from the File menu to close current debugging session.

 Menu Summary

 Close Debugger
           End your current debugging session.


ΓòÉΓòÉΓòÉ 8.7.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.8. 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
           Display the  structure's elements beginning with the nth element.

 Representation
           Display the contents of a monitored variable in a different format.

 Copy to clipboard
           Copy the selected data to the clipboard.

 Save window in file
           Save the Program Monitor window contents in a file.


ΓòÉΓòÉΓòÉ 8.8.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.8.2. Delete All Choice ΓòÉΓòÉΓòÉ

Select the Delete all choice to delete all variables or expressions that are
being monitored from a monitor window.


ΓòÉΓòÉΓòÉ 8.8.3. Select All Choice ΓòÉΓòÉΓòÉ

Select the Select all choice to select all the expressions in the window.


ΓòÉΓòÉΓòÉ 8.8.4. Deselect All Choice ΓòÉΓòÉΓòÉ

Select the Deselect all choice to cancel the selection of all the expressions
in the window.


ΓòÉΓòÉΓòÉ 8.8.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.8.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.8.7. Other Elements Choice ΓòÉΓòÉΓòÉ

Select the Other elements choice to view the next range of elements (classes,
arrays, or structures) that are related to the variable or expression that you
are monitoring.


ΓòÉΓòÉΓòÉ 8.8.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.8.9. Representations ΓòÉΓòÉΓòÉ

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.8.10. Copy to Clipboard Choice ΓòÉΓòÉΓòÉ

Select the Copy to clipboard choice to copy data to the clipboard.


ΓòÉΓòÉΓòÉ 8.8.11. Save Window in File Choice ΓòÉΓòÉΓòÉ

Select the Save window in file choice to save the Program Monitor window
contents in a file.  You can choose the file name by selecting Options ->
Debugger settings -> Monitor properties from the Debug Session Control window
or any of the source windows and filling in the Save File entry field. You can
also choose the file name by selecting Options -> Monitor properties from the
Monitor Properties window.


ΓòÉΓòÉΓòÉ 8.9. 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.

 Monitor properties
           Select the settings for the variable monitor windows.

 Tool buttons
           Enable or disable buttons from being displayed in the tool bar.

 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.9.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.9.2. Restore Defaults Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 8.9.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.9.4. Show Context Choice ΓòÉΓòÉΓòÉ

Select the Show context choice to display the contextual information for the
variable you are monitoring. The following information displays:

     Source

     File

     Line

     Thread.


ΓòÉΓòÉΓòÉ 8.9.5. Monitor Properties Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 8.9.6. Tool Buttons Choice ΓòÉΓòÉΓòÉ

You can select Tool buttons if you want to display the buttons in the tool bar
of the window.

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


ΓòÉΓòÉΓòÉ 8.9.7. 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.9.8. 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.10. 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.11. 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.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 8.11.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Help index choice to 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.11.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.11.3. Using Help Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 8.11.4. 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:

     Using the mouse

     Using the mouse and the Monitor window

     Using the keyboard.

 You must select an expression with a valid:

     Operand type

     Operator

     Typecasting operation.
 Related Information

     Local Variables Window
     Monitor Properties
     Program Monitor Window
     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:

     Using the mouse

     Using the mouse and the Monitor window

     Using the keyboard.

 You must select an expression with a valid:

     Operand type

     Operator

     Typecasting operation.

  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.

 Related Information

     Monitor Properties
     Program Monitor Window
     Private Monitor Window
     Popup Expression Window


ΓòÉΓòÉΓòÉ 10.1. File Menu ΓòÉΓòÉΓòÉ

Select choice from the File menu to close current debugging session.

 Menu Summary

 Delete
           Delete all the selected expressions.


ΓòÉΓòÉΓòÉ 10.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.


ΓòÉΓòÉΓòÉ 10.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.

 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
           Display the  structure's elements beginning with the nth element.

 Representation
           Display the contents of a monitored variable in a different format.

 Copy to clipboard
           Copy the selected data to the clipboard.

 Save to file
           Save the Private Monitor window contents in a file.


ΓòÉΓòÉΓòÉ 10.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.


ΓòÉΓòÉΓòÉ 10.2.2. Delete All Choice ΓòÉΓòÉΓòÉ

Select the Delete all choice to delete all variables or expressions that are
being monitored from a monitor window.


ΓòÉΓòÉΓòÉ 10.2.3. Select All Choice ΓòÉΓòÉΓòÉ

Select the Select all choice to select all the expressions in the window.


ΓòÉΓòÉΓòÉ 10.2.4. Deselect All Choice ΓòÉΓòÉΓòÉ

Select the Deselect all choice to cancel the selection of all the expressions
in the window.


ΓòÉΓòÉΓòÉ 10.2.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.2.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.2.7. Other Elements Choice ΓòÉΓòÉΓòÉ

Select the Other elements choice to view the next range of elements (classes,
arrays, or structures) that are related to the variable or expression that you
are monitoring.


ΓòÉΓòÉΓòÉ 10.2.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 Registers window.


ΓòÉΓòÉΓòÉ 10.2.9. Representations ΓòÉΓòÉΓòÉ

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.10. Copy to Clipboard Choice ΓòÉΓòÉΓòÉ

Select the Copy to clipboard choice to copy data to the clipboard.


ΓòÉΓòÉΓòÉ 10.2.11. Save to File Choice ΓòÉΓòÉΓòÉ

Select the Save to file choice to save the Private Monitor window contents in a
file.  You can choose the file name by selecting Options -> Debugger settings
-> Monitor properties from the Debug Session Control window or any of the
source windows and filling in the Save File entry field. You can also choose
Options -> Monitor properties from the Monitor Properties window.


ΓòÉΓòÉΓòÉ 10.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 enablement
           Show the enablement status of variables and expressions on the
           Private Monitor window.

 Show context
           Display the contextual information for all selected expressions.

 Monitor properties
           Select the settings for the variable monitor windows.

 Tool buttons
           Enable or disable buttons from being displayed in the tool bar.

 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.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.


ΓòÉΓòÉΓòÉ 10.3.2. Restore Defaults Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 10.3.3. Show Enablement Choice ΓòÉΓòÉΓòÉ

Select the Show enablement choice to show enablement of a monitored expression
in the active window.


ΓòÉΓòÉΓòÉ 10.3.4. Show Context Choice ΓòÉΓòÉΓòÉ

Select the Show context choice to display the contextual information for the
variable you are monitoring. The following information displays:

     Source

     File

     Line

     Thread.


ΓòÉΓòÉΓòÉ 10.3.5. Monitor Properties ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 10.3.6. Tool Buttons Choice ΓòÉΓòÉΓòÉ

You can select to display the buttons in the tool bar of the window.

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


ΓòÉΓòÉΓòÉ 10.3.7. 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.3.8. 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.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.


ΓòÉΓòÉΓòÉ 10.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.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 10.5.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Help index choice to 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.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.


ΓòÉΓòÉΓòÉ 10.5.3. Using Help Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 10.5.4. 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:

     Use the data manipulation icons

     Use the keyboard to move around a monitor

     Enable or disable monitors

     Display context

     Change the value of a variable

     Change the representation of a variable or expression.


ΓòÉΓòÉΓòÉ <hidden> Keyboard Sequences ΓòÉΓòÉΓòÉ

You can use various combinations of keys to move around the monitor windows.
The key combinations you can use and the functions they provide are:

 Action    Key Sequence

 Alt+     Move to the next monitor.

 Alt+     Move to the previous monitor.

 Tab       Move to the next monitor component. (The cursor moves in a circular
           fashion from component to component. The monitor, itself, is
           included in the circular path.)

 BackTab   Move to the previous monitor component.

 Alt+     Dereference a highlighted pointer.

 Enter     Open or close data structures (structures or arrays).

 Alt+PageUp, Alt+PageDown Scroll through the monitor.


ΓòÉΓòÉΓòÉ <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:

     Source

     File

     Line

     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:

     Hexadecimal

     Decimal

     String

     Character

     Floating-point

     Hexadecimal pointer

     Decimal pointer

     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:

               Fixed or floating-point constant.

                Note:  The largest floating-point constant is 1.8E308. The
                smallest floating-point is 2.23E-308.

               A string constant, enclosed in quotation marks (" ")

               A character constant, enclosed in single quote marks (' ')

               Segment:Offset address specification (0000:0000)

                When you are specifying a segment offset address for monitoring
                in a variable monitor window, specify the offset address in the
                following format:

                                     0x0000:0

 Register
           One of the following register names:
           AX, BX, CX, DX, SP, BP, SI, DI, 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:

     8-bit signed byte

     8-bit unsigned byte

     16-bit signed integer

     16-bit unsigned integer

     32-bit signed integer

     32-bit unsigned integer

     32-bit floating-point

     64-bit floating-point

     80-bit floating-point

     Pointers

     User-defined types.

 These data types include int, short, char and so on.


ΓòÉΓòÉΓòÉ <hidden> Using the Data Manipulation Icons ΓòÉΓòÉΓòÉ

You can select any of the following icons from any monitor window, such as
Program Monitor, Private Monitor, Popup Expression or Local Variables, to
manipulate the data parts of variables:

 +         Expands the contracted parts of an array, structure, or class.

 -         Contracts the parts of an expanded array, structure or class.

 >         Displays the object referenced by a pointer in a new monitor.

 The four windows to monitor variables and expressions are:

     Program Monitor

     Private Monitor

     Popup Expression

     Local Variables.


ΓòÉΓòÉΓòÉ 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:

     Fields for the displayed addresses. You may select one of the following
      storage models for the addresses that display:

        -  16:16 (segmented) storage addresses

        -  Flat storage model addresses

        -  Both 16:16 and flat storage model addresses.

     Fields for the data storage contents. Storage can be displayed in various
      styles. However, you can display only one storage style at a time.

     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:

     Scroll bars

     Up and Down arrow keys

     PageUp and PageDown keys.

 The address of the cursor displays in the tool bar 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 options that you can perform on the variables
 or expressions in the Storage window. 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.)

 Menu Summary

 Edit
   Edit the storage contents

 Edit
   Edit the storage contents.

 Change Address
   Change the address.

 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

     Updating Storage
     Specifying an Address Location
     Expression Language Guidelines


ΓòÉΓòÉΓòÉ 11.1. File Menu ΓòÉΓòÉΓòÉ

Select choice from the File menu to end your debugging session.

Menu Summary

 Save to file
           Saves the Storage windows contents in an output file.

 Close debugger
           End your debugging session.


ΓòÉΓòÉΓòÉ 11.1.1. Save to File Choice ΓòÉΓòÉΓòÉ

Select the Save to file choice to save the Storage window contents to an output
file.

When you select the Save to file choice, the contents of the Storage window are
saved to the output file specified from the Options  Display Style window for
the Storage window.


ΓòÉΓòÉΓòÉ 11.1.2. 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.1.3. Edit ΓòÉΓòÉΓòÉ

Select Edit to edit a line in the storage window, delete a line in the storage
window, or delete all lines in the storage window.


ΓòÉΓòÉΓòÉ 11.1.4. Edit ΓòÉΓòÉΓòÉ

Select Edit to edit a line in the storage window, delete a line in the storage
window, or delete all lines in the storage window.


ΓòÉΓòÉΓòÉ 11.1.5. Change Address ΓòÉΓòÉΓòÉ

Select Change Address to change the address of a line or all lines in the
storage window.


ΓòÉΓòÉΓòÉ 11.2. 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.

 Fill Storage
           Fill memory with a specific character or hexadecimal pattern.

 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 tool bar.

 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.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.


ΓòÉΓòÉΓòÉ 11.2.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.2.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.

 Save file Entry Field

 This field specifies the name of the output file that is used to save the
 Storage window contents when the File menu choice Save to file is selected.


ΓòÉΓòÉΓòÉ 11.2.3. Fill Storage Choice ΓòÉΓòÉΓòÉ

Use the Fill Storage window to fill memory with a specific character or
hexadecimal pattern.

When you select Fill storage, the Fill Storage window displays.


ΓòÉΓòÉΓòÉ 11.2.3.1. Fill Storage Window ΓòÉΓòÉΓòÉ

Use the Fill Storage window to fill memory with a specific character or
hexadecimal pattern.

     Type the starting address.

     Type the ending address or the length of the area to fill.

     Select either Character or Hexadecimal as the string type.

     Type the fill string in the Repeated string, Character or Byte(s) field.
      This string repeats as necessary and truncates.


ΓòÉΓòÉΓòÉ 11.2.4. 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.2.4.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:

     A valid operand type

     A valid operator

     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

     Expression Language Guidelines.


ΓòÉΓòÉΓòÉ 11.2.5. Restore Defaults Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 11.2.6. Tool Buttons Choice ΓòÉΓòÉΓòÉ

You can select to display the buttons in the tool bar of the window.

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


ΓòÉΓòÉΓòÉ 11.2.7. Hover Help Choice ΓòÉΓòÉΓòÉ

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

The hover help shows the names of the tool buttons.


ΓòÉΓòÉΓòÉ 11.2.8. Infoarea Choice ΓòÉΓòÉΓòÉ

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

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


ΓòÉΓòÉΓòÉ 11.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.


ΓòÉΓòÉΓòÉ 11.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.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 11.4.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Help index choice to 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.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.


ΓòÉΓòÉΓòÉ 11.4.3. Using Help Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ <hidden> Storage Display Styles ΓòÉΓòÉΓòÉ

You can display storage content in the following value styles:

     Hexadecimal and character text

     Character text

     16-bit integer

     16-bit unsigned integer

     16-bit integer in hexadecimal (byte reversed)

     32-bit integer

     32-bit unsigned integer

     32-bit integer in hexadecimal (byte reversed)

     32-bit floating-point

     64-bit floating-point

     80-bit floating-point

     16-bit near pointers

     16:16-bit far pointers

     32-bit flat pointers.

 You can display storage in the following address styles:

     Flat and 16:16

     Flat only

     16:16 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:

     Highlight the appropriate line and press Enter.  An entry field displays,
      Type the new storage information in the entry field.

     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 either the Flat address field or the
16:16 (segmented) address field. The Storage window scrolls to the appropriate
address.


ΓòÉΓòÉΓòÉ 12. Breakpoints List Window ΓòÉΓòÉΓòÉ

Use the Breakpoints List window to display a list of the breakpoints that have
been set. The following information is provided for each breakpoint.

     The enablement state
     The type of breakpoint
     The position of the breakpoint
     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.

 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, sort items, and
           display the Debug Session Control 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

     Breakpoints Menu
     Sort Breakpoint 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.

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


ΓòÉΓòÉΓòÉ 12.2. File Menu ΓòÉΓòÉΓòÉ

Select the choice from the File menu of the Breakpoints List 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 breakpoints, disable set
breakpoints, and modify set breakpoints.

Menu Bar Summary

 Delete
           Delete a breakpoint.

 Disable
           Disable a breakpoint.

 Modify
           Modify a breakpoint.

 Delete all
           Deletes all breakpoints.

 Disable all
           Disable all breakpoints.

 Enable all
           Enable all breakpoints.


ΓòÉΓòÉΓòÉ 12.3.1. Delete Choice ΓòÉΓòÉΓòÉ

Deletes any highlighted breakpoints in the Breakpoints List window.


ΓòÉΓòÉΓòÉ 12.3.2. Delete All Choice ΓòÉΓòÉΓòÉ

Deletes all breakpoints that are shown in the Breakpoints List window.


ΓòÉΓòÉΓòÉ 12.3.3. Disable Choice ΓòÉΓòÉΓòÉ

Disables a breakpoint.


ΓòÉΓòÉΓòÉ 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 ΓòÉΓòÉΓòÉ

Disables all breakpoints.


ΓòÉΓòÉΓòÉ 12.3.6. Enable All Choice ΓòÉΓòÉΓòÉ

Enables all breakpoints.


ΓòÉΓòÉΓòÉ 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 watchpoint...
           Set a watchpoint 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 Watchpoint Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 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:

     Setting simple line breakpoints

     Deleting simple line breakpoints.


ΓòÉΓòÉΓòÉ 12.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.


ΓòÉΓòÉΓòÉ 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 tool bar.

 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


ΓòÉΓòÉΓòÉ 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 appear in the Breakpoints
List window. You can select the type of descriptive information you want to
display for all of the breakpoint items.

To change how breakpoint items display:

     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 Breakpoints 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:

     Type
     Executable
     Source
     File
     Function
     Line
     Address
     State
     Status
     Thread
     Expression
     From
     To
     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 Breakpoints List window settings to their original settings.
This includes the font, the color, the style settings, and the presentation of
tople bar buttons.


ΓòÉΓòÉΓòÉ 12.5.5. Tool Buttons Choice ΓòÉΓòÉΓòÉ

You can select to display the buttons in the tool bar of the window.

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 all the
debugger windows.

The hover help shows the names of the tool buttons.


ΓòÉΓòÉΓòÉ 12.5.7. Infoarea Choice ΓòÉΓòÉΓòÉ

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

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 debugger help facility.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 12.7.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Help index choice to 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 OS/2
help facility.


ΓòÉΓòÉΓòÉ 12.7.4. 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:

     Executable

     Source

     Include File (optional)

     Line

     Thread

     From

     To

     Every

     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 List window for the current state of the breakpoints
 that have been set.

 Select the appropriate  push button to continue.


ΓòÉΓòÉΓòÉ 12.7.5. 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.6. 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 gray 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.7. 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. Application Exception Action Window ΓòÉΓòÉΓòÉ

The Application Exception Action window displays whenever an OS/2 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.

Selecting the Examine/Retry button lets you investigate the cause of the
exception and if you want, retry execution of the line that caused the original
fault. The debugger begins with the line causing the fault and attempts to
continue.

Selecting the Run Exception button is the same as issuing a gt command to the
kernel debugger. The debugger begins at the original trap handler address
without having to unhook the exception.


ΓòÉΓòÉΓòÉ 14. 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:

     If the source code is located in another directory on the system, type in
      the path name and select OK.

     If you do not have the source code for this component, select Cancel. The
      Disassembly window opens for this component.


ΓòÉΓòÉΓòÉ 15. Messages Window ΓòÉΓòÉΓòÉ

The Messages window displays kernel printfs and direct COM port messages from
device drivers.

 Menu Bar Summary

 File
           End your debugging session.

 Edit
           Erase the printfs that have accumulated in the Messages window.

 Options
           Control how the contents of variables display.

 Windows
           Display the active debugger windows.

 Help
           Display online help that complements the information that is
           displayed when you press F1 or select a Help push button.


ΓòÉΓòÉΓòÉ 15.1. File Menu ΓòÉΓòÉΓòÉ

Select choices from the File menu to end your debugging session or save the
Storage window contents to a file.

Menu Summary

 Close debugger
           End your current debugging session.


ΓòÉΓòÉΓòÉ 15.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.


ΓòÉΓòÉΓòÉ 15.2. Edit ΓòÉΓòÉΓòÉ

Select Edit to erase the printfs that have accumulated in the Messages window
or find a message within this window.

 Menu Bar Summary

 Delete all
           Delete all the printfs in the Messages window.

 Find
           Locate a text string within this window.

 Find next
           Find the next occurrence of a text string within this window.


ΓòÉΓòÉΓòÉ 15.2.1. Delete all ΓòÉΓòÉΓòÉ

Select the Delete all choice to delete all the messages contained within the
Messages window.


ΓòÉΓòÉΓòÉ 15.2.2. 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.


ΓòÉΓòÉΓòÉ 15.2.3. Find next ΓòÉΓòÉΓòÉ

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.


ΓòÉΓòÉΓòÉ 15.3. Options Menu ΓòÉΓòÉΓòÉ

Select choices from the Options menu to control how the message contents
display.

Menu Summary

 Fonts
           Select the font for the text in the Messages window.

 Display style
           Change the storage display format.

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

 Tool buttons
           Enable or disable buttons from being displayed on the tool bar.

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

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


ΓòÉΓòÉΓòÉ 15.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.


ΓòÉΓòÉΓòÉ 15.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.


ΓòÉΓòÉΓòÉ 15.3.2.1. Display Style Window ΓòÉΓòÉΓòÉ

Use the Display Style window to save the output of the Messages window in a
file, name the output file (the default name is messages.out), and to select
the maximum number of lines (the default is 100) displayed in the window.
Although all the lines are displayed, you must scroll up or down to view them.
After the maximum number of lines is reached, the earliest lines are removed
every time a new line is added.


ΓòÉΓòÉΓòÉ 15.3.3. Restore Defaults Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 15.3.4. Tool Buttons Choice ΓòÉΓòÉΓòÉ

Select the Tool buttons choice if you want to display the buttons in the tool
bar of the window.

If this choice is enabled, a bullet displays beside the Tool buttons choice and
buttons display.


ΓòÉΓòÉΓòÉ 15.3.5. Hover Help Choice ΓòÉΓòÉΓòÉ

Select the Hover help choice if you want hover help to be displayed in all the
debugger windows.

Hover help displays the names of the tool buttons.


ΓòÉΓòÉΓòÉ 15.3.6. Infoarea Choice ΓòÉΓòÉΓòÉ

Select the Infoarea choice if you want the information area to be displayed in
all the debugger windows.

The information area, located at the bottom of the window, provides a brief
description of each menu item and tool button.


ΓòÉΓòÉΓòÉ 15.4. Windows Menu ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 15.5. Help Menu ΓòÉΓòÉΓòÉ

Select choices from the Help menu to complement the online help information
that is displayed 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.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 15.5.1. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Help index choice to 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.


ΓòÉΓòÉΓòÉ 15.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.


ΓòÉΓòÉΓòÉ 15.5.3. Using Help Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 15.5.4. Product Information Choice ΓòÉΓòÉΓòÉ

Select the Product information choice to display the product information.


ΓòÉΓòÉΓòÉ 16. Passthru Window ΓòÉΓòÉΓòÉ

The Passthru window allows you to send commands to KDB and view its responses.
The window has a command entry field where you enter the KDB commands, and a
response area that displays the KDB output.

The KDB response area is scrollable, which allows you to review previous KDB
responses from prior commands.  This output area also appends a status icon for
each line to indicate your input, the debugger's acceptance of that input, and
text from KDB.

Note:  When you send KDB commands using the Passthru window, the debugger does
not update its state.  Thus, you should use this window for obtaining
information instead of altering registers or data.

To send a command to KDB, do the following:

   1. Type the command you want to send in the Command entry field.
   2. Select the Send push button or press the Enter key.
   3. Select the Resync button to force the debugger to refresh all of its
      internal caches of the target machine state.  Use this button if you used
      the Passthru window to alter the state on the target machine.

 Note:  Commands that cause the target machine to resume execution (for
 example, g and t) should be avoided.  They can cause the debugger to lock up.
 The debugger tries to filter out the KDB commands that can cause a lockup, but
 you should always exercise caution.

 Passthru Popup Menu

 The Passthru Popup Menu contains options that you can perform on the variables
 or expressions in the Passthru window.

 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

 Execute
   Execute a line in the response area.

 Delete
   Delete lines in the response area.

 Edit
   Edit or delete lines in the response area.

 Menu Bar Summary

 File
           End the debugging session.

 Edit
           Edit or delete lines in the response area.

 Options
           Change the font, control how items are displayed, and enable or
           disable tool buttons, hover help or infoarea information.

 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.


ΓòÉΓòÉΓòÉ 16.1. File Menu ΓòÉΓòÉΓòÉ

Select choice from the File menu to end your debugging session.

Menu Summary

 Close debugger
           End your debugging session.


ΓòÉΓòÉΓòÉ 16.1.1. Close Debug 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.


ΓòÉΓòÉΓòÉ 16.2. Edit Menu ΓòÉΓòÉΓòÉ

Select choices from the Edit menu to edit or delete commands.

Menu Bar Summary

 Edit
           Edit lines in the response area.

 Delete
           Delete a line in the response area.

 Delete all
           Deletes all lines in the response area.

 Find
           Search for text strings in the active window.

 Find Next
           Find the next occurrence of a string.


ΓòÉΓòÉΓòÉ 16.2.1. Execute ΓòÉΓòÉΓòÉ

Select Execute to execute a highlighted line in the response area.


ΓòÉΓòÉΓòÉ 16.2.2. Delete ΓòÉΓòÉΓòÉ

Select Delete to delete a highlighted line in the response area.


ΓòÉΓòÉΓòÉ 16.2.3. Edit ΓòÉΓòÉΓòÉ

Select Edit to edit a line in the response area, delete a line in the response
area, or delete all the lines in the response area.


ΓòÉΓòÉΓòÉ 16.2.4. Edit Choice ΓòÉΓòÉΓòÉ

Select the choices from the Edit menu to edit a line in the response area,
delete a line in the response area, or delete all the lines in the response
area of the Passthru window.


ΓòÉΓòÉΓòÉ 16.2.5. Delete Choice ΓòÉΓòÉΓòÉ

Select the Delete choice to delete a line in the response area of the Passthru
window.

To delete a line:

   1. Highlight the line you want to delete.
   2. Select the Delete choice.


ΓòÉΓòÉΓòÉ 16.2.6. Delete all ΓòÉΓòÉΓòÉ

Select the Delete all choice to delete all the lines in the response area of
the Passthru window.

To delete all the lines in the response area:

   1. Select the Delete all choice. When you select the Delete all choice, a
      message box prompts you to confirm that you want to delete all the lines.
   2. Select Yes.


ΓòÉΓòÉΓòÉ 16.2.7. 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.


ΓòÉΓòÉΓòÉ 16.2.8. 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.


ΓòÉΓòÉΓòÉ 16.3. Options Menu ΓòÉΓòÉΓòÉ

Select choices from the Options menu to change the font and control what items
are shown in the Passthru window.

Menu Bar Summary

 Fonts
           Change the font in the window.

 Display style...
           Select the items you want displayed in the window, number of items
           you want displayed, and save the output in a file.

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

 Tool buttons
           Display the tool buttons in the window.

 Hover help
           Display the hover help.

 Infoarea
           Display the information area.

 Resync with ring 3
           Changes the debugger to ring-3 context.

 Add custom tool buttons
           Associate a Passthru command with a tool button icon.


ΓòÉΓòÉΓòÉ 16.3.1. Fonts Choice ΓòÉΓòÉΓòÉ

Displays the Font window, which allows you to select the type of font you want
to use for the Passthru window.


ΓòÉΓòÉΓòÉ 16.3.2. Display Style Choice ΓòÉΓòÉΓòÉ

Displays the Display Style window, which allows you to select the items you
want displayed in the window, select the number of items you want displayed,
and save the output in a file.


ΓòÉΓòÉΓòÉ 16.3.2.1. Display Style ΓòÉΓòÉΓòÉ

To use the Display Style window:

     Select the items you want under the Select Items group heading. Each item
      you select causes a new column to be added to the response area of the
      Passthru window.
     In the Number Items entry field, type the number of lines you want to be
      displayed in the response area.  The maximum number of lines is 10,000.
     The Output File entry field allows you to specify the name of the file
      where Passthru responses are optionally saved.
     The Save output in file also check box allows you to copy the Passthru
      response items into a file (logging function). If the check box is
      enabled, the responses are copied into the file that you specified in the
      Output File entry field.


ΓòÉΓòÉΓòÉ 16.3.3. Restore Defaults Choice ΓòÉΓòÉΓòÉ

Select the Restore defaults choice to reset all of the window settings to their
original settings.


ΓòÉΓòÉΓòÉ 16.3.4. Add Custom Tool Buttons Choice ΓòÉΓòÉΓòÉ

Select the Add custom tool buttons choice to associate a Passthru command with
a tool button icon. When you select Add custom tool button, the Add custom tool
button window displays.


ΓòÉΓòÉΓòÉ 16.3.4.1. Add Custom Tool Button ΓòÉΓòÉΓòÉ

To use the Add custom tool button choice:

   1. Select one of the 10 icons to associate with a command.
   2. Enter a Passthru command in the Commands entry field.  For example, dg
      cs.
   3. Select the Add push button to place the icon on the toolbar. When you
      select the icon from the toolbar, the associated command is executed.
      You can add, delete, or change icons and their associated text.

 Note:  If the tool buttons choice has not been selected or if the tool buttons
 are on the title bar, you can not select the Add custom tool buttons choice.


ΓòÉΓòÉΓòÉ 16.3.5. Tool Buttons Choice ΓòÉΓòÉΓòÉ

You can select to display the buttons in the tool bar of the window.

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


ΓòÉΓòÉΓòÉ 16.3.6. Hover Help Choice ΓòÉΓòÉΓòÉ

Select the Hover help choice if you want hover help.


ΓòÉΓòÉΓòÉ 16.3.7. Infoarea Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 16.3.8. Resync With Ring 3 Choice ΓòÉΓòÉΓòÉ

Select the Resync with ring 3 choice if you want the debugger to act as though
it is in the ring-3 context just before it entered the kernel on the current
thread. The assumption is that the current thread is at ring 0.


ΓòÉΓòÉΓòÉ 16.4. Windows Menu ΓòÉΓòÉΓòÉ

Select the Windows menu from the Passthru window to view a list of all the open
debugger windows. By selecting a window from the Windows menu, it is brought
into focus and made the active window. Also, if the window is minimized, it is
restored.


ΓòÉΓòÉΓòÉ 16.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.

 Product information
           Display product information.


ΓòÉΓòÉΓòÉ 16.5.1. Product Information Choice ΓòÉΓòÉΓòÉ

Select the Product information choice to display the product information.


ΓòÉΓòÉΓòÉ 16.5.2. Help Index Choice ΓòÉΓòÉΓòÉ

Select the Help index choice to 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.


ΓòÉΓòÉΓòÉ 16.5.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.


ΓòÉΓòÉΓòÉ 16.5.4. Using Help Choice ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 16.5.5. Product Information Choice ΓòÉΓòÉΓòÉ

Select the Product information choice to display the product information.


ΓòÉΓòÉΓòÉ <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.

 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.

 File List
           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.6. 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.7. 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.

 File List
           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:

     Automatic variable

     Breakpoint

     Clock icon

     Component

     Context

     Debug data

     Disable

     Enable

     Event breakpoint

     Executable files

     Executable statement

     Functions

     Local variables

     Location breakpoint

     Object files

     Overloaded

     Prefix area

     Process

     Program generated breakpoint

     Program profiles

     Search path

     Session

     Stopping thread

     Storage

     Thread


ΓòÉΓòÉΓòÉ 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. Clock Icon ΓòÉΓòÉΓòÉ

There are two wait states in the debugger.

When the debugger is busy doing something, it displays a clock icon. This icon
displays when the wait is over (for example, loading a program into the
debugger).

When your program is running, the debugger displays a clock icon with a
rectangle behind it. This may mean that your program is waiting for input. If
so, select your application window (if necessary) and provide it with the input
it needs.


ΓòÉΓòÉΓòÉ 17.4. Component ΓòÉΓòÉΓòÉ

Components are the executable files, source files or object files, and the
functions that comprise a program.


ΓòÉΓòÉΓòÉ 17.5. 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.6. Debuggee ΓòÉΓòÉΓòÉ

Debuggee is the application that is being debugged.


ΓòÉΓòÉΓòÉ 17.7. Debuggee window ΓòÉΓòÉΓòÉ

Debuggee window is a window built by the application being debugged. Every
debuggee window is a descendent of the desktop or desktop-object window.


ΓòÉΓòÉΓòÉ 17.8. Debugging data ΓòÉΓòÉΓòÉ

Debugging data is the symbolic and line number information contained in the
executable file.


ΓòÉΓòÉΓòÉ 17.9. Disable ΓòÉΓòÉΓòÉ

Disable prevents a thread from executing.


ΓòÉΓòÉΓòÉ 17.10. Enable ΓòÉΓòÉΓòÉ

Enable allows a thread to execute.


ΓòÉΓòÉΓòÉ 17.11. Event breakpoint ΓòÉΓòÉΓòÉ

An event breakpoint is one of the following:

     A load occurrence breakpoint

     A watchpoint.


ΓòÉΓòÉΓòÉ 17.12. Executable files ΓòÉΓòÉΓòÉ

Executable files are the EXE or DLL files.


ΓòÉΓòÉΓòÉ 17.13. 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.14. Functions ΓòÉΓòÉΓòÉ

A Function is a block of statements executed by a function call. Synonymous
with procedures.


ΓòÉΓòÉΓòÉ 17.15. Image ΓòÉΓòÉΓòÉ

Image is a graphical representation of a program s windows in three dimensions
(x, y, and z). A window is represented on a plane (x and y), using its size and
position. Window planes in the image are perpendicular to the z-axis and
positioned in z-order. A window at the top of z-order has the largest z
coordinate and is the top window.


ΓòÉΓòÉΓòÉ 17.16. 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.17. Local variables ΓòÉΓòÉΓòÉ

A local variable is a variable that is specific to a function. The debugger
displays the following types of local variables:

     Static

     Automatic

     Parameters.


ΓòÉΓòÉΓòÉ 17.18. Location breakpoint ΓòÉΓòÉΓòÉ

A location breakpoint is one of the following:

     A line breakpoint

     An address breakpoint

     A function breakpoint.


ΓòÉΓòÉΓòÉ 17.19. Non-Debuggee ΓòÉΓòÉΓòÉ

Non-debuggee is an application that is not being debugged.


ΓòÉΓòÉΓòÉ 17.20. Non-Debuggee window ΓòÉΓòÉΓòÉ

Non-debuggee window is a window not built by the application being debugged.
Every non-debuggee window is a descendent of the desktop or desktop-object
window.


ΓòÉΓòÉΓòÉ 17.21. Object files ΓòÉΓòÉΓòÉ

Object files are the object (OBJ) files.


ΓòÉΓòÉΓòÉ 17.22. 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.23. Parent-Child relationship ΓòÉΓòÉΓòÉ

Parent-child relationship defines the appearance of a window when it is drawn
on the screen. A child window is drawn relative to its parent window. No part
of a child window ever displays outside the borders of its parent window.


ΓòÉΓòÉΓòÉ 17.24. Post messages ΓòÉΓòÉΓòÉ

Messages created through WinPostMsg or WinPostMsgQueu. The calls place the
message on the Message Queue of the receiver. The message is posted on the
Message Queue. The calls return immediately not waiting for the receiver to
return.


ΓòÉΓòÉΓòÉ 17.25. Prefix area ΓòÉΓòÉΓòÉ

Prefix area is the area within the source views where line numbers or address
numbers are located.


ΓòÉΓòÉΓòÉ 17.26. Process ΓòÉΓòÉΓòÉ

Process is the collection of one or more threads and their associated system
resources, such as storage, open files, and devices.


ΓòÉΓòÉΓòÉ 17.27. Program generated breakpoint ΓòÉΓòÉΓòÉ

 A program generated breakpoint is the trap instruction, which in the case of
OS/2 is a CC instruction, which 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.28. 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 @4R.

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.29. 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.30. 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_OVERRIDE environment variable, if specified.

   2. The path where the object file was compiled.

   3. The path defined by the CAT_LOCAL_PATH environment variable, if
      specified.

   4. The path where the executable file is located.

   5. The path defined by the CAT_PATH environment variable, if specified.

   6. The current path.

   7. The path defined in the INCLUDE environment variable.

   8. The path of the last source file found in this debug session.

 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 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.31. Send messages ΓòÉΓòÉΓòÉ

Messages created through WinSendMsg call. The WinSendMsg function call does not
complete until the message has been processed by the window procedure whose
return value is returned.

If the window receiving the message belongs to the same thread, the window
function is called immediately as a subroutine. If the window is of another
thread or process, the operating system switches to the appropriate thread then
enters the necessary window procedure recursively. The message is not placed in
the queue of the destination thread.


ΓòÉΓòÉΓòÉ 17.32. Session ΓòÉΓòÉΓòÉ

Session is the collection of one or more processes associated with a virtual
console such as keyboard, video display, or mouse.


ΓòÉΓòÉΓòÉ 17.33. Shortcut keys ΓòÉΓòÉΓòÉ

Shortcut keys are the keyboard keys that you use to invoke the menu choices.


ΓòÉΓòÉΓòÉ 17.34. Stopping thread ΓòÉΓòÉΓòÉ

A stopping thread is the thread that caused the program being debugged to stop.


ΓòÉΓòÉΓòÉ 17.35. Storage ΓòÉΓòÉΓòÉ

The storage is the computer memory space in use during the execution of a
program.


ΓòÉΓòÉΓòÉ 17.36. Tag word ΓòÉΓòÉΓòÉ

The contents of a tag word tell you which registers are in use at a specific
time.


ΓòÉΓòÉΓòÉ 17.37. Thread ΓòÉΓòÉΓòÉ

A thread is the basic OS/2 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.37.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.


ΓòÉΓòÉΓòÉ 17.38. Z-Order ΓòÉΓòÉΓòÉ

Z-order is the order of overlapping windows. Every window, in addition to
having a screen position, has a z-order position. This viewing order is
oriented along an imaginary axis, the z-axis, extending outward from the
screen. A window at the bottom of the z-order is overlapped by all sibling
windows.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Trademark of International Business Machines