home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 10 Tools
/
10-Tools.zip
/
cset21v1.zip
/
IBMCPP
/
HELP
/
DDE4HELP.HLP
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1993-06-25
|
166KB
|
5,910 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:
o IBM
o OS/2
o Presentation Manager
ΓòÉΓòÉΓòÉ 2. Glossary ΓòÉΓòÉΓòÉ
Double-click on any term for a definition:
o Asynchronous
o Automatic variable
o Breakpoint
o Component
o Context
o Debug data
o Debuggee
o Desktop
o Desktop-object
o Disable
o Enable
o Event breakpoint
o Executable files
o Executable statement
o Functions
o Image
o Local variable
o Location breakpoint
o Non-debuggee
o Object files
o Overloaded
o Parent-child relationship
o Prefix area
o Process
o Recursion level
o Restart information
o Session
o Shortcut keys
o Stopping thread
o Storage
o Synchronous
o Tag word
o Thread.
o Post messages.
o Send messages.
o Profile information.
o Z-order.
ΓòÉΓòÉΓòÉ 2.1. 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.
ΓòÉΓòÉΓòÉ 2.2. Profile information ΓòÉΓòÉΓòÉ
Profile information This information does not pertain to the specific
application being debugged.
ΓòÉΓòÉΓòÉ 2.3. 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.
ΓòÉΓòÉΓòÉ 2.4. 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.
ΓòÉΓòÉΓòÉ 2.5. 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 appears outside the borders of its parent window.
ΓòÉΓòÉΓòÉ 2.6. 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.
ΓòÉΓòÉΓòÉ 2.7. 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.
ΓòÉΓòÉΓòÉ 2.8. Debuggee ΓòÉΓòÉΓòÉ
Debuggee is the application that is being debugged.
ΓòÉΓòÉΓòÉ 2.9. Non-Debuggee ΓòÉΓòÉΓòÉ
Non-debuggee is an application that is not being debugged.
ΓòÉΓòÉΓòÉ 2.10. 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.
ΓòÉΓòÉΓòÉ 2.11. 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.
ΓòÉΓòÉΓòÉ 2.12. Desktop window ΓòÉΓòÉΓòÉ
Desktop window is a window automatically created by OS/2 when it starts a PM
interface session. The desktop window serves as a base (bottom-most) window
for the windows which can be displayed. Whether a descendent window is
actually seen depends on the window visibility, its position and size, and
overlapping windows. The desktop window paints the background color of the
screen.
ΓòÉΓòÉΓòÉ 2.13. Desktop-Object Window ΓòÉΓòÉΓòÉ
Desktop-object window is a window automatically created by OS/2 when it starts
a PM interface session. The desktop-object window serves as a base
(bottom-most) window for the windows that can not be displayed. This is
irrespective for the window visibility, its position and size, and overlapping
windows. Any descendents of the desktop-object windows are called object
windows. Object windows provide services to other windows.
ΓòÉΓòÉΓòÉ 2.14. Functions ΓòÉΓòÉΓòÉ
A Function is a block of statements executed by a function call. Synonymous
with procedures.
ΓòÉΓòÉΓòÉ 2.15. Overloaded ΓòÉΓòÉΓòÉ
An overloaded function occurs when there is more than one function with the
same name.
ΓòÉΓòÉΓòÉ 2.16. Executable statement ΓòÉΓòÉΓòÉ
An executable statement is a statement where you can stop the execution of your
program by setting breakpoints. These statements are displayed in blue.
ΓòÉΓòÉΓòÉ 2.17. Enable ΓòÉΓòÉΓòÉ
Enable allows a thread to execute.
ΓòÉΓòÉΓòÉ 2.18. Disable ΓòÉΓòÉΓòÉ
Disable prevents a thread to from executing.
ΓòÉΓòÉΓòÉ 2.19. Executable files ΓòÉΓòÉΓòÉ
Executable files are the EXE or DLL files.
ΓòÉΓòÉΓòÉ 2.20. Debug data ΓòÉΓòÉΓòÉ
Debug data is the symbolic and line number information contained in the
executable file.
ΓòÉΓòÉΓòÉ 2.21. Object Files ΓòÉΓòÉΓòÉ
Object files are the object (OBJ) files.
ΓòÉΓòÉΓòÉ 2.22. Process ΓòÉΓòÉΓòÉ
Process is the collection of one or more threads and their associated system
resources, such as storage, open files, and devices.
ΓòÉΓòÉΓòÉ 2.23. Restart information ΓòÉΓòÉΓòÉ
Restart information is used to restore the debugger windows and breakpoints
when debugging a program more than once. It is stored separately for each
program debugged. The file extension for the files that contain this
information is @2R.
Note: Only information for executable files and preloaded DLLs relating to the
primary thread is restored.
ΓòÉΓòÉΓòÉ 2.24. Session ΓòÉΓòÉΓòÉ
Session is the collection of one or more processes associated with a virtual
console such as keyboard, video display, or mouse.
ΓòÉΓòÉΓòÉ 2.25. Shortcut keys ΓòÉΓòÉΓòÉ
Shortcut keys are the keyboard keys that you use to invoke the menu choices.
ΓòÉΓòÉΓòÉ 2.26. Asynchronous ΓòÉΓòÉΓòÉ
When the debugger is operating in asynchronous mode and the debuggee is
stopped, message handling is stopped. All processing of PM messages is
suspended except for the debugger which will continue to operate. All PM
messages are sent to the debugger, which answers the messages with a simple
generic response. Thus, debuggee messages are lost. When you are running the
debugger in asynchronous mode, other PM applications running in the system do
not halt when the debugger stops.
ΓòÉΓòÉΓòÉ 2.27. 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.
ΓòÉΓòÉΓòÉ 2.28. Local variable ΓòÉΓòÉΓòÉ
A local variable is a variable that is specific to a function. The debugger
displays the following types of local variables:
o Static
o Automatic
o Parameters.
ΓòÉΓòÉΓòÉ 2.29. Breakpoint ΓòÉΓòÉΓòÉ
A breakpoint is a defined location or condition in a program that, when it is
met, stops the execution of the program.
ΓòÉΓòÉΓòÉ 2.30. Event breakpoint ΓòÉΓòÉΓòÉ
An event breakpoint is one of the following:
o A load occurrence breakpoint
o A change address breakpoint.
ΓòÉΓòÉΓòÉ 2.31. Stopping thread ΓòÉΓòÉΓòÉ
A stopping thread is the thread that caused the program being debugged to stop.
ΓòÉΓòÉΓòÉ 2.32. Location breakpoint ΓòÉΓòÉΓòÉ
A location breakpoint is one of the following:
o A line breakpoint
o An address breakpoint
o A function breakpoint.
ΓòÉΓòÉΓòÉ 2.33. Prefix area ΓòÉΓòÉΓòÉ
Prefix area is the area within the program view windows where line numbers or
address numbers are located.
ΓòÉΓòÉΓòÉ 2.34. Component ΓòÉΓòÉΓòÉ
Components are the executable files, source files or object files, and the
functions that comprise a program.
ΓòÉΓòÉΓòÉ 2.35. 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.
ΓòÉΓòÉΓòÉ 2.36. Storage ΓòÉΓòÉΓòÉ
The storage is the computer memory space in use during the execution of a
program.
ΓòÉΓòÉΓòÉ 2.37. Synchronous ΓòÉΓòÉΓòÉ
When the debugger is operating in synchronous mode and the debuggee is stopped,
message handling is stopped. All processing of PM messages is suspended except
for the debugger which will continue to operate. The order of all messages is
maintained, except for the debugger. No messages are lost.
ΓòÉΓòÉΓòÉ 2.38. Tag word ΓòÉΓòÉΓòÉ
The contents of a tag word tell a programmer which registers are in use at a
specific time.
ΓòÉΓòÉΓòÉ 2.39. 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.
ΓòÉΓòÉΓòÉ 3. Debug Session Control Window ΓòÉΓòÉΓòÉ
The Debug Session Control window is the control window of the debugger and is
displayed during the entire debugging session. This window contains the threads
and components for the program you are debugging.
The Threads box contains the threads and the state of the threads that have
been started by your program. The following states are possible for the threads
listed in the Threads box:
o Enabled and runnable
o Disabled and runnable
o Critical and runnable
o Suspended and runnable
o Enabled and blocked
o Disabled and blocked
o Critical and blocked
o Suspended and blocked.
To view the state of a thread, click on the plus icon to the left of the
thread. You may enable or disable the thread highlighted in the Threads list by
toggling the Enabled choice from the Run menu. When a check mark is displayed,
threads are enabled and the debugger allows the highlighted thread to be
executed. When the check mark is not displayed, threads are disabled and are
not executed. You can also double-click on Enabled to change the thread status
to Disabled.
The Components box shows the executable files that are associated with the
program you are debugging. To display a list of object files contained within
an executable file, click on the plus icon to the left of the executable file
name. To open a program view of an object file, double-click on the object file
name. To display a list of functions for a specific object file, click on the
plus icon to the left of the object file name. To open a program view to a
specific function, double-click on the function name. You can view any
component by double-clicking on the name of the component displayed in the
Components box, or by highlighting the component and selecting a view from the
View cascading choice from the File menu.
You specify which components are displayed in the Components list by selecting
Options Window Settings Only components with debug data. If this choice is
enabled, only components compiled and linked with debug data are listed.
Otherwise, all components are listed.
You can also access any debugger window that is already open and hidden or
minimized by selecting the menu choice that displays that window from the
Windows menu.
Menu Bar Summary
File
Start or end the debugging session and control the program views.
Breakpoints
Set and manipulate breakpoints in your programs.
Windows
Select other windows to be displayed.
Run
Execute the program, halt execution, or enable/disable threads.
Options
Access various utility action windows where you can set debugger options.
These debugger options control the various debugger windows.
Help
You have access to several kinds of help information that compliment the
online help information that you can get for the debugger. Press F1 or
select the Help push button.
ΓòÉΓòÉΓòÉ 3.1. File Menu ΓòÉΓòÉΓòÉ
Select choices from the File menu of the Debug Session Control window 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
View
Select one of the three program view windows.
Locate function
Open a program view window to a particular function.
Open new source
Display a new source file.
Where
Open a program view containing the next line to be executed.
Startup
Start the program you want to debug after terminating the current program.
Restart
Restart the current debugging session.
Close debug
End the debugging session.
ΓòÉΓòÉΓòÉ 3.1.1. View Cascading Choice ΓòÉΓòÉΓòÉ
Select the View cascading choice to open a view of your program. You can view
the program as:
o Source
o Disassembly
o Mixed.
The selected view is displayed in a new window. Program views are
thread-specific. Executable lines are displayed in blue and non-executable
lines are displayed in black. Any lines that are highlighted in the existing
view are also highlighted in the new view and any breakpoints highlighted in
the prefix area of the existing view are also shown in the new view. If you
select a view that is already open, that view is focused and moved in front of
the other windows.
ΓòÉΓòÉΓòÉ 3.1.2. Where Choice ΓòÉΓòÉΓòÉ
Select the Where choice to locate the next line to be executed in the thread.
ΓòÉΓòÉΓòÉ 3.1.3. Startup Choice ΓòÉΓòÉΓòÉ
Select the Startup choice to start a program for debugging. You can select
Startup to finish debugging the program you are currently debugging and to
start another program for debugging.
When you select Startup, the Startup Information action window appears.
ΓòÉΓòÉΓòÉ 3.1.4. Restart Choice ΓòÉΓòÉΓòÉ
Select the Restart choice to terminate the current program and start the
debugging session using restart information.
ΓòÉΓòÉΓòÉ 3.1.5. Source Filename Action Window ΓòÉΓòÉΓòÉ
The Source Filename action window appears when you try to open a component for
which you have debug data, but the debugger cannot locate the source code.
To use the Source Filename action window:
1. If the source code is located in another directory on the system, type in
the path name and select OK.
2. If you do not have the source code for this component, select Cancel. The
Disassembly view is opened for this component.
ΓòÉΓòÉΓòÉ 3.2. Startup Information Action Window ΓòÉΓòÉΓòÉ
Use the Startup Information action window to specify the program you want to
start for this debugging session.
1. Select a program for debugging by using one of the following methods:
o Type the name of the program you want to start in the Program entry field.
(If you type the name, it must be the full path name of the file).
o Open the Program list by selecting the arrow then selecting a program
name. (The programs listed are those for which restart information has
been saved).
o Select the File List push button and select a program from the Select
Program action window.
2. Type any parameters you want to pass to your program in the Parameters
entry field. Separate multiple parameters with a space.
Note: All DLLs used by your program must be in directories specified in
your LIBPATH.
3. Select one of the push buttons to continue.
Program
Type the name of the program you want to start for your debugging session. You
do not need to include the file name extension when you type the program name.
Parameters
If the program accepts parameters, type the parameters that you want to pass to
the program you are starting.
Use restart information
Select the Use restart information check box to start the debugging session
with
Note: Restart information is saved with a time stamp. A time stamp check is
done before the program is started with restart information.
Debug program initialization
Select Debug program initialization to halt execution of the application before
any initialization routines have been executed. This allows you to debug any
DLL initialization routines.
Save session settings
Select the Save session settings check box to save action window settings that
you saved for the next debugging session.
ΓòÉΓòÉΓòÉ 3.2.1. Push Buttons ΓòÉΓòÉΓòÉ
OK
Select OK to accept the information you have entered and close this action
window.
Cancel
Select Cancel to close this action window.
Help
Select Help to display help information that tells you how to use this action
window.
ΓòÉΓòÉΓòÉ 3.2.2. Time Stamp Check ΓòÉΓòÉΓòÉ
Information that is restart information includes the time stamps on the
executable files that make up the application. When you select to start a
program with restart information, the debugger compares the time stamps in the
executable program file (and the pre-loaded dynamic link libraries) with the
time stamp on the restart information. If these time stamps do not match, a
message box is displayed.
Select Yes from the message box to start the program with restart information,
select No to load the program without the restart information, or select Cancel
to cancel the startup process and return to the Debug Session Control window.
If the source has been changed but not compiled, breakpoints might be invalid
or appear on the wrong line.
ΓòÉΓòÉΓòÉ 3.3. Breakpoints Menu ΓòÉΓòÉΓòÉ
Select choices from the Breakpoints menu to set breakpoints 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 the
program view windows. 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 can be set. The breakpoints can be
customized using the various breakpoint action windows.
Menu Summary
Line
Set a line breakpoint to stop the execution of your program at a specific
line number.
Function
Set a function breakpoint to stop the execution of your program after a
specific function is called.
Address
Set an address breakpoint to stop the execution of your program at specific
address.
Change address
Set a change address breakpoint to stop the execution of your program when
contents of memory at a given address changes.
Load occurrence
Set a load occurrence breakpoint to stop the execution of your program after
a DLL is loaded.
List
List the breakpoints that have been set.
Delete all
Delete all the breakpoints that have been set.
You can also set simple line breakpoints. Double-click on one of the following
for the procedure you use to set or clear simple line breakpoints:
o Setting simple line breakpoints
o Clearing simple line breakpoints.
ΓòÉΓòÉΓòÉ 3.3.1. 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 action window is
displayed.
You can also set simple line breakpoints. Double-click on one of the following
for the procedure you use to set or clear simple line breakpoints:
o Setting simple line breakpoints
o Clearing simple line breakpoints.
ΓòÉΓòÉΓòÉ 4. Setting Breakpoints ΓòÉΓòÉΓòÉ
Use the Setting Breakpoints action window to select the type of breakpoint you
want to set in your program. The tabs at the bottom of the notebook represent
the five different types of breakpoints.
For detailed information on how to set a breakpoint, double-click on one of the
following:
Line
Allows you to set a line breakpoint that stops the execution of your
program at a line number.
Function
Allows you to set a function breakpoint that stops the execution of
your program after the function that you specify is called.
Address
Allows you to set an address breakpoint that stops the execution of
your program at an address.
Change
Allows you to set a change address breakpoint that stops the
execution of your program after the contents of memory at a given
address changes.
Load
Allows you to set a load occurrence breakpoint that stops the
execution of your program after the DLL that you specify is loaded.
List
Allows you to see a list of all the breakpoints that have been set.
You can also set simple line breakpoints. Double-click on one of the following
for the procedure you use to set or clear simple line breakpoints:
o Setting simple line breakpoints
o Clearing simple line breakpoints.
ΓòÉΓòÉΓòÉ 4.1. Setting a Line Breakpoint ΓòÉΓòÉΓòÉ
Use the Line action window to set a line breakpoint.
For a description of types you can enter in the action window, double-click on
one of the following topics:
o Executable
o Source
o File
o Line number
o Expression
o Thread
o Every
o From
o To
Select the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 4.1.1. Push Buttons ΓòÉΓòÉΓòÉ
OK
Select OK to accept the information you have entered and to close this action
window.
Set
Select Set to set a breakpoint.
Default
Select Default to change to the default settings.
Cancel
Select Cancel to close this action window.
Help
Select Help to display help information that tells you how to use this action
window.
ΓòÉΓòÉΓòÉ 4.1.2. Push Buttons ΓòÉΓòÉΓòÉ
OK
Select OK to accept the information you have entered and to close this action
window.
Set
Select Set to set the breakpoints.
Cancel
Select Cancel to close this action window.
Default
Select Default to change to the default settings.
File List
Select File List to view a list of the files that you can select.
Help
Select Help to display help information that tells you how to use this action
window.
ΓòÉΓòÉΓòÉ 4.1.3. 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:
o Source view, to set the breakpoint at a specific statement
o Disassembly view, to set the breakpoint at a specific machine instruction
o Mixed view, to set the breakpoint at a specific machine instruction. (The
lines of source code displayed in the Mixed view are treated as comment lines
only.)
The prefix area turns red indicating that the breakpoint has been set.
ΓòÉΓòÉΓòÉ 4.1.4. Clearing 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 program view windows. The color
changes indicating that the breakpoint has been cleared. If the prefix area
turns grey instead, double-click again to make sure the breakpoint is cleared.
ΓòÉΓòÉΓòÉ 4.1.5. Executable ΓòÉΓòÉΓòÉ
If you are setting a breakpoint, 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
3. Type the name of the executable in the entry field.
ΓòÉΓòÉΓòÉ 4.1.6. Source ΓòÉΓòÉΓòÉ
If you are setting a line breakpoint, 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
3. Type the name of the source in the entry field.
ΓòÉΓòÉΓòÉ 4.1.7. Line Number ΓòÉΓòÉΓòÉ
To set a line breakpoint, type the line number in the line number entry field.
The breakpoint will be set on the line number you selected.
ΓòÉΓòÉΓòÉ 4.1.8. Address Choice ΓòÉΓòÉΓòÉ
Select the Address choice to stop the execution of your program at the address
you select. When you select Address, the Address Breakpoint action window is
displayed.
ΓòÉΓòÉΓòÉ 4.2. Setting an Address Breakpoint ΓòÉΓòÉΓòÉ
Use the Address action 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 (hex) entry field.
A1FCC
For a description of types of data you can enter in the action window,
double-click on one of the following topics:
o Expression
o Thread
o Every
o From
o To
Click on the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 4.2.1. 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 action window is displayed.
ΓòÉΓòÉΓòÉ 4.3. Setting a Function Breakpoint ΓòÉΓòÉΓòÉ
Use the Function action window to set a function breakpoint. Type the name of
the function. If a function is overloaded, then a window is displayed 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 action window,
double-click on one of the following topics:
o Executable
o Source
o Function
o Expression
o Thread
o Every
o From
o To.
All executables
Enable this option if you want to search all the executable files for the
function.
Note: To search for a function in a particular executable file, disable this
option and type in the name of the executable file in the Executable entry
field and the name of the source file in the Source entry field
Debug data only
Enable this option if you want to search only the object files that contain
debug data.
Case Sensitive
Enable this option if you want to search for the string exactly as typed.
Disable this option if you want to search for both uppercase and lowercase
characters.
Function Example:
To set a function breakpoint for the function my_func, you would 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.
Click on the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 4.3.1. Load Occurrence Choice ΓòÉΓòÉΓòÉ
Select the Load Occurrence choice to stop the execution of your program after
the DLL that you specify is loaded. When you select Load Occurrence, the Load
Occurrence Breakpoint action window is displayed.
ΓòÉΓòÉΓòÉ 4.4. Setting a Load Occurrence Breakpoint ΓòÉΓòÉΓòÉ
To set a load occurrence breakpoint, type the name of the DLL. Execution stops
when the DLL is loaded.
Load Occurrence Example:
You would type the following in the DLL file name entry field to set a load
occurrence breakpoint when MY.DLL is loaded:
MY.DLL
For a description of types of data you can enter in the action window,
double-click on one of the following topics:
o Thread
o Every
o From
o To
Click on the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 4.4.1. Change Address Choice ΓòÉΓòÉΓòÉ
Select the Change address choice to stop the execution of your program after
the contents of memory at a given address changes. When you select Change
address, the Change Address Breakpoint action window is displayed.
ΓòÉΓòÉΓòÉ 4.5. Setting a Change Address Breakpoint ΓòÉΓòÉΓòÉ
To set a change address breakpoint, type a hexadecimal address and select the
range of bytes. The range of bytes can be one of the numbers:1, 2, or 4. The
2-byte range must be aligned on a word boundary and the 4-byte range must be
aligned on a doubleword boundary.
Execution stops when the specified range of memory changes.
Change - Address Example:
You would type the following in the Address (hex) entry field to set a change -
address breakpoint starting at address 000A1FCC.
A1FCC
Warning: If you set a change address breakpoint that is on the stack, you
should remove the breakpoint prior to leaving the routine associated with the
breakpoint. Otherwise, when you return from the routine, the routine's stack
frame will be removed from the stack leaving the breakpoint intact. Any other
routine that gets loaded on the stack will then contain the breakpoint.
For a description of types of data you can enter in the action window,
double-click on one of the following topics:
o Thread
o Every
o From
o To
Click on the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 4.5.1. File ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 4.5.2. Function ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 4.5.3. Expression ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 4.5.4. Thread ΓòÉΓòÉΓòÉ
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.
ΓòÉΓòÉΓòÉ 4.5.5. Every ΓòÉΓòÉΓòÉ
This field is used for location breakpoints only. Type in a whole integer
number to indicate how often the breakpoint should be activated within the From
and To range.
ΓòÉΓòÉΓòÉ 4.5.6. From ΓòÉΓòÉΓòÉ
This field is used for location breakpoints only. Type in a whole integer
number to start activating the breakpoint the nth time the location is
encountered.
ΓòÉΓòÉΓòÉ 4.5.7. To ΓòÉΓòÉΓòÉ
This field is used for location breakpoints only. Type in a whole integer
number to stop activating the breakpoint after the nth time the location is
encountered.
ΓòÉΓòÉΓòÉ 4.5.8. Push Buttons ΓòÉΓòÉΓòÉ
OK
Select OK to set the breakpoint and close this action window.
Cancel
Select Cancel to close this action window.
Help
Select Help to display help information that tells you how to use this action
window.
Default
Select Default to change the current window information to the debugger
defaults.
ΓòÉΓòÉΓòÉ 4.5.9. List Choice ΓòÉΓòÉΓòÉ
Select the List choice to list the breakpoints that you have set. When you
select List, the List Breakpoint action window is displayed.
ΓòÉΓòÉΓòÉ 4.5.10. 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 is displayed for verification
that you want to delete all the breakpoints.
ΓòÉΓòÉΓòÉ 4.6. List Action Window ΓòÉΓòÉΓòÉ
Use the List action window to display a list of the breakpoints that have been
set. The following information is also provided for each breakpoint.
o The enablement state
o The type of breakpoint
o The position of the breakpoint
o The conditions under which the breakpoint is activated.
Push Buttons Summary
OK
Select OK to accept the information you have entered and close this action
window.
Delete
Remove the highlighted breakpoint.
Delete all
Remove all of the breakpoints displayed in the action 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 action window.
ΓòÉΓòÉΓòÉ 4.6.1. Modify ΓòÉΓòÉΓòÉ
Use the Modify push button 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 push button.
The page of notebook is turned to the appropriate type of breakpoint.
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 action window. If you want
to make other changes, select Set to accept the changes and keep the action
window open.
ΓòÉΓòÉΓòÉ 4.6.2. Sort Action Window ΓòÉΓòÉΓòÉ
Use the Sort action window to sort the breakpoints that have been set in your
program.
Breakpoints can be sorted according to the following categories:
o Type
o Executable
o Source
o File
o Function
o Line number
o Address
o Status
o Thread
o Condition
o From
o To
o Every.
Select the category you want and click on the appropriate push button to
continue.
ΓòÉΓòÉΓòÉ 4.7. Windows Menu ΓòÉΓòÉΓòÉ
Select choices from the Windows menu to view other debugger windows.
Menu Summary
Local variables
Display the local variables for the program's current function.
Registers
Monitor registers and flags for a particular component or thread.
Stack
Monitor the call chain stack for a particular thread.
Program monitor
Create or focus the Program Monitor window.
Storage
Monitor the storage in your program.
Window Analysis
Display the windows of the program in a three dimensional view.
Message queue monitor
Display the PM messages associated with a PM application.
Inheritance
Display the class hierarchy of a C++ program.
ΓòÉΓòÉΓòÉ 4.8. Run Menu ΓòÉΓòÉΓòÉ
Select choices from the Run menu to execute your program, halt execution, or
enable or disable threads.
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 termination of the program.
Menu Summary
Thread enabled
Enable or disable threads.
Run
Execute the program from the current line until a breakpoint is encountered
or the program terminates.
Halt
Interrupt the program you are debugging.
ΓòÉΓòÉΓòÉ 4.8.1. 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 √
symbol appears beside the Thread enabled choice. When threads are not enabled,
a √ symbol is not displayed and the highlighted thread is not executed when the
program runs.
ΓòÉΓòÉΓòÉ 4.8.2. Storage Conditional 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 clicking on the arrow.
New Open a new storage window.
storage address Locate a storage window that is already open.
ΓòÉΓòÉΓòÉ 4.8.3. New Choice ΓòÉΓòÉΓòÉ
Select the New choice to open a new storage window.
ΓòÉΓòÉΓòÉ 4.8.4. Storage Address Choice ΓòÉΓòÉΓòÉ
Select the storage address choice to open an existing storage window.
ΓòÉΓòÉΓòÉ 4.8.5. 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 entered. 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 entered, the window scrolls to the appropriate storage
location.
ΓòÉΓòÉΓòÉ 4.8.6. Storage Data Displayed ΓòÉΓòÉΓòÉ
The following information can be displayed in the Storage window:
o Fields for the displayed addresses. You can select one of the following
memory models for the addresses that are displayed:
- 16:16 (segmented) memory addresses
- Flat memory model addresses
- Both segmented and flat memory model addresses.
o Fields for the data storage contents. The number of fields displayed and
their display characteristics depend on the storage style you select. Storage
can be displayed as hex, integer, float, or ASCII.
o Titles for the displayed addresses and storage content fields.
ΓòÉΓòÉΓòÉ 4.8.7. Registers Choice ΓòÉΓòÉΓòÉ
Select the Registers choice to display the processor and math coprocessor
registers.
ΓòÉΓòÉΓòÉ 4.8.8. Stack Choice ΓòÉΓòÉΓòÉ
Select the Stack choice to list the active functions or procedures for a
particular thread.
One call stack exists for each thread. The Stack window displays the call stack
information for a given thread. The functions are displayed in the order that
they were called.
The Stack window contains a line of data for each function call. Each line
contains the function name of the procedure or function followed by the data
you select in the Display Style action window. You can display the following
information for call stack items:
o Entry number
o Function
o Source
o Recursion level.
ΓòÉΓòÉΓòÉ 4.8.9. Local Variables Choice ΓòÉΓòÉΓòÉ
Select the Local variables choice to display the local variables (static,
automatic, and parameters) for the current function. The local variables are
displayed in the Local Variable Monitor window.
ΓòÉΓòÉΓòÉ 4.9. Options Menu ΓòÉΓòÉΓòÉ
Select choices from the Options menu to control the debugger windows.
Menu Summary
Window settings
Control how the items in the Debug Session Control window are displayed.
Session settings
Display action windows to control the debugger windows.
Profile
Change the location of the debugger restart information. file and save or
delete restart information for programs that you have debugged.
ΓòÉΓòÉΓòÉ 4.9.1. Window Settings Choice ΓòÉΓòÉΓòÉ
Select choices from the Window settings choice to modify the characteristics of
the Debug Session Control window.
Menu Summary
Only components with debug data
Display components that contain debug data.
Sort threads
Sort the threads in the numerical order.
Sort components
Sort the components in alphabetical order.
Titles on
Enable or disable the titles from being displayed in the window.
Fonts
Select the font you want to use for the text displayed in the active window.
ΓòÉΓòÉΓòÉ 4.9.2. Only Components with Debug Data ΓòÉΓòÉΓòÉ
You can specify which components are displayed in the Components box. If this
option is enabled, a √ symbol appears beside the Only components with debug
data menu choice and only components containing debug information are listed.
If it is not, all components are listed.
ΓòÉΓòÉΓòÉ 4.9.3. Session Settings Cascading Choice ΓòÉΓòÉΓòÉ
Select choices from the Session settings cascading choice to set various
debugger options that control how the debugger windows are displayed. These
settings affect the behavior of the debugger and remain in effect for the
duration of the debugging session.
Menu Summary
Source window 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.
PM debugging mode
Set parameters that control how the debugger handles messages passed within
the debugger and between other PM applications.
Default data representation
Select how you want your data displayed in monitor windows.
Animation rate
Specify the rate at which you can automatically execute lines of code in your
program.
Initial window placement
Select the initial position and size of the debugger windows.
ΓòÉΓòÉΓòÉ 4.9.4. Sort Threads ΓòÉΓòÉΓòÉ
You can specify to sort the threads in numerical order from the Threads box. If
this option is enabled, a √ symbol appears beside the sort threads choice and
threads are sorted numerically.
ΓòÉΓòÉΓòÉ 4.9.5. Sort Components ΓòÉΓòÉΓòÉ
You can specify to sort the components in alphabetical order from the
Components box. If this option is enabled, a √ symbol appears beside the Sort
components choice and components are sorted alphabetically.
ΓòÉΓòÉΓòÉ 4.9.6. Titles On ΓòÉΓòÉΓòÉ
You can specify to display the titles or to turn the titles off in the Debug
Session Control window. The titles are Threads and Components. If this option
is enabled, a √ symbol appears beside the Titles on choice and titles are
displayed.
ΓòÉΓòÉΓòÉ 4.9.7. PM Debugging Mode Choice ΓòÉΓòÉΓòÉ
The PM Debugging Mode choice allows to set the debugging mode to asynchronous
or synchronous, and control the interaction between the program windows and PM,
while the application has stopped executing.
When you select PM debugging mode, the PM Debugging Mode action window is
displayed.
ΓòÉΓòÉΓòÉ 4.9.8. Asynchronous ΓòÉΓòÉΓòÉ
When the debugger is operating in asynchronous mode and the program you are
debugging is stopped, the debugger immediately responds to messages that have
been sent to the program being debugged on this program's behalf. The debugger
answers the messages with a simple default response, freeing up other processes
to operate while the debugger has control. When you are running the debugger in
asynchronous mode, other PM applications running in the system are not blocked
when the program being debugged stops.
Warning: Do not operate the debugger in asynchronous mode if the PM application
that you are debugging requires the appropriate response to its messages. For
example, a dynamic data exchange (DDE) message would require the appropriate
response.
ΓòÉΓòÉΓòÉ 4.9.9. Synchronous ΓòÉΓòÉΓòÉ
When the debugger is operating in synchronous mode, the messages that are
passed between PM applications are answered by their target applications in the
order that they were created. The messages that are passed within the debugger
take priority over any other messages that are passed in the system.
When the program being debugged is stopped and the debugger is in synchronous
mode, other PM applications are locked, leaving the debugger free to operate.
In synchronous mode, you will not be able to use any other PM applications that
are running.
ΓòÉΓòÉΓòÉ 4.9.10. Default Data Representation Choice ΓòÉΓòÉΓòÉ
When you select Default data representation, a cascaded menu is displayed with
language choices. This lets you change the default representation for a data
type in the language that you select.
ΓòÉΓòÉΓòÉ 4.9.11. 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 action window is
displayed.
ΓòÉΓòÉΓòÉ 4.9.12. 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 the System choice, the Default Representation action window is
displayed.
ΓòÉΓòÉΓòÉ 4.10. Default Representation Action Window ΓòÉΓòÉΓòÉ
Use the Default Representation action window to select the default data
representation.
Select the appropriate radio button(s) for the data type you want.
Select the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 4.11. Animation Rate Action Window ΓòÉΓòÉΓòÉ
When you select Animate from the Run menu, the debugger automatically does Step
over commands to execute your statements one line at a time. The animation rate
specifies the rate at which the debugger is automatically executed.
To change the speed at which single lines of code are automatically executed:
1. Set the speed of execution by positioning the slider between the slow and
fast limits or by entering a number in the entry field.
The numbers (1 to 20) are for reference purposes only. The true speed of
animation depends on the:
o Processor speed
o Number of open windows
o The types of instructions being stepped over.
2. Select the Save session settings check box to save action window settings
that you saved for the next debugging session. check box to save your
selection for the next debugging session.
3. Select the appropriate push button to continue.
To stop the animation, select SysRq (Alt + Print Screen).
ΓòÉΓòÉΓòÉ 4.11.1. PM Debugging Mode Action Window ΓòÉΓòÉΓòÉ
Use the PM Debugging Mode action window to set the debugging mode to
asynchronous or synchronous, and control the interaction between the program
windows and PM, while the application has stopped executing.
The PM system is a message-based system. As program events are encountered by
PM programs, the programs communicate with each other by passing messages and
by receiving user input through input messages. When a PM program encounters an
enabled breakpoint, the input queue can become blocked and dependent program
events, or processes, can also become blocked as a result. For example, the
input queue can become blocked when your program is halted at a breakpoint that
has been triggered by an input event.
The debugger provides two modes of operation by which PM messages can be
processed while the debugger has control. These two modes are:
o Synchronous
o Asynchronous.
After you have selected the parameters you want from this action window, click
on the appropriate push buttons.
Mode
Select the PM Debugging mode you want: either Synchronous or Asynchronous.
Invalid area color
Select the color that is to be used to repaint the invalid area of an
application window. Depending on the original color of the application window,
certain colors will be more appropriate for repainting. The color you choose is
used when you select the Color invalid areas, Restore, or Repaint options.
No repainting
None of the invalid areas of the window are repainted.
Color invalid areas
The Color invalid areas option works only in asynchronous mode. This option
paints the invalid areas in a solid fill color. The color can be changed by
selecting a different color from the Invalid area color combination box.
Restore
The Restore option works only in asynchronous mode. This option restores the
application window with the last available image of the window. The image that
you can regain consists of the last available image when a step or run command
ended, minus any parts of the window that were covered when the step or run
command ended. The parts of the window that were covered are filled with the
solid color you chose from the Invalid area color combination box.
Repaint
Restores that application window with the last available image. The image that
you can regain consists of the last available image when a step or run command
ended minus any parts of the window that were covered when the step or run
command ended. The parts of the window that were covered are filled with the
solid color you chose from the Invalid area color combination box.
The Repaint option differs from the Restore option. It interrupts the normal
debugging process of the window as follows:
o The program windows will not receive any screen interaction messages while
the application is stopped. For example, the application will not receive any
of the WM_MOUSEMOVE or WM_PAINT messages that were generated while the
application was stopped.
o An extra WM_PAINT message is generated for the program windows when execution
resumes.
Note: The program windows might not process the WM_PAINT message depending
on where the breakpoints are set or on which step or run command was
selected.
Save settings
Select Save settings to save your selections for the next debugging session.
ΓòÉΓòÉΓòÉ 4.11.2. Debug Session Control Choice ΓòÉΓòÉΓòÉ
Select the Debug session control choice to display the Debug Session Control
window.
ΓòÉΓòÉΓòÉ 4.12. Help Menu ΓòÉΓòÉΓòÉ
Select choices from the Help menu to complement the online help information
that you can get for the debugger when you press F1 or select the Help push
button.
Menu Summary
Help index
An alphabetical index of all available debugger help topics.
General help
Help information for the active window.
Using help
How to use the IBM C/C++ Debugger help facility.
ΓòÉΓòÉΓòÉ 4.13. Help Menu ΓòÉΓòÉΓòÉ
Select choices from the Help menu to complement the online help information
that you can get for the debugger when you press F1 or select the Help push
button.
Menu Summary
Help index
An alphabetical index of all available debugger help topics.
General help
Help information for the active window.
Using help
How to use the IBM C/C++ Debugger help facility.
Tutorial
Display the debugger tutorial.
ΓòÉΓòÉΓòÉ 4.13.1. Using help ΓòÉΓòÉΓòÉ
Select the Using help choice to display online help information about the OS/2
help facility.
ΓòÉΓòÉΓòÉ 4.13.2. General help ΓòÉΓòÉΓòÉ
Select the General help choice to display online help for the active debugger
window. The online help panel displayed is the same panel that is displayed
when you place your cursor inside the window and press F1.
ΓòÉΓòÉΓòÉ 4.13.3. Tutorial ΓòÉΓòÉΓòÉ
Select the Tutorial choice to display the online tutorial. This tutorial
guides you through many of the debugger functions, including the new C++
features.
ΓòÉΓòÉΓòÉ 4.13.4. 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 program view 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.13.5. Help index ΓòÉΓòÉΓòÉ
Select the Index choice display an alphabetical list of index topics for the
debugger. Use the Search choice provided with the online help facility to
locate topics in the index.
ΓòÉΓòÉΓòÉ 5. Program View Windows ΓòÉΓòÉΓòÉ
The program view windows display a view of the program you are debugging. The
types of program view windows that are displayed are as follows:
o Source
o Disassembly
o Mixed
These program views differ in the way they display the program code. Although
only one program view is initially displayed, you can display additional
program views at any time. Each view is displayed in its own window.
Executable statements are displayed in blue. Comments and other non-executable
lines are displayed in black. You can set breakpoints or execute your program
only on executable lines.
Source
The Source window displays the source code for the component you have selected.
It displays the source file as it was originally written.
The prefix area of each line displays the line number.
When you start the debugger, the Source window is displayed if the source file
is available. If it is not, the Source Filename action window is displayed.
(You can change the new view priority order of the views using the Source
Window Properties action window, which determines which view is displayed.)
Disassembly
The Disassembly window displays your program as assembler instructions without
symbolic information.
The prefix area of each line displays the address of the instruction.
Mixed
The Mixed window displays each source statement followed by the assembler
instructions that the particular source statement generates.
The Mixed window is displayed as follows:
o Each source line is prefixed with its line number as in the Source window.
o Each disassembled line is prefixed with an address as in the Disassembly
view.
o Source comment lines are included in the display.
o The lines of source code are treated as comments within the lines of
disassembly code. You can only set breakpoints or execute your program on
lines of disassembly code.
o The Mixed view cannot be opened if the source code is not available.
The Source, Disassembly, and Mixed windows offer the same menu choices, except
that:
o The Variable menu is not available in the Disassembly program view window.
o The Change source file choice is not available from the File View menu of
the Disassembly program view window.
Basic tasks from the program view windows include:
Set line breakpoints Double-click on the prefix area of any line to set a
simple line breakpoint. For more information, see Setting
Breakpoints.
Single Step your program Press mouse button two to single step your program.
This performs a step over command. See below for information on the
different step commands.
Monitor and modify variables Double-click the mouse on any variable name in
your program to display that variable in a monitor window. Drag the
mouse over an expression, and then double-click on the highlighted
expression, to display the expression in a monitor window.
Select Local Variables from the Windows menu to display a monitor
window of all the Local Variables in your program.
The four monitors for variables and expressions are:
o Program Monitor
o Private Monitor
o Data Popup
o Local Variables Monitor
See also Monitor Properties for how to change which monitor is used
to display variables and expressions.
Menu Bar Summary
File
Start and end the debugger and control the program views.
Edit
Edit text and search for strings in the text.
Breakpoints
Set and manipulate breakpoints in your program.
Variable
Display the contents of program variables and expressions.
Windows
Select other windows for viewing.
Run
Execute your program in several ways.
Options
Change the parameters that control how your program is displayed and
executed.
Help
Online help information that compliments the information you get when you
press F1 or select the Help push button.
Title Bar Buttons Summary
The following buttons have been provided in the title bar of the program view
windows for easier 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 debug information is not
available (for example, library and system routines), and steps into any
function for which debugging information is available.
Step return automatically executes the lines of code up to, and
including, the return statement of the current function.
Run runs the program, executing all enabled threads. Control returns to
the debugger when:
o The program terminates
o Execution stops at an enabled breakpoint.
View changes the current view to one of the other views, depending on
the view priority.
Stack displays the Stack window.
Register displays the Register window.
Program Monitor displays the Program Monitor window.
Storage displays a new Storage window.
Debug Session Control displays the Debug Session Control window.
ΓòÉΓòÉΓòÉ 5.1. File Menu ΓòÉΓòÉΓòÉ
Select choices from the File menu of the program view 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
View
Select one of the three program view windows (Source, Disassembly, or Mixed).
Locate function
Open a program view window to a particular function.
Open new source
Display a new source file.
Where
Open a program view containing the next line to be executed.
Startup
Start the program you want to debug after terminating the current program.
Restart
Restart the current debugging session.
Close debug
Close the debugging session.
ΓòÉΓòÉΓòÉ 5.1.1. View Cascading Choice ΓòÉΓòÉΓòÉ
Select the View cascading choice to select a different view of your program or
change the current window to a notebook format.
Each type of view can be opened only once for a program component; program
views are thread-specific. Any lines that are highlighted in the existing view
are also highlighted in the new view, and any breakpoints highlighted in the
prefix area of the existing view are also shown in the new view. You can view
the program as:
o Source
o Disassembly
o Mixed.
Note: The Source and Mixed views can be displayed in a notebook format if they
have include files that contain executable statements.
You can enable or disable the Notebook option by toggling the enabled choice in
the Notebook option box. When the check mark is displayed, it is enabled and
the views will be displayed in notebook format. When the check mark is not
displayed, it is disabled. The default is to have the option enabled.
The Change source file choice lets you replace the source you are currently
debugging with the source code in another location or with a different name.
ΓòÉΓòÉΓòÉ 5.1.2. Notebook Choice ΓòÉΓòÉΓòÉ
Enable the Notebook choice to display the program view windows in notebook
format.
Note: If you have include files in your program, the Notebook choice is
enabled by default.
You can enable or disable the Notebook option by selecting the Notebook choice.
When it is enabled, a √ symbol is displayed. If it is disabled, a √ symbol is
not displayed.
The Source and Mixed views can be displayed in a notebook format. The
Disassembly view cannot be displayed in a notebook format.
ΓòÉΓòÉΓòÉ 5.1.3. 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 appears with the Debug Session Control window when the debugging session
is started. Otherwise, the Disassembly view appears.
You can change the order of program views that are opened by setting the source
window properties in the Source Window Properties action window.)
ΓòÉΓòÉΓòÉ 5.1.4. 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 source file choice in the File menu are not
available.
You can change the order of program views that are opened by setting the source
window properties in the Source Window Properties action window.)
ΓòÉΓòÉΓòÉ 5.1.5. Mixed Choice ΓòÉΓòÉΓòÉ
Select the Mixed choice to display each source statement followed by the
assembler instructions that the particular source statement generates.
You can change the order of program view windows that are opened by setting the
source window properties in the Source Window Properties action window.)
The Mixed view works as follows:
o Each source line is prefixed with its line number as in the Source window.
o Each disassembled line is prefixed with an address as in the Disassembly
view.
o Source comment lines are included in the display.
o The lines of source code are treated as comments within the lines of
disassembly code. The execution of the program and breakpoints only relate to
the lines of disassembly code.
o The Mixed view cannot be opened if the source code is not available.
ΓòÉΓòÉΓòÉ 5.1.6. Inheritance Choice ΓòÉΓòÉΓòÉ
Select the Inheritance choice to view the class hierarchy of a C++ program.
ΓòÉΓòÉΓòÉ 5.1.7. Locate Function Choice ΓòÉΓòÉΓòÉ
Select the Locate function choice to open a program view window to a particular
function. When you select Locate function, the Locate Function action window
is displayed.
ΓòÉΓòÉΓòÉ 5.2. Locate Function Action Window ΓòÉΓòÉΓòÉ
Use the Locate Function action window to open a program view window to a
particular function.
To use the Locate Function action window:
1. Type the name of the function you want to search for in the Function entry
field.
2. Click on the appropriate push button to continue.
All executables
Enable this option if you want to search all the executable files for the
function.
The debugger searches each object file for global functions that match the
function name specified. If a global function is found in an object file, the
object file is searched for that static function.
Note: To search for a function in a specific executable file, disable this
option and type the name of the executable file in the Executable entry field
and type the name of the source file in the Source entry field.
Debug data only
Enable this option if you want to search only the object files that contain
debugging information.
Case Sensitive
Enable this option if you want to search for the string exactly as typed.
Disable this option if you want to search for both uppercase and lowercase
characters.
ΓòÉΓòÉΓòÉ 5.3. Overloaded Action Window ΓòÉΓòÉΓòÉ
Use the Overloaded action window to select the appropriate function. This
window is displayed when a you have an overloaded function.
To use the Overloaded action window:
1. Select the name of the function you want from the list.
2. Click on the appropriate push button to continue.
Signature
Displays the function name and any parameters that the function may have.
ΓòÉΓòÉΓòÉ 5.3.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 action window is displayed.
ΓòÉΓòÉΓòÉ 5.4. Open New Source Action Window ΓòÉΓòÉΓòÉ
Use the Open New Source window to open a new source file. To use the Open new
source action window:
1. Type the name of the executable file in the Executable entry field. The
source files for the executable file will be displayed in the Source entry
field.
2. Select the object file you want to open the source for from the Source
entry field. For example, if you want to look for the source used to
compile A123.OBJ, enter A123.
3. Click on the appropriate push button to continue.
All executables
Enable this option if you want to search all the executable files. Disable this
option if you want to search only one executable file.
Debug data only
Enable this option if you want to search only the source files that contain
debug information.
ΓòÉΓòÉΓòÉ 5.4.1. Where Choice ΓòÉΓòÉΓòÉ
Select the Where choice to locate the next line to be executed in the thread.
ΓòÉΓòÉΓòÉ 5.4.2. Change Source File Choice ΓòÉΓòÉΓòÉ
Select the Change source 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 information.
ΓòÉΓòÉΓòÉ 5.4.3. Understanding the 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 where the object file was compiled.
2. The path where the executable file is located.
3. The path defined by the PMDPATH environment variable, if specified.
4. The current path.
5. The path defined in the INCLUDE environment variable.
Using the Environment Variables
The debugger uses two environment variables: PMDPATH and PMDOVERRIDE.
To set the PMDPATH environment variable, do the following:
Set PMDPATH=path;path
where path is the location of your source files.
To override the normal search order, use the PMDOVERRIDE environment variable:
Set PMDOVERRIDE=path;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.
For information about how the debugger searches for source files, refer to
understanding the search information.
When you select the Change source file choice, the Change Source File action
window is displayed.
ΓòÉΓòÉΓòÉ 5.4.4. Restart Choice ΓòÉΓòÉΓòÉ
Select the Restart choice to terminate the current program and start the
debugging session using restart information.
ΓòÉΓòÉΓòÉ 5.4.5. Close Debug Choice ΓòÉΓòÉΓòÉ
Select the Close debug choice to close your current debugging session. The
Close Debug message box prompts you to confirm that you want to end the
debugging session.
ΓòÉΓòÉΓòÉ 5.5. Edit Menu ΓòÉΓòÉΓòÉ
Select choices from the Edit menu to search for strings of text or for the next
occurrence of a string.
Menu Summary
Copy
Copy text into the clipboard.
Search
Search for strings of text in the active program view.
Find next
Find the next occurrence of a string.
ΓòÉΓòÉΓòÉ 5.5.1. Search Choice ΓòÉΓòÉΓòÉ
Select the Search choice to search for a string of text in the active program
view. You can search for simple text strings that do not use wildcards.
When you select Search, the Search action window appears, prompting you for the
text string you want to find. If you are searching in the same program
component, the default text string is the string you entered the last time you
completed the Search choice for this component.
ΓòÉΓòÉΓòÉ 5.5.2. Find Next Choice ΓòÉΓòÉΓòÉ
Select the Find next choice to search for the next occurrence of a string of
text. The last text string that was typed in the Search action window for this
component is used.
ΓòÉΓòÉΓòÉ 5.6. Search Action Window ΓòÉΓòÉΓòÉ
To use the Search action window to search for a text string:
1. Type the text string you want to search for in the Enter Search String
entry field.
2. Click on the appropriate push button to continue.
Enter Search String
Type the text string you want to search for.
The search string can have:
o Both alphabetic and numeric characters
o A maximum of 251 characters
o Both uppercase and lowercase characters.
Case Sensitive
Enable this option if you want to search for the string exactly as typed.
Disable this option if you want to search for both uppercase and lowercase
characters.
ΓòÉΓòÉΓòÉ 5.6.1. Change Source File Action Window ΓòÉΓòÉΓòÉ
Use the Change Source File action window from the File View cascading choice
in the program view 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 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, see
understanding the search information.
To replace the file name:
1. Type the new path name or file name in the New File entry field.
2. Click on the appropriate push button to continue.
New File
The path name and file name of the program you want to replace with the program
you are currently debugging.
ΓòÉΓòÉΓòÉ 5.6.2. Push Buttons ΓòÉΓòÉΓòÉ
OK
Click on OK to accept the information you have entered and to close this
action window.
Apply
Click on Apply to substitute the file and leave this action window open.
Cancel
Click on Cancel to close this action window.
File List
Click on File List to view a list of the files that you can select.
Help
Click on Help to display help information that tells you how to use this
action window.
ΓòÉΓòÉΓòÉ 5.7. Variable Menu ΓòÉΓòÉΓòÉ
Select choices from the Variable menu to display the variables and expressions.
You can select the variables or expressions you want to display:
o Using the mouse
o Using the mouse and the Monitor Expression action window
o Using the keyboard.
You must select an expression with:
o A valid operand type
o A valid operator
o A valid typecasting operation
1. Bit fields are supported for C/C++ compiled code only. You can display and
update bit fields, but you cannot use them in expressions.
2. You cannot look at variables that have been defined using the define
preprocessor directive.
For more information about manipulating the variable monitors, double-click on
Using the data popup and monitor windows.
Menu Summary
Popup expression
Monitors the highlighted variable or expression in a data popup window.
Add to private monitor
Adds the highlighted variable or expression to the Private Monitor window.
Add to program monitor
Adds the highlighted variable or expression to the Program Monitor window.
Monitor expression
Type the name of the variable or expression you want to monitor.
ΓòÉΓòÉΓòÉ 5.7.1. Popup Expression Choice ΓòÉΓòÉΓòÉ
Select the Popup expression choice to monitor the highlighted variable or
expression in a data popup window.
ΓòÉΓòÉΓòÉ 5.7.2. Add to Private Monitor Choice ΓòÉΓòÉΓòÉ
Select the Add to private monitor choice to add the highlighted variable or
expression to the Private Monitor window.
To use the Add to private monitor choice:
1. Highlight the variable or expression you want to monitor by clicking on the
variable or dragging the mouse across the variable or expression while
holding down mouse button one.
2. Select the Add to private monitor choice.
The variable or expression you highlighted is added to the Private Monitor
window.
ΓòÉΓòÉΓòÉ 5.7.3. Add to Program Monitor Choice ΓòÉΓòÉΓòÉ
Select the Add to program monitor choice to add the highlighted variable or
expression to the Program Monitor window.
To use the Add to program monitor choice:
1. Highlight the variable or expression you want to monitor by clicking on the
variable or dragging the mouse across the variable or expression while
holding down mouse button one.
2. Select the Add to program monitor choice.
The variable or expression you highlighted is added to the Program Monitor
window.
ΓòÉΓòÉΓòÉ 5.7.4. Monitor Expression Choice ΓòÉΓòÉΓòÉ
Select the Monitor expression choice if you want to use the keyboard to type a
variable or any expression you want to monitor.
When you select Monitor expression, the Monitor Expression action window is
displayed.
ΓòÉΓòÉΓòÉ 5.7.5. Selecting Variables with the Mouse ΓòÉΓòÉΓòÉ
To select a variable or expression for display using the mouse, use one of the
following methods:
o Point to any character within the variable name and double-click mouse button
one.
o Highlight the variable name or expression by dragging the mouse while holding
down mouse button one, and then double-click mouse button one anywhere within
the name.
o Highlight the variable name or expression and select Add to program monitor
or Add to private monitor from the Variable menu.
ΓòÉΓòÉΓòÉ 5.7.6. Selecting Variables with the Mouse and Monitor Expression ΓòÉΓòÉΓòÉ
To monitor a variable or an expression using the mouse and the Monitor
Expression action window, use one of the following methods:
For a single variable name:
1. Highlight the variable name using either of the following methods:
o Point to the variable name and click mouse button one.
o Highlight the variable by placing the mouse pointer on the beginning of
the variable and dragging the mouse across the entire variable while
pressing mouse button one.
2. Select Monitor expression from the Variable menu.
The Monitor Expression action window appears, and the highlighted variable
name is placed 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 action window appears, and the highlighted
expression name is placed in the Expression entry field.
Select the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 5.7.7. 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
action window appears.
2. Type the name of the variable or expression in the Expression entry field.
3. If you want to change the defaults that control how a variable or
expression is displayed in a monitor or data popup window:
a. Select Monitor Properties push button to display the Monitor Properties
action window.
b. Select OK to close the Monitor Properties action window.
4. Select OK to close the Monitor Expression action window.
ΓòÉΓòÉΓòÉ 5.7.8. Using the Variable Monitors ΓòÉΓòÉΓòÉ
After you have selected a variable or expression for monitoring, you can:
o Use the data manipulation icons
o Use the keyboard to move around a monitor
o Enable or disable monitors
o Display context
o Change the value of a variable
o Change the representation of a variable or expression.
ΓòÉΓòÉΓòÉ 5.7.9. Keyboard Sequences ΓòÉΓòÉΓòÉ
You can use various combinations of keys to move around the monitor windows.
The key combinations you can use and the function 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
ΓòÉΓòÉΓòÉ 5.7.10. Enabling and Disabling Monitors ΓòÉΓòÉΓòÉ
You can enable or disable monitors. In the enabled state, when the debugger
stops, the displayed value in the monitor is changed to reflect the actual
value in storage. A disabled monitor suspends this updating, and reflects the
value the debugged program held when the monitor was disabled. When a monitor
is disabled, the data entry field is greyed and you cannot change the value
displayed. When a disabled monitor is enabled, the current program values are
displayed.
ΓòÉΓòÉΓòÉ 5.7.11. Displaying Context ΓòÉΓòÉΓòÉ
Monitors display the data value in their context. The context consists of:
o Source
o File
o line
o Thread.
ΓòÉΓòÉΓòÉ 5.7.12. Changing the Value of a Variable ΓòÉΓòÉΓòÉ
You can change the value of a variable or expression that is displayed in a
monitor. To change the value:
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).
ΓòÉΓòÉΓòÉ 5.7.13. Changing the Representation ΓòÉΓòÉΓòÉ
To change the representation:
1. Select the expression.
2. Select an alternate representation from the Options Representation
choice. The new representation takes effect immediately.
You change the representation of the value displayed in a monitor to:
o Hexadecimal
o Decimal
o String
o Character
o Floating-point
o Hexadecimal pointer
o Decimal pointer
o Array.
Note: The representation you can select varies with the data type being
displayed.
ΓòÉΓòÉΓòÉ 5.7.14. Supported Expression Operands ΓòÉΓòÉΓòÉ
You can monitor an expression that uses the following types of operands only:
Variable A variable
Constant The constant can be one of the following types:
o A fixed or floating-point constant
Note: The largest floating-point constant is 1.8E308. The smallest
floating-point number supported is 2.23E-308.
o A string constant (enclosed in " ")
o A character constant (enclosed in ' ')
o 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 format
0x0000:0x0000.
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 appear 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 is displayed to the right of
the value. If the value of the variable matches one of the enumerated types,
the comment will contain the name of the first enumerated type that matches the
variable's value. If the length of the enumerated name will not fit in the
monitor, the contents are displayed as an empty field.
The comment (empty or not) lets you distinquish between a valid enumerated
value and an invalid value. An invalid value will 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 will be updated.
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.
ΓòÉΓòÉΓòÉ 5.7.15. Supported Expression Operators ΓòÉΓòÉΓòÉ
You can monitor an expression that uses the following types of operators only:
Operator Coded as
Complement -a
Bitwise negate ~a
Logical negation !a
Dereference *a
Address of &a
Multiply a * b
Divide a / b
Modulo a % b
Add a + b
Subtract a - b
Shift left a << b
Shift right 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
Structure element a.b
Array element a[b]
Subfield select a->b
Segment: Offset address specification When you are specifying a segment offset
address for monitoring in a variable monitor
window, specify the offset address in the format
0x0000:0x0000.
Cast (dt)(exp), where dt is one of the supported data
types, and exp is an expression that evaluates to
one of these data types.
ΓòÉΓòÉΓòÉ 5.7.16. Supported Data Types ΓòÉΓòÉΓòÉ
You can monitor an expression that uses the following typecasting operations
only:
o 8-bit signed byte
o 8-bit unsigned byte
o 16-bit signed integer
o 16-bit unsigned integer
o 32-bit signed integer
o 32-bit unsigned integer
o 32-bit floating-point
o 64-bit floating-point
o 80-bit floating-point
o Pointers
o User-defined types.
ΓòÉΓòÉΓòÉ 5.8. Monitor Expression Action Window ΓòÉΓòÉΓòÉ
Use this action window to type in the expression that you want to monitor.
This action window lists the following contextual information:
o The component you are in
o The view of the program that is active
o The line of the source code active (highlighted)
o The thread you are in.
The expression language supported by the debugger is a subset of the C/C++
language. You can monitor only expressions with:
o A supported operand type
o A supported operator
o A supported typecasting operation.
To specify an expression to be monitored:
1. Type the name of the variable or expression you want to monitor.
2. Select the appropriate push button.
3. The expression is displayed in the fashion specified in the Monitor
Properties action window.
ΓòÉΓòÉΓòÉ 5.9. Windows Menu ΓòÉΓòÉΓòÉ
Select choices from the Windows menu to display other debugger windows.
Menu Summary
Local variables
Display the local variables for the program's current line.
Registers
Monitor registers and flags for a particular thread.
Stack
Monitor the call chain stack for a particular thread.
Private monitor
Display the Private Monitor window.
Program monitor
Display the Program Monitor window.
Storage
Monitor the storage that a program is using.
Window analysis
View graphical and textual information of program windows and observe the
relationships between windows.
Message queue monitor
Select the PM messages that you want displayed.
Inheritance
Look at classes of C++ programs.
Command Log
Display the Command Log window.
Command Line
Display the Command Line window.
Debug session control
Displays the Debug Session Control window.
ΓòÉΓòÉΓòÉ 5.9.1. Message Queue Monitor Choice ΓòÉΓòÉΓòÉ
Select the Message queue monitor choice to display the Message Queue Monitor
window which displays the PM messages for PM applications.
ΓòÉΓòÉΓòÉ 5.9.2. Window Analysis Choice ΓòÉΓòÉΓòÉ
Select the Window analysis choice to help you understand PM application
windows. It presents both graphical and textual information of debugged windows
and lets you observe the relationships between windows.
Note: To display the Window Analysis window, you must stop your program.
ΓòÉΓòÉΓòÉ 5.10. Run Menu ΓòÉΓòÉΓòÉ
Select choices from the Run menu to control the execution of your program. You
can choose from several ways to step through your program, or you can execute
your program until a breakpoint is encountered or your program is terminated.
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. In the case of 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 termination of the program.
Menu Summary
Thread enabled
Enable or disable threads.
Step over
Execute the current line in your program. If the current line is a call,
execution is halted when the call is completed.
Step into
Execute the current line in your program. If the current line is a call,
execution is halted at the first statement in the called function.
Step debug
Execute the current line in the program. The debuggers 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 terminates.
Run to location
Execute your program from the current line up to the line that is highlighted
with gray in the prefix area.
Jump to location
Change the current line in the program without executing the code between the
present current line and the new current line.
Animate
Automatically repeat Step over commands.
Halt
Interrupt the program you are debugging.
ΓòÉΓòÉΓòÉ 5.10.1. Thread Enabled Choice ΓòÉΓòÉΓòÉ
Select the Thread enabled. choice so that the thread associated with the
program view is allowed to execute when the program runs. When a thread is
enabled, a √ symbol appears beside the Thread enabled. choice. When a thread
is not enabled, a √ symbol is not displayed and the highlighted thread is not
executed.
ΓòÉΓòÉΓòÉ 5.10.2. Step Debug Choice ΓòÉΓòÉΓòÉ
Select the Step debug choice to execute the current line in the program. The
debugger steps over any function for which debug data. is not available, (for
example, library and system functions) and steps into any function for which
debugging information is available.
ΓòÉΓòÉΓòÉ 5.10.3. Step Into Choice ΓòÉΓòÉΓòÉ
Select the Step into choice to execute the current line in the program, If the
current line is a call, execution is halted at the first statement in the
called function.
ΓòÉΓòÉΓòÉ 5.10.4. Step Over Choice ΓòÉΓòÉΓòÉ
Select the Step over choice to execute the current line of the program. If the
current line is a call, execution is halted when the call is completed. You
can also access the Step over function by placing the mouse cursor in a program
view window and single-clicking mouse button two to execute one line.
All enabled threads will be allowed to continue execute.
Note: The debugger stops in a called function if it encounters a breakpoint.
ΓòÉΓòÉΓòÉ 5.10.5. 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 (unless a
breakpoint is encountered).
ΓòÉΓòÉΓòÉ 5.10.6. 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 is
terminated.
ΓòÉΓòÉΓòÉ 5.10.7. Run to Location Choice ΓòÉΓòÉΓòÉ
You can execute your program from the current line up to the line that is
highlighted with gray in the prefix area.
To use the Run to location choice:
1. Single-click in the prefix area of the line you want to become the current
line.
The prefix area turns gray.
2. Select the Run to location choice.
The program is executed 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.
ΓòÉΓòÉΓòÉ 5.10.8. Jump to Location Choice ΓòÉΓòÉΓòÉ
You can change the current line in your program without executing the lines
between the present current line and the new current line.
To use the Jump to location choice:
1. Single-click in the prefix area of the line you want to become the current
line.
The prefix area turns gray.
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 run is not performed.
Note: Jumping out of the current function may corrupt the stack pointer and
cause your program to produce unpredictable results.
ΓòÉΓòÉΓòÉ 5.10.9. 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).
ΓòÉΓòÉΓòÉ 5.10.10. Animate Choice ΓòÉΓòÉΓòÉ
When you select Animate, the debugger automatically performs Step over
commands. As the program runs, the position of the current line changes and
the monitors are updated.
To stop the animation, press SysRq (Alt + Print Screen).
ΓòÉΓòÉΓòÉ 5.11. Options Menu ΓòÉΓòÉΓòÉ
Select choices from the Options menu to control the debugger windows.
Menu Summary
Fonts
Select the font you want to use for the text displayed in the active window.
Session settings
Set various debugger options.
Profile
Select the location where you want the debugger restart information file
placed.
Debug session control
Display the Debug Session Control window.
ΓòÉΓòÉΓòÉ 5.11.1. Monitor Properties Choice ΓòÉΓòÉΓòÉ
Select the Monitor Properties choice to select the settings for monitoring
variables or expressions.
When you select the Monitor properties choice, the Monitor Properties action
window is displayed.
ΓòÉΓòÉΓòÉ 5.11.2. Monitor Properties Action Window ΓòÉΓòÉΓòÉ
Use the Monitor Properties action window to select the settings for monitoring
variables or expressions. You can set the following options: .
o Whether or not the context for variables or expressions is displayed in the
variable monitor windows.
o The window into which the variable or expression being monitored is placed.
o Whether or not the displayed contents of the variable or expression are
updated as the state of the program changes.
o For data popup windows, the duration of time that the monitor windows are
displayed.
After you have selected the settings you want from this action window, click on
one of the push buttons to continue.
For a description of the option settings that you can select from this action
window, double-click on one of the following topics:
o Show context
o Monitor location
o Enabled
o Duration
ΓòÉΓòÉΓòÉ 5.11.3. Show context ΓòÉΓòÉΓòÉ
Select the Show context check box to display the context for variables or
expressions when they are selected for monitoring.
ΓòÉΓòÉΓòÉ 5.11.4. Monitor location ΓòÉΓòÉΓòÉ
Choose one of the following radio buttons to select the type of monitor window
that is opened when a variable or expression is selected for monitoring. The
selections you can make and the corresponding windows are:
Popup Display the variable or expression in a data popup 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.
ΓòÉΓòÉΓòÉ 5.11.5. Enabled ΓòÉΓòÉΓòÉ
Select the Enabled check box to update the displayed contents of variables or
expressions when they are selected for monitoring.
ΓòÉΓòÉΓòÉ 5.11.6. Duration ΓòÉΓòÉΓòÉ
If you select Popup from under the Monitor location group heading, select one
of the following radio buttons to select the length of time that the data popup
window will stay displayed:
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 The monitor window stays open for the remainder of the
debugging session.
ΓòÉΓòÉΓòÉ 5.11.7. Initial Window Placement Choice ΓòÉΓòÉΓòÉ
Select the Initial window placement choice to set the position and size of the
debugger windows when they are first created. When you select Initial window
placement, the Initial Window Placement action window is displayed.
ΓòÉΓòÉΓòÉ 5.11.8. Profile Cascading Choice ΓòÉΓòÉΓòÉ
Select the Profile cascading choice to specify the location in which you want
the debugger restart information file and session settings placed, or to delete
restart information.
Menu Summary
Change location
Allows you to change the location of the files that hold the debugger
settings.
Delete restart information
Allows you to delete restart information for a program that you have
debugged.
ΓòÉΓòÉΓòÉ 5.11.9. Change Location Choice ΓòÉΓòÉΓòÉ
Select the Change location choice to specify the location in which you want the
profile information file placed. The debugger restart information file contains
your selections for most of the debugger options and information. You choose
whether or not you want your selections saved for the next debugging session by
selecting Save settings at the time you make your selections in an option
action window.
When you select the Change location choice, the Change Location action window
appears displayed.
ΓòÉΓòÉΓòÉ 5.11.10. Save Restart Information Choice ΓòÉΓòÉΓòÉ
Select the Save restart information choice to save the restart information for
a program that you have previously debugged.
When you select Save restart information, the Save Restart Information action
window is displayed.
ΓòÉΓòÉΓòÉ 5.11.11. Save Restart Action Window ΓòÉΓòÉΓòÉ
Use the Save Restart Information action window to save the restart information
for the program that you are currently debugging.
To save restart information:
1. Select the path names of the programs whose restart information you want to
delete.
2. Click on the Delete push button.
3. Click on Cancel to close the Delete Restart Information action window.
ΓòÉΓòÉΓòÉ 5.11.12. Delete Restart Information Choice ΓòÉΓòÉΓòÉ
Select the Delete restart information choice to delete restart information for
a program that you have previously debugged.
When you select Delete restart information, the Delete Restart Information
action window is displayed.
ΓòÉΓòÉΓòÉ 5.11.13. Delete Restart Information Action Window ΓòÉΓòÉΓòÉ
Use the Delete Restart Information action window to delete the restart
information from the debugger restart information file for a program that you
have previously debugged.
To delete restart information:
1. Select the path names of the programs whose restart information you want to
delete.
2. Click on the Delete push button.
Note: You can delete restart information to minimize the amount of space your
debugger restart information files take up.
ΓòÉΓòÉΓòÉ 5.11.14. Initial Window Placement Action Window ΓòÉΓòÉΓòÉ
Use the Initial Window Placement action window to set the position and size of
the debugger windows when they are first opened. The following is a list of
the windows you can manipulate:
o Debug Session Control
o Local Variable
o Parent and Z-order Tree
o Program Monitor
o Register
o Source, Disassembly, or Mixed
o Stack
o Storage.
o Window Analysis
o Window Characteristics
o Message Queue Monitor
The rectangle area under the Window group heading represents your screen. The
Width and Height of the representational screen are shown under the Screen Size
group heading.
Double-click on one of the following topics to see the procedures for changing
the initial opening position and opening size of the windows:
o Changing Initial Opening Positions
o Changing Initial Opening Sizes
Click on one of the push buttons to continue.
Window Title List Box
Use the window title list to select the title of the window you want to edit.
(The titles might not be fully displayed for all of the windows.) Select the
arrow to open the window title list. Then, highlight the title of the window
you want to edit. The new title is displayed in the window title entry field.
Placement Values
X The coordinate of the horizontal axis.
Y The coordinate of the vertical axis.
Width The width of the window, in units.
Height The height of the window in units.
Click on the Edit Window push button to make the window displayed in the window
title entry field, the current window.
Screen Size
Under the Screen Size group heading are displayed the maximum height and width
for a window with coordinates (0,0).
Note: The sum of the X coordinate and the Width cannot be greater than the
value displayed under the Screen Size group heading. The sum of the Y
coordinate and the Height cannot be greater than the value displayed under the
Screen Size group heading.
ΓòÉΓòÉΓòÉ 5.11.15. Changing Initial Opening Positions ΓòÉΓòÉΓòÉ
You can move any window to a new opening position by dragging it with the
mouse. The new X (horizontal axis) and Y (vertical axis) coordinates are
displayed after it has been moved.
You can also change the opening position of a window by doing the following:
1. Select the window you want to edit in either of the following ways:
o With the mouse
o By selecting the arrow in the window title entry field to open the window
title list, and highlighting the title of the window you want to
reposition.
The window you have chosen to edit is now displayed in the window title
entry field.
2. Click on the Edit push button.
3. Type in the new X (horizontal axis) and Y (vertical axis) coordinates.
The position of the window changes as you type in the new coordinates.
Note: The sum of the X coordinate and the Width cannot be greater than the
value displayed under the Screen Size group heading. The sum of the Y
coordinate and the Height cannot be greater than the value displayed under
the Screen Size group heading.
4. Click on the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 5.11.16. Changing Initial Opening Sizes ΓòÉΓòÉΓòÉ
You can change the opening size of a window by dragging it with the mouse. The
new Width and Height are displayed after you have resized it.
You can also change the opening size of a window by doing the following:
1. Select the window you want to edit in either of the following ways:
o With the mouse
o By selecting the arrow in the window title entry field to open the title
list, and highlighting the title of the window you want to resize.
The window you have chosen to edit is now displayed in the window title
entry field.
2. Click on the Edit push button.
3. Type in the new Height and Width values.
The size of the window changes as you type in the new values.
Note: The sum of the X coordinate and the Width cannot be greater than
640. The sum of the Y coordinate and the Height cannot be greater than 480.
4. Click on the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 5.11.17. Push Buttons ΓòÉΓòÉΓòÉ
OK
Click on OK to accept the information you have entered and to close this
action window.
Reset
Click on Reset to change the information to the previously saved setting.
Default
Click on Default to change to the default setting.
Cancel
Click on Cancel to close this action window.
Help
Click on Help to display help information that tells you how to use this
action window.
ΓòÉΓòÉΓòÉ 5.11.18. Push Buttons ΓòÉΓòÉΓòÉ
OK
Click on OK to accept the information you have entered and to close this
action window.
Reset
Click on Reset to change the information to the previously saved setting.
Cancel
Click on Cancel to close this action window.
Help
Click on Help to display help information that tells you how to use this
action window.
ΓòÉΓòÉΓòÉ 5.11.19. Change Location Action Window ΓòÉΓòÉΓòÉ
Use the Change Location action window to specify the directory where you want
the profile information (session settings and restart information) default
options file saved.
After you have completed your dialog, click on the appropriate push button.
Path
Type the full path name of the directory where you want the debugger profile
information file stored
ΓòÉΓòÉΓòÉ 5.11.20. Push Buttons ΓòÉΓòÉΓòÉ
OK
Click on OK to accept the information you have entered and to close this
action window.
Reset
Click on Reset to clear any changes you have made in this dialog session.
Default
Click on Default to replace the current settings with the debugger default
options.
Cancel
Click on Cancel to close this action window.
Help
Click on Help to display help information that tells you how to use this
action window.
ΓòÉΓòÉΓòÉ 5.11.21. Fonts Choice ΓòÉΓòÉΓòÉ
Select the Fonts choice to set the font you want to use for the text that is
displayed in the active window.
ΓòÉΓòÉΓòÉ 5.11.22. Private Monitor Choice ΓòÉΓòÉΓòÉ
Select the Private monitor choice to display the Private Monitor window.
ΓòÉΓòÉΓòÉ 5.11.23. Program Monitor Choice ΓòÉΓòÉΓòÉ
Select the Program monitor choice to display the Program Monitor window.
ΓòÉΓòÉΓòÉ 5.11.24. Animation Rate Choice ΓòÉΓòÉΓòÉ
Select the Animation rate choice to set the rate that you will automatically
step through your program.
When you select Animation rate, the Animation Rate action window is displayed.
ΓòÉΓòÉΓòÉ 5.11.25. Source Window Properties Choice ΓòÉΓòÉΓòÉ
Select the Source window properties choice to determine how your threads and
source files are initially displayed and how they are handled when they stop or
are no longer active. When you select Source window properties, the Source
Window Properties action window is displayed.
ΓòÉΓòÉΓòÉ 5.12. Font Selection Action Window ΓòÉΓòÉΓòÉ
Use this action window to change the font that is used for the text displayed
in the current window.
ΓòÉΓòÉΓòÉ 5.12.1. Push Buttons ΓòÉΓòÉΓòÉ
OK
Click on OK to accept the information you have entered and to close this
action window.
Apply
Click on Apply to apply the font to the window. The change applies only until
you close the action window. Click on OK to select the new font.
Reset
Click on Reset to change the font back to your earlier selection.
Default
Click on Default to replace the current font selection with the default font.
The default font is System Monospaced 8x8.
Cancel
Click on Cancel to close this action window.
Help
Click on Help to display help information that tells you how to use this
action window.
ΓòÉΓòÉΓòÉ 5.13. Source Window Properties Action Window ΓòÉΓòÉΓòÉ
Use this action window to define:
o The program view that is to be displayed when the debugger is started and
when a program view is first displayed in the course of debugging.
o How to process view windows from which execution has just left. These
components and threads can:
- Remain displayed
- Be turned into an Icon
- Be discarded.
New view priority
When a program view is created, this setting indicates the view that is to be
displayed (subject to the availability of the source code).
The views that can be displayed are:
Source Displays the source code for the thread or component.
Disassembly Displays your program as assembler instructions without
symbolic information for the thread or component.
Mixed Displays a line of source code followed by the assembler
instructions for that line of source code.
You can change the priority by dragging the view icons with mouse button two to
arrange the items in the order you want, and you can use the tab keys to move
around to the other parts of the action window. You can also rearrange the view
icons using the Alt+Up and Alt+Down arrow keystrokes.
You can choose to display the program views in the New view priority as icons
or text. Click on the appropriate push button to set the display mode.
Old source disposition
In the course of debugging, these selections allow you to control the behavior
of view windows from which execution has just left. The Old source disposition
controls the behavior of view windows within a thread.
The dispositions that the views can take are:
Keep Leaves open the views that contain the components and threads
that you select with Display at stop.
Iconize 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.
Display at stop
You can control how many windows are displayed at one time.
The choices are:
Only stopping thread Either keeps, iconizes, or discards all views that are
not the stopping thread.
All threads Keeps, iconizes, or discards the views for old
components within each thread.
For example, if you select Only stopping thread, the Old source disposition
applies to all of the view windows except the current view of the stopping
thread. If you select All threads, the Old source disposition applies only to
the view windows for the components from which execution has just left within a
thread.
Source as Notebook
You can display your program view in a notebook format if there are include
files in the source file.
Multiple views
You can choose to display more than one program view for a particular source
file. The default is not to display multiple views.
Title bar buttons
You can choose to display or not display the title bar buttons. The default is
to display the title bar buttons.
Save session settings
You can choose to save your selections for the next debugging session.
Click on the appropriate push button to complete your dialog.
ΓòÉΓòÉΓòÉ 6. Inheritance View Window ΓòÉΓòÉΓòÉ
The Inheritance View window displays a list of classes and a graphical
depiction of the C++ class hierarchy. You can also display the class
definitions of your program.
Menu Bar Summary
File
Display class details, display overview, or close the debugger.
Options
Select the font, control how the classes are displayed, find a class, and
display the Debug Session Control window.
Help
You have access to several kinds of help information that compliments the
online help information that you can get for the debugger. Press F1 or
select the Help push button.
ΓòÉΓòÉΓòÉ 6.1. File Menu ΓòÉΓòÉΓòÉ
You can look at class details and select an overview of the class hierarchy.
Menu Summary
Class details
Open the Class Details window for the selected class.
Overview
Display the Overview window for the class hierarchy.
Close Debug
Close the debugging session.
ΓòÉΓòÉΓòÉ 6.1.1. Class Details Choice ΓòÉΓòÉΓòÉ
Select the Class details choice to get more information about a particular
class definition.
Select a class from the list, then select the Class details choice. The Class
Details action window is displayed.
ΓòÉΓòÉΓòÉ 6.1.2. Overview Choice ΓòÉΓòÉΓòÉ
Select the Overview choice to display a scaled-down image of the Inheritance
View window. You can zoom in and out on the Inheritance View window. This
allows you to enlarge the nodes displaying the text for that node.
ΓòÉΓòÉΓòÉ 6.2. Overview Window ΓòÉΓòÉΓòÉ
The Overview window displays a scaled-down image of the Inheritance View
window.
To change the view of the window:
1. Press and hold down mouse button one, while pointing to any edge of the
shaded rectangle in the Overview window. By moving the mouse forward or
backward, the rectangle becomes larger or smaller.
2. Release mouse button one and the main window is redrawn to reflect the new
view.
To change to a different area of the window:
1. Press and hold down mouse button one in the center of the shaded rectangle
in the Overview window. Move the rectangle over the part of the graph that
you want to view.
2. Release mouse button one and the main window is redrawn to reflect the new
view.
ΓòÉΓòÉΓòÉ 6.3. Options Menu ΓòÉΓòÉΓòÉ
Select choices from the Options menu to change the parameters that control how
the program is displayed and executed.
Menu Summary
Fonts
Select the font you want to use for the text displayed in the active window.
Derived to Base Class Tree
Display the class list as a tree. When you click on the plus icon, the base
classes are displayed for that class.
Base Class to Derived Tree
Display the class list as a tree. When you click on the plus icon, the
derived classes are displayed for that class.
Class List
Display only a list of the classes.
Find class
Locate a class.
Debug session control
Display the Debug Session Control window.
ΓòÉΓòÉΓòÉ 6.3.1. Find Class Choice ΓòÉΓòÉΓòÉ
Select Find class to highlight a particular class definition in the Inheritance
View window. When you select Find class, the Find Class action window is
displayed.
ΓòÉΓòÉΓòÉ 6.4. Find Class Action Window ΓòÉΓòÉΓòÉ
Use the Find Class action window to highlight a class in the Inheritance View
window. Type the name of the class that you want to locate in the Enter class
name entry field and select the appropriate push button.
ΓòÉΓòÉΓòÉ 6.4.1. Derived to Base Class Tree Choice ΓòÉΓòÉΓòÉ
Select the Derived to base class tree choice to control how the classes are
displayed in the Classes box.
When the Derived to base class tree choice is enabled, the classes box is
displayed as a hierarchical tree listing the classes alphabetically. When you
click on the plus icon, the base classes are displayed for that class.
The title of this list includes (D->B) to indicate that the Derived classes can
be expanded into their Base classes.
ΓòÉΓòÉΓòÉ 6.4.2. Base to Derived Class Tree Choice ΓòÉΓòÉΓòÉ
Select the Base to derived class tree choice to control how the classes are
displayed in the Classes box.
When the Base to derived class tree choice is enabled, the classes box is
displayed as a hierarchical tree listing the classes alphabetically. When you
click on the plus icon, the derived classes are displayed for that class.
The title of this list includes (B->D) to indicate that the Base classes can be
expanded into their Derived classes.
ΓòÉΓòÉΓòÉ 6.4.3. Class List Choice ΓòÉΓòÉΓòÉ
Inheritance View window
Select the Class list choice to display the list of classes alphabetically in
the Classses list.
ΓòÉΓòÉΓòÉ 6.5. Class Details Window ΓòÉΓòÉΓòÉ
The Class Details window provides information about a particular class
definition.
Each page has a vertical split bar that lets you resize the notebook page. To
resize the page, press and drag the mouse pointer on the vertical split bar.
This window contains a notebook with tabs at the bottom. There are six pages in
the notebook and each page contains information about a particular class
definition. The name of the notebook page is above the tabs. You can change
pages in the notebook by selecting the spin buttons in the bottom-right corner
or by selecting the tabs on the bottom of the notebook page. The names of the
six notebook pages are as follows:
o Data members
o Member functions
o Base classes
o Derived classes
o Class friends
o Friend functions
Menu Bar Summary
Options
Controls how the window is displayed.
Help
You have access to several kinds of help information that compliments the
online help information that you can get for the debugger. Press F1 or select
the Help push button.
ΓòÉΓòÉΓòÉ 6.5.1. Options Menu ΓòÉΓòÉΓòÉ
The Options menu choices allow you to select what you want displayed in the
Class Details window.
Menu Summary
Window settings
Control how the fields in the Class Details window are displayed.
Debug session control
Displays the Debug Session Control window.
Close debug
End the debugging session.
ΓòÉΓòÉΓòÉ 6.5.2. Window Settings Cascading Choice ΓòÉΓòÉΓòÉ
The Window Settings cascading choice lets you control the font for the notebook
page and choose how you want the fields displayed.
Menu Summary
Display Style
Select which fields are displayed on the notebook page.
Fonts
Select the font you want to use for the text displayed in the active window.
ΓòÉΓòÉΓòÉ 6.5.3. Display Style Choice ΓòÉΓòÉΓòÉ
Select the Display style choice to choose which fields are displayed on the
notebook page. When you select Display style, the Window Settings action window
is displayed. This action window controls the current notebook page.
Note: If you want to change another notebook page, use the spin buttons to
move through the notebook pages and then select the Display style choice.
ΓòÉΓòÉΓòÉ 6.5.4. Window Settings Action Window ΓòÉΓòÉΓòÉ
Use the Window Settings action window to control which columns or fields are
displayed on the notebook page and how you want the information sorted. There
are two list boxes in the Window Settings action window: Details to display and
Sort by.
Details to display:
The list box contains the fields from the notebook page. You can select the
columns you want displayed on the notebook page. If you do not want a field
displayed on the notebook page, click on it. The field is immediately removed
from the notebook page and deselected in the list.
Sort by:
The list box contains the column names or fields from the notebook page. Select
how you want the fields sorted on the notebook page. When you select a field
name, all the rows are sorted based on the alphabetical order of the selected
field.
You can choose Defined order from the list box to place the rows in the default
order.
Hide column titles
This check box lets you choose to hide or show the column titles. When a √ is
displayed, the titles are hidden. When a √ is not displayed, the titles are
shown.
Select one of the push buttons to continue.
ΓòÉΓòÉΓòÉ 7. Exception Window ΓòÉΓòÉΓòÉ
The Exception action window is displayed whenever an OS/2 exception has
occurred. It may have occurred in application or system code. In either case,
the debugger displays and highlights the line where the exception occurred in
the source window.
The three options that are available are:
Examine/Retry This option allows the user to investigate the cause of the
exception and if desired, retry execution of the line that
caused the original fault. Execution will begin with the
line that caused the fault and attempt to continue from
that point.
This is the default action that occurs if you press Enter.
Step Exception This action causes the debugger to step into the first
registered exception handler (tracked by OS/2). Execution
will stop at the first executable line of code in that
exception handler. At this point, the user controls what
happens next.
Run Exception This action causes the debugger to run the normal exception
handler(s) that are registered with OS/2 to handle
exception conditions.
ΓòÉΓòÉΓòÉ 8. Window Analysis ΓòÉΓòÉΓòÉ
Window Analysis gives you an understanding of PM application windows. It
presents both graphical and textual information about your application's
windows and lets you observe the relationships between windows.
It allows you to view a three-dimensional image of your application's windows,
characteristics of windows, and parent-child relationships between the windows.
Your application creates many windows, directly or indirectly, to perform
tasks. All of these windows are children or descendents of desktop and
desktop-object windows. Windows created by the application being debugged are
referred to as debuggee windows. Window Analysis consists of the following
windows:
o Window Analysis is the primary window.
o Parent and Z-Order Tree is a secondary window.
o Window Characteristics is a secondary window.
The secondary windows provide information pertaining to the Window Analysis
window. When you select an item in any of the three windows, it is reflected in
the other two windows. If you close the Window Analysis window, the secondary
windows will also close.
The Window Analysis presents an image of your debuggee windows. When this image
is displayed, you can rotate the image to visually separate the windows, select
a window on the image, and look at the detailed information pertaining to that
window. The Window Analysis window is represented in a notebook format. The
notebook is divided in two sections: desktop and desktop-object. The notebook
has major and minor tabs. Major tabs correspond to the two major sections that
are located at the bottom of the notebook. Major tab pages define the
beginning of major sections and are called primary pages. Pages within major
sections are called regular pages. They have minor tabs that are located at
the right of the notebook.
The images on the desktop and desktop-object primary pages represent children
of the desktop window and desktop-object window respectively.
The images on the regular pages represent the child of the desktop or
desktop-object window as a parent and all its descendents.
To display the pages and tabs, you can use the notebook standard keyboard
selection technique. Another method of displaying the pages is to double-click
on the window on the primary page.
You can select any window on a page by clicking on the window. By using the Tab
and BackTab keys, you can move the selection from window to another window.
When you select an item in the Window Analysis window, it is reflected in the
two secondary windows.
Each page has a status line that is used to display sizes of a window that is
selected on the page.
Use the vertical slider or vertical arrows to rotate the page image vertically
(around the x-axis). Use the horizontal slider to rotate the image
horizontally (around the y-axis).
The borders of the windows are drawn as follows:
screen solid thick line (only on a primary page)
visible window solid thin line
invisible window dashed thin line
Menu Bar Summary
Details
View the secondary windows of Window Analysis.
Options
Control the way that Window Analysis is displayed.
Help
Online help information that compliments the information you get when you
press F1 or select a Help push button.
ΓòÉΓòÉΓòÉ <hidden> Desktop ΓòÉΓòÉΓòÉ
The desktop section is comprised of a primary page and a number of regular
pages. The primary page of the desktop section contains the image of the
desktop window and debuggee windows that are children of the desktop window.
The primary page has a major tab with the name Desktop at the bottom of the
notebook. The major tab defines the beginning of the desktop section.
The regular page of the desktop section contains the image of the child of the
desktop as a parent and all its descendents. The regular page has a minor tab
with the image of the desktop window child and its descendents or a text. The
minor tabs are at the right of the notebook.
Note: The sizes and distribution of windows may cause the image to be
displayed as a small dot on the screen, or number of dots positioned according
to the z-order. This may occur as a consequence of minimizing the debuggee
windows, or if the sizes of windows are zero.
ΓòÉΓòÉΓòÉ <hidden> Desktop-Object Windows ΓòÉΓòÉΓòÉ
The desktop-object section is comprised of a primary page and a number of
regular pages. The primary page of the desktop-object section contains the
image of debuggee windows that are children of the Desktop-object window. The
primary page has a major tab with the name "Desktop-object" at the bottom of
the notebook. The major tab defines the beginning of the desktop-object
section. ;p. The regular page of the desktop-object section contains the image
of the child of the desktop-object as a parent and all its descendents. The
regular page has a minor tab with a text on it. The minor tab is at the right
of the notebook. The desktop-object part is optional.
Note: The sizes and distribution of windows may cause the image to be
displayed as a small dot on the screen, or number of dots positioned according
to the z-order. This is a consequence of sizes of object windows often being
zero.
ΓòÉΓòÉΓòÉ 8.1. Details Menu ΓòÉΓòÉΓòÉ
Select choices from the Details menu to view the secondary windows of Window
Analysis.
Menu Summary
Parent and Z-Order tree
Display the Parent and Z_Order Tree window to view the relationships between
the debuggee window and non-debuggee windows.
Window characteristics
Display the Window Characteristics window to view characteristics of the
window such as class, handle, and so on.
Close debug
Close the debugging session.
ΓòÉΓòÉΓòÉ 8.1.1. Parent and Z-Order Tree Choice ΓòÉΓòÉΓòÉ
Select the Parent and z-order tree choice to show the relationships between the
following windows:
o debuggee
o non-debuggee
o debuggee and non-debuggee.
Note: Items selected in this window are reflected in the other two windows
(Window Analysis and Window Characteristics).
When you select Parent and z-order tree, the Parent and Z-Order Tree window is
displayed.
ΓòÉΓòÉΓòÉ 8.1.2. Window Characteristics Choice ΓòÉΓòÉΓòÉ
Select the Window characteristics choice to view the characteristics of the
debuggee windows.
Note: Items selected in this window are reflected in the other two windows
(Window Analysis and Parent and Z-Order Tree).
When you select Window characteristics, the Window Characteristics window is
displayed.
ΓòÉΓòÉΓòÉ 8.2. Options Menu ΓòÉΓòÉΓòÉ
Select choices from the Options menu to control the display of bitmaps and
desktop-object windows and to rotate the image to the center or to the default
position.
Menu Summary
Bitmaps
Display the bitmaps on the notebook tabs.
Desktop-object windows
Display the desktop-object windows in the Window Analysis and Parent and
Z-Order Tree windows.
Rotate to center
Rotate the image on the window to the center position.
Rotate to default
Rotate the image on the window to the default position.
Debug session control
Display the Debug Session Control window.
ΓòÉΓòÉΓòÉ 8.2.1. Bitmaps Choice ΓòÉΓòÉΓòÉ
Enable the Bitmaps choice to display bitmaps on the tabs of the notebook in the
Window Analysis window. When bitmaps are enabled, a bitmap is displayed on the
tab if the window is shown on the screen. If the window is hidden, text is
displayed on the tab. (For desktop-object section, this is always the case).
The text is displayed on the tabs when bitmaps are disabled. The text is the
letter "D" (Desktop) or letter "O" (Desktop-object) concatenated with the
number of a regular page in the section.
ΓòÉΓòÉΓòÉ 8.2.2. Desktop-Object Windows Choice ΓòÉΓòÉΓòÉ
You can enable or disable the the Desktop-object windows choice to include the
desktop-object windows in the Window Analysis window.
ΓòÉΓòÉΓòÉ 8.2.3. Rotate to Center Choice ΓòÉΓòÉΓòÉ
Select the Rotate to center choice to center the image on the Window Analysis
window.
ΓòÉΓòÉΓòÉ 8.2.4. Rotate to Default Choice ΓòÉΓòÉΓòÉ
Select the Rotate to default choice to rotate the image to the default position
in the Window Analysis window
ΓòÉΓòÉΓòÉ 8.3. Window Characteristics Window ΓòÉΓòÉΓòÉ
The Window Characteristics window displays the characteristics of the debuggee
windows. The Window Characteristics window is displayed in a table format with
each row representing a different debuggee window and each column representing
a different characteristic. The rows listed in the Window Characteristics
window reflect the debuggee windows on the current page of the Window Analysis
window.
Note: Items selected in this window are reflected in the other two windows
(Window Analysis and Parent and Z-Order Tree).
Menu Summary
Options
Control which characteristics are displayed.
Help
Online help information that compliments the information you get when you
press F1 or select a Help push button.
ΓòÉΓòÉΓòÉ 8.3.1. Options Menu ΓòÉΓòÉΓòÉ
Select choices from the Options menu to control the display of windows
characteristics, titles in the window, and fonts for the window.
Menu Summary
Display style
Select which window characteristics are displayed.
Window controls
Turn titles on or off in the Window Characteristics window.
Fonts
Select the font you want to use for the text displayed in the active window.
ΓòÉΓòÉΓòÉ 8.3.2. Display Style Choice ΓòÉΓòÉΓòÉ
Select the Display style choice to choose which window characteristics you want
displayed in the Window Characteristics window.
When you select Display style, the Display Styles action window is displayed.
ΓòÉΓòÉΓòÉ 8.3.3. Window Controls Choice ΓòÉΓòÉΓòÉ
Select the window controls choice to choose whether titles are displayed in the
Window Characteristics window.
When you select Window controls, the Window Controls action window is
displayed.
ΓòÉΓòÉΓòÉ 8.3.4. Display Style Action Window ΓòÉΓòÉΓòÉ
Use the Display Style action window to select the characteristics you want
displayed in the Window Characteristics window.
Visible characteristics
Select the characteristics you want displayed in the Window Characteristics
window by clicking on the names of the titles. The highlighted names will be
displayed in the Window Characteristics window.
Save window settings
Select this check box to save your selections for the next debugging session.
Select one of the push buttons to continue.
ΓòÉΓòÉΓòÉ <hidden> Characteristics List ΓòÉΓòÉΓòÉ
Class
Window class of the window
Hwnd
Window handle in 32-bit hex format
Hwnd (16:16)
Window handle in 16:16-bit hex format
Parent
Parent window handle of the window in 32-bit hex format
Parent (16:16)
Parent window handle of the window in 16:16-bit hex format
Owner
Owner window handle of the window in 32-bit hex format
Owner (16:16)
Owner window handle of the window in 16:16-bit hex format
X
X-coordinate of the position of the window relative to the desktop
Y
Y-coordinate of the position of the window relative to the desktop
Width
Width of the window
Height
Height of the window
X'
X-coordinate of the position of the window relative to its parent
window
Y'
Y-coordinate of the position of the window relative to its parent
window
PID
Process identification of the window
TID
Thread identification of the window
Text
Window text (valid only for windows with the class of WC_BUTTON,
WC_STATIC and WC_TITLEBAR)
Active
Whether the window is the active window
Focus
Whether the window has the focus
Enabled
Whether the window is enabled
Checked
Whether the window is checked (only for windows with a class of
WC_BUTTON, WC_STATIC and WC_TITLEBAR)
Visible
Whether the window has its visibility set on
Showing
Whether the window is showing
Proc
Address of the window procedure
Proc name
Name of the window procedure
Thunk proc
Address of the thunk procedure of the window
Class proc
Address of the procedure for the class of the window
Model
The memory model of the window
Msgq
The handle of message queue of the window
Style
The window style settings
HHeap
The heap handle used by the child window of the window
Hwnd focus
The window handle of the child window of the window that last had the
focus in 32-bit HEX format
Hwnd focus (16:16)
The window handle of the child window of the window that last had the
focus in 16:16-bit hex format
User
A ULONG value for applications to use at the offset QWL_USER in the
windows of some preregistered window classes
Defbutton
The window handle of the default push button for a dialog in 32-bit
hex format
Defbutton (16:16)
The window handle of the default push button for a dialog in
16:16-bit hex format
ID
The window identity of the window. The value of the id parameter of
the WinCreateWindow function.
Flags
The frame window flags of the window
Result
The dialog result parameter, as established by the WinDismissDlg
function
X Restore
X coordinate of the position to which the window is restored
Y Restore
Y coordinate of the position to which the window is restored
CX Restore
Width to which the window is restored
CY Restore
Height to which the window is restored
X Minimize
X coordinate of the position to which the window is minimized If this
value is -1 the window has not been minimized
Y Minimize
Y coordinate of the position to which the window is minimized If this
value is -1 the window has not been minimized
Minimized
The window is minimized
Maximized
The window is maximized.
ΓòÉΓòÉΓòÉ 8.3.5. Window Controls Action Window ΓòÉΓòÉΓòÉ
Use the Window controls action window to turn the titles on or off in the
Window Characteristics window.
Display titles
Select this box if you want titles to be displayed in the window.
Save window settings
Select this box if you want to save the selections you have made for the next
debugging session.
Select the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 8.4. Parent and Z-Order Tree Window ΓòÉΓòÉΓòÉ
The Parent and Z-Order Tree window shows the relationship between the following
windows:
o debuggee
o non-debuggee
o debuggee and non-debuggee.
Note: Items selected in this window are reflected in the other two windows
(Window Analysis and Window Characteristics).
The non-debuggee windows shown in the Parent and Z-Order Tree window are the
desktop and desktop-object windows and their children which are not debuggee
windows.
Menu Summary
Options
Control how the items in the Parent and Z-Order Tree window are displayed.
Help
Online help information that compliments the information you get when you
press F1 or select a Help push button.
ΓòÉΓòÉΓòÉ 8.4.1. Options Menu ΓòÉΓòÉΓòÉ
Select choices from the Options menu to control the display of the window class
and handle and select the fonts.
Menu Summary
Display style
Select to display the window class and window handle.
Fonts
Select the font you want to use for the text displayed in the active window.
ΓòÉΓòÉΓòÉ 8.4.2. Display Style Choice ΓòÉΓòÉΓòÉ
Select the Display style choice to display the window class and window handle
in the Parent and Z-Order Tree window.
When you select Display style, the Display Style action window is displayed.
ΓòÉΓòÉΓòÉ 8.4.3. Display Style Action Window ΓòÉΓòÉΓòÉ
Use the Display Styles action window to select which items you want displayed
in the Parent and Z-Order Tree window.
Visible Characteristics
Select one of these radio button to select the information you want displayed
for each window:
Window class The registered class of the window.
Window handle The handle of the window.
Both window handle and class The handle and class of the window will be
displayed.
Include non-debuggee desktop children
Select this box if you want to display all the non-debuggee desktop children.
Include non-debuggee desktop-object children
Select this check box to display all of the non-debuggee desktop-object
children.
Note: This choice is only available if you selected Desktop-object windows
from the Window Analysis window.
Save window settings
Select this check box to save your selections for the next debugging session.
ΓòÉΓòÉΓòÉ 9. Message Queue Monitor Window ΓòÉΓòÉΓòÉ
The Message Queue Monitor window displays PM messages associated with a PM
application. It presents formatted messages in a list as they occur. Using
the message queue monitor, you can control:
o How the information is displayed for each message.
o How message parameters are formatted.
o Which messages are monitored.
o Which windows have their messages monitored.
o Which message queues have their messages monitored.
o How the user generated messages are displayed.
Menu Bar Summary
Monitor
Suspend messages, clear messages, resize the columns, and close the debugging
session.
Options
Access various utility action windows where you can set message queue
options. These options control how messages are monitored and displayed.
Help
You have access to several kinds of help information that compliments the
online help information that you can get for the debugger. Press F1 or select
a Help push button.
ΓòÉΓòÉΓòÉ 9.1. Monitor Menu ΓòÉΓòÉΓòÉ
Select choices from the Monitor menu to suspend messages, clear messages,
resize the columns, and close the debugging session.
Menu Summary
Suspend
Suspends messages from being added to the Message Queue Monitor window.
Clear
Delete all the messages that are displayed in the the Message Queue Monitor
window.
Resize column width
Resize the columns in the Message Queue Monitor window.
Close Debug
Close the debugging session.
ΓòÉΓòÉΓòÉ 9.1.1. Suspend Choice ΓòÉΓòÉΓòÉ
Select the Suspend choice to stop any new messages from being added to the
Message Queue Monitor window.
ΓòÉΓòÉΓòÉ 9.1.2. Clear Choice ΓòÉΓòÉΓòÉ
Select the Clear choice to clear all the messages in the Message Queue Monitor
window.
ΓòÉΓòÉΓòÉ 9.1.3. Resize Column Width Choice ΓòÉΓòÉΓòÉ
Select the Resize column width choice to recalculate the widths of the columns
in the Message Queue Monitor window.
Note: This option is available only when the automatic column resizing choice
is not selected in the Display Style action window.
ΓòÉΓòÉΓòÉ 9.2. Options Menu ΓòÉΓòÉΓòÉ
Select choices from the Options menu to control the monitor window.
Menu Summary
Monitor messages
Select which PM messages you want monitored and displayed.
Monitor windows
Select which windows have their messages monitored.
Monitor queues
Select which message queues have their messages monitored.
Format parameters
Select how PM message parameters are displayed.
Define messages
Select user-defined messages.
Display styles
Select the information you want displayed in the Message Queue Monitor
window.
Fonts
Select the font you want to use for the text displayed in the active window.
Debug session control
Display the Debug Session Control window.
ΓòÉΓòÉΓòÉ 9.2.1. Monitor Messages Choice ΓòÉΓòÉΓòÉ
The Monitor messages choice lets you select which PM messages you want
monitored.
When you select Monitor Messages, the Monitor Messages action window is
displayed.
ΓòÉΓòÉΓòÉ 9.2.2. Monitor Messages Action Window ΓòÉΓòÉΓòÉ
Use the Monitor Messages action window to specify the messages you want
monitored.
The Monitor Messages action window consists of the following:
Defined Message IDs
These are the pre-defined and user-defined messages. Each message is displayed
as a name and hex number. You can select multiple messages for monitoring.
Sort
o Select the Name button to sort the messages alphabetically by name.
o Select the ID button to sort the messages numerically by ID.
Undefined Messages IDs
o Select the Include WM_USER check box to include all undefined messages that
are in the range WM_USER and above.
o Select the Include non WM_USER check box to include all undefined messages
that are in the range less than WM_USER.
Include all message IDs
Select the Include all message IDs check box to include all messages. When
this check box is enabled, the defined and undefined message selections are
disabled.
Define Messages IDs
Select this button and the Define Messages action window is displayed.
Monitor
o Select the Messages to application check box to monitor messages that are
received by an application.
o Select the Messages from application check box to monitor messages that are
dispatched by an application.
o Select the Post messages check box to monitor post messages.
o Select the Send messages check box to monitor send messages.
Save window settings
Select the Save window settings check box to save your selections in profile
information.
The messages you select to have monitored are saved in restart information.
Click on the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 9.2.3. Monitor Windows Choice ΓòÉΓòÉΓòÉ
The monitor windows choice lets you select which windows have their messages
monitored.
When you select Monitor windows, the Monitor Windows action window is
displayed.
ΓòÉΓòÉΓòÉ 9.2.4. Monitor Windows Action Window ΓòÉΓòÉΓòÉ
Use the Monitor Windows action window to specify the windows you want
monitored.
You may identify specific windows you want to monitor by using the Window
Analysis window.
The Monitor Windows action window consists of the following:
Windows
Each window is displayed with the class and handle. You can select multiple
windows for monitoring.
Sort
o Select the Class button to sort the window names alphabetically.
o Select the Hwnd button to sort the window handles in numerical order.
o Select the Parent and z-order button to sort the window handles to show the
parent and z-order relationship of application windows.
Monitor all windows
Select the Monitor all windows check box to monitor all the windows. This will
disable individual selection.
Save window settings
Select the Save window settings check box to your selections for the next
session.
Click on the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 9.2.5. Monitor Queues Choice ΓòÉΓòÉΓòÉ
The Monitor queues choice lets you select which message queues are being
monitored.
When you select Monitor windows, the Monitor Message Queue action window is
displayed.
ΓòÉΓòÉΓòÉ 9.2.6. Monitor Message Queue Action Window ΓòÉΓòÉΓòÉ
Use the Monitor Message Queue action window to specify the message queues you
want monitored.
The Monitor Message Queue action window consists of the following:
Message Queue
This section contains a list of the message queues. You can select multiple
queues.
Sort
o Select the HMQ button to sort the message queues by message queue handles.
o Select the TID button to sort the message queues by thread id.
Monitor all message queues
Select the Monitor all message queues check box to monitor all the message
queues. This will disable individual selections.
Save window settings
Select the Save window settings check box to your selections for the next
session.
Click on the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 9.2.7. Format Parameters Choice ΓòÉΓòÉΓòÉ
The Format parameters choice lets you choose how PM message parameters are
displayed.
When you select Format parameters, the Format Message Parameters action window
is displayed.
ΓòÉΓòÉΓòÉ 9.2.8. Format Message Parameters Action Window ΓòÉΓòÉΓòÉ
Use the Format Message Parameters action window to specify how message
parameters are displayed.
The Format Message Parameters action window consists of the following:
Message
This section contains a list of the all the defined messages.
Sort
o Select the Name button to sort the messages alphabetically by name.
o Select the ID button to sort the messages numerically by ID.
Parameter formatting
o MP1 - Message parameter 1
Select the arrow to open the MP1 list. Select the type of formatting you want
from the parameter list. The formatting selections are saved in restart
information.
o MP2 - Message parameter 2
Select the arrow to open the MP2 list. Select the type of formatting you want
from the parameter list. The formatting selections are saved in restart
information.
Save window settings
Select the Save window settings check box to your selections for the next
session.
Click on the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 9.2.9. Parameter List ΓòÉΓòÉΓòÉ
The following is a list of paramters that may not be self-explanatory:
32-bit fixed (int, frac)
A 32-bit fixed number formatted by separating the integer and
fractional parts.
32-bit fixed (decimal rounded)
A 32-bit fixed number formatted as a rounded decimal number.
WM_CHAR mp1
Parameter formatted as the message parameter 1 for a WMCHAR message.
WM_CHAR mp2
Parameter formatted as the message parameter 2 for a WMCHAR message.
ΓòÉΓòÉΓòÉ 9.2.10. Define Messages Choice ΓòÉΓòÉΓòÉ
The Define message choice lets you define messages that you want to have
displayed in the Message Queue Monitor window.
When you select Define message, the Define Messages action window is displayed.
ΓòÉΓòÉΓòÉ 9.2.11. Define Messages Action Window ΓòÉΓòÉΓòÉ
Use the Define Messages action window to define messages.
Message
In the Name entry field, type in the name of the message that you want to
define.
In the ID entry field, type in the hex number for the message or use the spin
button to locate the number of the message.
Default parameter formatting
o MP1 - Message parameter 1
Select the arrow to open the MP1 list. Select the default type of formatting
you want from the parameter list. The formatting selections are saved in
restart information.
o MP2 - Message parameter 2
Select the arrow to open the MP2 list. Select the default type of formatting
you want from the parameter list. The formatting selections are saved in
restart information.
Message monitored by default
Select the Message monitored by default check box if you want to monitor the
messages by default.
Save window settings
Select the Save window settings check box to save the selections you have made
for the next debugging session.
Click on the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 9.2.12. Push Buttons ΓòÉΓòÉΓòÉ
Add
Click on Add to add the new message you have defined.
Update
Click on Update to update a message that previously existed.
Delete
Click on Delete to delete a message that previously existed.
Cancel
Click on Cancel to ignore any changes that were made and close this action
window.
Help
Click on Help to display help information that tells you how to use this
action window.
ΓòÉΓòÉΓòÉ 9.2.13. Display Style Choice ΓòÉΓòÉΓòÉ
Use the Display style choice to select which columns you want to display in the
Message Queue Monitor window.
When you select Display style, the Display Style action window is displayed.
ΓòÉΓòÉΓòÉ 9.2.14. Display Style Action Window ΓòÉΓòÉΓòÉ
Use the Display Style action window to specify which columns you want displayed
in the Message Queue Monitor window.
The items in this window affect system performance. You may want to experiment
with different settings to see what works best for your system.
Columns
Select the columns you want displayed in the Message Queue Monitor window.
These are described in the column list.
Messages count
The following choices affect system performance:
Maximum displayed
Select the number of messages you want displayed from the Maximum displayed
entry field. You can type in a number or use the spin button to select the
number you want. A higher maximum may cause the system to respond faster.
However, too high a maximum, may cause the system may respond slower.
Note: You may need to experiment with this setting to see what works best for
your system.
Deleted at one time
Select the number of messages you want deleted at one time from the Deleted at
one time entry field. You can type in a number or use the spin button to enter
the number you want. The more messages deleted at one time will cause the
system to respond faster.
Unlimited
Select Unlimited to have no maximum on the number of messages to be displayed.
When you select unlimited, the Maximum displayed and Deleted at one time entry
fields are disabled. This choice sets no limit on messages to have displayed
and the system may respond slower.
Automatic scrolling
Select Automatic scrolling if you want the window to automatically scroll
forward when the screen is filled with messages. Selecting this will decrease
system performance.
Automatic column resizing
Select Automatic column resizing if you want the columns to automatically
resize. Selecting this will decrease system performance.
Note: When this check box is selected, the Resize Column Width choice is not
available.
Display titles
Select Display titles if you want titles to be displayed in the window. This
does not affect system performance.
Save window settings
Select the Save window settings check box if you want to save the selections
you have made for the next debugging session.
Click on the appropriate push button to continue.
ΓòÉΓòÉΓòÉ 9.2.15. Column List ΓòÉΓòÉΓòÉ
The following is a list of column titles that are available:
Class Window class of the window handle the message is being
directed to.
Note: Some messages do not have a window handle (for
example, WinPostQueueMsg).
Hwnd Window handle the message is being directed to.
Note: Some messages do not have a window handle (for
example, WinPostQueueMsg).
Queue Message queue the message is being directed to.
Message Message name.
Msg ID Message formatted as 32-bit signed integer.
Msg-hex Message formatted as 32-bit hex number.
MP1 Message parameter 1.
MP2 Message parameter 2.
Type Indicates whether the message is a post message or a send
message.
Time Indicates the time stamp of the message was generated. The
time stamp is an offset from a starting time. Time style
is only for Post messages.
Mouse The mouse position when the message was generated. Mouse
style is only for Post messages.
Options Message removal options. Options style is only for Post
messages.
Model Message identity. Model style is only for Send messages.
Task Whether the message was dispatched between tasks or not.
Task style is only for Send messages.
From PID Process identity of the process that dispatched the
message. From PID style is only for Send messages.
From TID Thread identity of the thread that dispatched the message.
From TID style is only for Send messages.
To PID Process identity of the process that received the message.
To TID Thread identity of the thread that received the message.
Direction Direction the message relative to the debuggee process.
Dispatched - Debuggee process dispatched a message to
another process .
Received - Debuggee process received a message from
another process .
Internal - Debuggee process dispatched a message to
itself.
Processed Whether the debugger processed message on behalf the
debuggee. This occurs when the debuggee is stopped.
ΓòÉΓòÉΓòÉ 10. Storage Window ΓòÉΓòÉΓòÉ
Use the Storage window to view and update the contents of the storage used by
your program. The following storage data is displayed in the Storage window:
o Fields for the displayed addresses. You can select one of the following
storage models for the addresses that are displayed:
- 16:16 (segmented) storage addresses
- Flat storage model addresses
- Both 16:16 and flat storage model addresses.
o Fields for the data storage contents. The number of fields displayed and
their display characteristics depend on the storage style you select.
Storage can be displayed in various styles. You can display only one storage
style at a time.
o Titles for the displayed addresses and storage content fields.
You can open multiple storage windows to view different storage locations at
the same time. When the state of your program changes, the contents of the
Storage window is updated to reflect the change.
To scroll through memory, use one of the following methods:
o Scroll bars
o Up and Down cursor keys
o PageUp and PageDown keys.
The address of the cursor is displayed in the title bar of the Storage window.
You can update the contents of storage, or you can view the contents of storage
at a new address location. Double-click on one of the following topics to find
out how to update the contents of storage or specify a new address location:
o Updating storage
o Specifying address location.
To view a variable in storage:
1. Determine the storage address of a variable by monitoring its address. For
example, to find out the address of a variable VAR, select Monitor
expression from the Variable menu and type "&VAR" into the Expression entry
field.
2. The monitor window that displays this expression will show a pointer with
an address.
3. Open a storage window by selecting Storage from the Window menu or
selecting the Storage button in the title bar. Type over the address field
and enter the address of the variable shown by the pointer in the monitor
window. The Storage window will scroll to that address, and the contents of
storage at that address will be the value of the variable VAR.
4. If you also put the variable VAR in the monitor window, you can update the
variable and watch the storage location change, or update the storage
location and watch the variable's value change.
Menu Bar Summary
Options
Set options that control how the storage content and addresses are displayed
and display additional storage window control attributes.
Help
You have access to several kinds of help information that compliment the
online help information that you can get for the debugger. Press F1 or
select the Help push button.
ΓòÉΓòÉΓòÉ 10.1. Storage Display Styles ΓòÉΓòÉΓòÉ
Storage can be displayed in the following address styles:
o Flat and 16:16
o Flat only
o 16:16 only.
Storage can be displayed in the following value styles:
o Hexadecimal and character text
o Character text
o 16-bit integer
o 16-bit unsigned integer
o 16-bit integer in hexadecimal (byte reversed)
o 32-bit integer
o 32-bit unsigned integer
o 32-bit integer in hexadecimal (byte reversed)
o 32-bit floating point
o 64-bit floating point
o 80-bit floating point
o 16-bit near pointers
o 16:16-bit far pointers
o 32-bit flat pointers.
You can also change the number of bytes per line that are displayed. This
number varies depending on the content style you have selected.
ΓòÉΓòÉΓòÉ 10.2. Updating Storage ΓòÉΓòÉΓòÉ
To update the contents of storage, type over the current contents in the
storage field.
The contents of storage are updated when an elapsed time of one second occurs
after the last keystroke has been entered.
ΓòÉΓòÉΓòÉ 10.3. Specifying Address Location ΓòÉΓòÉΓòÉ
To view the storage at a different address, type over the contents of the
address field with the new address. You can choose to update either the Flat
address field or the 16:16 (segmented) address field.
The contents of the address are updated when an elapsed time of one second
occurs after the last keystroke has been entered. The Storage window is
scrolled to the appropriate address.
ΓòÉΓòÉΓòÉ 10.4. Options Menu ΓòÉΓòÉΓòÉ
Select choices from the Options menu to control how the storage contents and
addresses are displayed, control the display of the storage window control
attributes, and end your debugging session.
Menu Summary
Window settings
Change the storage display format.
Debug session control
Display the Debug Session Control window.
Close debug
End your debugging session.
ΓòÉΓòÉΓòÉ 10.4.1. Window Settings Choice ΓòÉΓòÉΓòÉ
Select the Window settings cascaded choice to change the context and address
style of the Storage window.
Menu Summary
Content style
Select the display format for the storage contents.
Address style
Select the display format for storage addresses.
Window control
Control the display of the horizontal scroll bar and the headings in the
Storage window.
Fonts
Change the font used to display text in the Storage window.
ΓòÉΓòÉΓòÉ 10.4.2. Content Style Choice ΓòÉΓòÉΓòÉ
Select the Content choice to select the display format for the storage
contents. You can select from several storage display styles.
When you select the Content choice, the Storage Content Style action window is
displayed.
ΓòÉΓòÉΓòÉ 10.4.3. Address Style Choice ΓòÉΓòÉΓòÉ
Select the Address choice to display the format of the storage addresses.
Storage can be displayed in the following address styles:
o Flat and 16:16
o Flat only
o 16:16 only.
When you select the Address choice, the Storage Address Style action window is
displayed.
ΓòÉΓòÉΓòÉ 10.4.4. Window Controls Choice ΓòÉΓòÉΓòÉ
Select the Display window controls choice to select the options that control
the display of :
o Titles in the Storage window
o The horizontal scroll bar.
When you select the Display window controls, the Storage Window Controls action
window is displayed.
ΓòÉΓòÉΓòÉ 10.4.5. Storage Window Controls Action Window ΓòÉΓòÉΓòÉ
Use the Storage Window Controls action window to control the display of the
horizontal scroll bar and the titles in the Storage window.
After you have finished selecting the options from the Storage Window Controls
action window, select one of the push buttons.
Display
Select the following check boxes to control the display of the horizontal
scroll bar and the titles in the Storage window:
Horizontal scroll bars
Select this check box to display the horizontal scroll bar.
Titles
Select this check box to display the column titles in the Storage window.
Save settings
Select the Save settings check box to save the selections you make in this
action window for the next debugging session.
ΓòÉΓòÉΓòÉ 10.4.6. Storage Content Style Action Window ΓòÉΓòÉΓòÉ
Use the Storage Content Style action window to select the parameters that
control how the storage contents are displayed.
When you are finished, select the appropriate push button.
Style
You can select from the following storage value styles:
o HEX and character
o Character
o 16-bit integer
o 16-bit unsigned integer
o 16-bit integers in HEX
o 32-bit integer
o 32-bit unsigned integer
o 32-bit integers in HEX
o 32-bit float
o 64-bit float
o 80-bit float
o 16-bit near pointers
o 16:16-bit far pointers
o 32-bit flat pointers.
To select a value style:
1. Select the arrow to open the Style list.
2. Highlight the value style.
The value style you highlighted is placed in the Style entry field.
Bytes per line
You can set the number of bytes per line. The available choices for the number
of bytes per line you can display vary with the storage content style you
select.
To select the number of bytes per line:
1. Select the arrow to open the Bytes per line list.
2. Highlight the number of bytes per line you want to select.
The number of bytes per line you highlighted is placed in the Bytes per
line entry field.
Save settings
Select the Save settings check box to save the selections you make in this
action window for the next debugging session.
ΓòÉΓòÉΓòÉ 10.4.7. Storage Address Style Action Window ΓòÉΓòÉΓòÉ
Use the Storage Address Style action window to set the storage addresses are
displayed.
When you are finished, select the appropriate push button.
Style
You can select from the following address styles:
o Flat and 16:16 (segmented)
o Flat only
o 16:16 only.
To select an address style:
1. Select the arrow to open the Style list.
2. Highlight the address style.
The address style you highlighted is placed in the Style entry field.
Save settings
Select the Save settings check box to save the selections you make in this
action window for the next debugging session.
ΓòÉΓòÉΓòÉ 10.4.8. Push Buttons ΓòÉΓòÉΓòÉ
OK
Click on OK to accept the information you have entered and to close this
action window.
Reset
Click on Reset to clear any changes you have made in this session.
Default
Click on Default to replace the current default display style with the
debugger default display style.
Cancel
Click on Cancel to close this action window.
Help
Click on Help to display Help information that tells you how to use this
action window.
ΓòÉΓòÉΓòÉ 11. Register Window ΓòÉΓòÉΓòÉ
Use the Register window to view or modify the contents of the registers
monitored for your program. One set of processor registers exists for each
thread.
In the Register window, floating point registers are displayed as floating
point decimal numbers. They can be updated with a floating point decimal
number or with a hexadecimal string that represents a floating point number.
Menu Bar Summary
Options
Change the font used for the text displayed in the Register window, display
other debugger windows, and end your debugging session.
Help
Provides you with online help information that compliments the online help
that you can when you press F1 or select a Help pushbutton.
ΓòÉΓòÉΓòÉ 11.1. Options Menu ΓòÉΓòÉΓòÉ
Select the Options menu-bar choice to change the fonts used for the text
displayed in the Register window, set debugger options, and end the debugging
session.
Menu Summary
Fonts
Change the fonts for the text displayed in the Register window.
Where
Open a program view containing the next line to be executed.
Debug session control
Display the Debug Session Control window.
Close debug
End your debugging session.
ΓòÉΓòÉΓòÉ 12. Stack Window ΓòÉΓòÉΓòÉ
The Stack window lists all of the active functions for a particular thread,
including PM calls. The functions are displayed in the order that they were
called. Each Stack window displays call stack information for one thread only.
When the state of the program changes (as you execute the program, or you
update displayed data) the Stack window is updated to reflect the current
state. You can double-click on any call stack entry to display the source for
that entry. The line that calls the next stack entry is highlighted.
Menu Bar Summary
File
Open a program view of your program and end your debugging session.
Options
Select the font you want to use for the text displayed in the Stack window,
select the parameters that control how the items on the stack are displayed.
Help
Provides you with online help information that compliments the online help
you can get when you press F1 or select a Help push button.
ΓòÉΓòÉΓòÉ 12.1. File Menu ΓòÉΓòÉΓòÉ
Select the File menu choice to open different views of your program and to end
your debugging session.
Menu Summary
View
Open a program view of the highlighted call stack item.
Where
Open a program view containing the next line to be executed.
Close debug
End your debugging session.
ΓòÉΓòÉΓòÉ 12.2. Options Menu ΓòÉΓòÉΓòÉ
Select the Options menu choice to control how the items on the stack are
displayed, and to set various debugger options.
Menu Summary
Window settings
Control how the items on the call stack are displayed.
Debug session control
Display the Debug Session Control window.
ΓòÉΓòÉΓòÉ 12.2.1. Window Settings Choice ΓòÉΓòÉΓòÉ
Select choices from the Window settings cascaded menu to change the font for
the Stack window and to select the information that is displayed for the items
on the call stack.
Menu Summary
Display style
Control how the items on the stack are displayed.
Fonts
Select the font you want to use for the text displayed in the Stack window.
ΓòÉΓòÉΓòÉ 12.2.2. Display Style Choice ΓòÉΓòÉΓòÉ
Select the Display style cascaded choice to control how the items on the stack
are displayed. You can select the type of information you want displayed for
all of the stack items and you can choose to display new stack items on the top
or the bottom of the stack.
When you select the Display style choice, the Display Style action window
appears.
ΓòÉΓòÉΓòÉ 12.3. Display Style Action Window ΓòÉΓòÉΓòÉ
Use the Display Style action window to control how the items on the stack are
displayed. You can select the type of descriptive information you want
displayed for all of the call stack items. You can also choose to display new
call stack items on the top or the bottom of the stack.
To change how stack items are displayed:
1. Select one or more of the check boxes under Items to select the information
you want displayed for each stack entry.
2. Select one Growth radio button to display new call stack items at the top
of the stack or at the bottom of the stack.
3. Select one of the push buttons to finish your dialog.
Items
Select one or more of these check boxes to select the information you want
displayed for each stack entry:
Entry number The entry number represents the position of the call
stack item in the list. Entry level 1 is the first
function invoked.
Function The name of the program or the address of the function
call that created the new stack entry.
Source The name of the component that contains the function. The
name displayed corresponds with a name listed in the
Components list box in the Debug Session Control window.
Recursion level Recursion level 0 is the first invocation.
Growth direction
Select a radio button to display new stack items at the top or the bottom of
the stack window:
Up Displays new stack items at the top of the stack window.
Down Displays new stack items at the bottom of the stack window.
Save window settings
Select the Save window settings check box to save the selections you made in
this action window for this debugging sessions.
ΓòÉΓòÉΓòÉ 13. 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 is updated with the new local variables.
For more information about manipulating the variable monitors, double-click on
Using the data popup and monitor windows .
You can select the variables or expressions you want to display from a window:
o Using the mouse
o Using the mouse and the Monitor action window
o Using the keyboard.
You must select an expression with:
o A valid operand type
o A valid operator
o A valid typecasting operation
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 data pop-up window.
Menu Bar Summary
Edit
Edit text and search for strings in the text.
Options
Control how the contents of variables are displayed, to set the debugger
options, and end your debugging session.
Help
Provides you with online help information that compliments the online help
you can get when you press F1 or click on a Help push button.
ΓòÉΓòÉΓòÉ 13.1. Edit Menu ΓòÉΓòÉΓòÉ
Select choices from the Edit menu to copy and place items into the clipboard,
locate the next line to be executed and close the debugger.
Menu Summary
Copy
Copy text into the clipboard.
Paste
Places the contents of the clipboard at the current cursor position.
Where
Open a program view containing the next line to be executed.
Close debug
Close the debugging session.
ΓòÉΓòÉΓòÉ 13.1.1. Copy Choice ΓòÉΓòÉΓòÉ
Select the Copy choice to copy text and place it into the clipboard. To copy
the text:
o Highlight the text you want to copy and select the Copy choice or press
Ctrl+Ins
ΓòÉΓòÉΓòÉ 13.1.2. Paste ΓòÉΓòÉΓòÉ
Select the Paste choice to copy from the clipboard into a new location. To
paste the text:
o Select the location where you want the text to appear and select the Paste
choice or press Shift+Ins.
ΓòÉΓòÉΓòÉ 13.2. Options Menu ΓòÉΓòÉΓòÉ
Select choices from the Options menu to control how the contents of variables
are displayed and to set the debugger options.
Menu Summary
Fonts
Select the font you want to use for the text displayed in the Local Variables
Monitor window.
Representation
Display the contents of a monitored variable in a different format.
Select all
Select all expressions.
Deselect all
Deselect all expressions.
Delete
Delete all the selected expressions.
Show context
Display the contextual information for all selected expressions.
Hide context
Prevent the display of contextual information for all selected expressions.
Debug session control
Displays the Debug Session Control window.
ΓòÉΓòÉΓòÉ 13.2.1. Representation Cascading Choice ΓòÉΓòÉΓòÉ
Select the Representation cascading choice to display the contents of the
variable in a new representation. The types of representation that are
displayed 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 are displayed as either a floating
point decimal number or 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 view to see when
the variable is loaded into a register and change the value in the Register
window at that time.
ΓòÉΓòÉΓòÉ 13.2.2. 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.
ΓòÉΓòÉΓòÉ 13.2.3. Select All Choice ΓòÉΓòÉΓòÉ
Select the Select all choice to select all the expressions in the window.
ΓòÉΓòÉΓòÉ 13.2.4. Deselect All Choice ΓòÉΓòÉΓòÉ
Select the Deselect all choice to cancel the selection of all the expressions
in the window.
ΓòÉΓòÉΓòÉ 14. Program Monitor Window ΓòÉΓòÉΓòÉ
Use the Program Monitor window to collect variables or expressions that want
you monitor. This window is not associated with any specific program view
window and remains open at all times unless explicitly closed by the user.
For more information about manipulating the variable monitors, double-click on
Using the data popup and monitor windows
You can select the variables or expressions you want to display:
o Using the mouse
o Using the mouse and the Monitor action window
o Using the keyboard.
You must select an expression with:
o A valid operand type
o A valid operator
o A valid typecasting operation
Menu Bar Summary
Edit
Copy to the clipboard and paste to the clipboard.
Options
Modify the style of monitoring and the presentation of variables and
expressions
Help
Provides you with online help information that compliments the online help
you can get when you press F1 or select a Help pushbutton.
ΓòÉΓòÉΓòÉ 14.1. Options Menu ΓòÉΓòÉΓòÉ
Select choices from the Options menu to change the representation of a variable
or expression, delete a variable or expression from the Program Monitor window,
control the updating of the displayed contents, display context, and change the
font for the text displayed in this window.
Menu Summary
Fonts
Select the font you want to use for the text displayed in the Program Monitor
window.
Representation
Display the contents of a monitored variable or expression in a different
representation.
Select all
Select all expressions.
Deselect all
Deselects all expressions.
Delete all
Delete all the expressions.
Delete
Delete all of the selected data items that are being monitored.
Enable
Displays the contents of a variable or expression as it is updated.
Disable
Prevent the displayed contents of a variable or expression from being
updated.
Show context
Display the contextual information for a variable or expression being
monitored.
Hide context
Prevent the contextual information for a monitored variable or expression
from being displayed.
Debug session control
Display the Debug Session Control window.
Close debug
Close the debugging session.
ΓòÉΓòÉΓòÉ 14.1.1. Delete Choice ΓòÉΓòÉΓòÉ
Select the Delete choice to delete variables or expressions that are being
monitored from a monitor window.
To delete a variable or expression from a monitor window:
1. Select the variable or expression with your mouse. The monitor for the
variable or expression is highlighted.
2. Select the Delete choice from the Options menu.
ΓòÉΓòÉΓòÉ 14.1.2. Delete All Choice ΓòÉΓòÉΓòÉ
Select the Delete all choice to delete all the variables or expressions that
are being monitored from a monitor window.
To delete the variables or expressions from a monitor window, select the Delete
all choice from the Options menu.
ΓòÉΓòÉΓòÉ 15. 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 program view window
and closes when the associated program view window is closed.
For more information about manipulating the variable monitors, double-click on
Using the data popup and monitor windows
You can select the variables or expressions you want to display from a window:
o Using the mouse
o Using the mouse and the Monitor action window
o Using the keyboard.
You must select an expression with:
o A valid operand type
o A valid operator
o A valid typecasting operation
Menu Bar Summary
Edit
Copy to the clipboard and paste to the clipboard.
Options
Modify the style of monitoring and the presentation of variables and
expressions.
Help
Provides you with online help information that compliments the online help
you can get when you press F1 or select a Help push button.
ΓòÉΓòÉΓòÉ 15.1. Options Menu ΓòÉΓòÉΓòÉ
Select choices from the Options menu to change the representation of a variable
or expression, delete a variable or expression from the Private Monitor window,
control the updating of the displayed contents, display context, and change the
font for the text displayed in this window.
Menu Summary
Fonts
Select the font you want to use for the text displayed in the Private Monitor
window.
Representation
Display the contents of a monitored variable or expression in a different
representation.
Select all
Select all expressions.
Deselect all
Deselects all expressions.
Delete all
Delete all the expressions.
Delete
Delete a selected data item that is being monitored.
Enable
Displays the contents of a variable or expression as it is updated.
Disable
Prevent the displayed contents of a variable or expression from being
updated.
Show context
Display the contextual information for a variable or expression being
monitored.
Hide context
Prevent the contextual information for a monitored variable or expression
from being displayed.
ΓòÉΓòÉΓòÉ 16. Data Popup Window ΓòÉΓòÉΓòÉ
The Data Popup window displays the variable or expression you select for
monitoring. It is associated with a specific program view window and closes
when the associated window is closed.
For more information about manipulating the variable monitors, double-click on
Using the data popup and monitor windows
You can select the variables or expressions you want to display:
o Using the mouse
o Using the mouse and the Monitor action window
o Using the keyboard.
You must select an expression with:
o A valid operand type
o A valid operator
o A valid typecasting operation
Menu Bar Summary
Edit
Copy to the clipboard and paste to the clipboard.
Options
Transfer a variable to the Private Monitor or the Program Monitor window,
select the length of time a variable is monitored, and control how the
contents of the variable are displayed.
Help
Provides you with online help information that compliments the online help
you can get when you press F1 or select a Help push button.
ΓòÉΓòÉΓòÉ 16.1. Edit Menu ΓòÉΓòÉΓòÉ
Select choices from the Edit menu to copy and place selected items into the
clipboard and locate the next line to be executed.
Menu Bar Summary
Copy
Copy text into the clipboard.
Paste
Places the contents of the clipboard at the current cursor position.
Where
Open a program view containing the next line to be executed.
ΓòÉΓòÉΓòÉ 16.2. Options Menu ΓòÉΓòÉΓòÉ
Select choices from the Options menu to control how the contents of the
monitored variable are displayed, the updating of the displayed contents, the
length of time that the Data Popup window remains open, and the window to which
you can transfer the variable.
Menu Summary
Fonts
Choose the font for the text displayed in the Data Popup window.
Representation
Change the representation of the displayed contents.
Enabled
Control the updating of the displayed contents.
Show Context
Display the contextual information for a variable.
Duration
Select when the Data Popup window is dismissed.
Transfer to
Transfer the variable to the Program Monitor window or the Private Monitor
window.
ΓòÉΓòÉΓòÉ 16.2.1. Enabled Choice ΓòÉΓòÉΓòÉ
Select the Enabled choice to update the displayed value of the variables or
expressions you are monitoring as the state of the program changes. The Enabled
choice is selected when √ is displayed. To disable the variable, select the
Enabled menu choice again, to remove √.
ΓòÉΓòÉΓòÉ 16.2.2. Enable Choice ΓòÉΓòÉΓòÉ
Select the Enable choice to have the displayed contents of a variable or
expression updated as the state of the program changes.
ΓòÉΓòÉΓòÉ 16.2.3. Disable Choice ΓòÉΓòÉΓòÉ
Select the Disable choice to prevent the displayed contents of a variable or
expression from being updated as the state of the program changes.
ΓòÉΓòÉΓòÉ 16.2.4. Duration Choice ΓòÉΓòÉΓòÉ
Select the Duration choice to set the conditions under which the Data Popup
window is dismissed.
Menu Summary
Step/run
The monitor window closes when the next step command or Run is executed.
New source
The monitor window closes when a new object file is entered.
Permanent
The monitor window stays open for the remainder of the debugging session.
ΓòÉΓòÉΓòÉ 16.2.5. Step/Run Choice ΓòÉΓòÉΓòÉ
Select the Step/run choice to close the Data Popup window the next time a step
command or Run is executed.
ΓòÉΓòÉΓòÉ 16.2.6. New Source Choice ΓòÉΓòÉΓòÉ
Select the New source choice to close the Data Popup window when the current
line moves to a different part of the program.
ΓòÉΓòÉΓòÉ 16.2.7. Permanent Choice ΓòÉΓòÉΓòÉ
Select the Permanent choice to cause the Data Popup window to remain open for
the remainder of the debugging session.
ΓòÉΓòÉΓòÉ 16.2.8. Transfer to Choice ΓòÉΓòÉΓòÉ
Select the Transfer choice to move the variable or expression you are
monitoring to the Private Monitor or Program Monitor window. Any variable or
expression can be transferred to either the Private Monitor window or to the
Program Monitor window. It does not matter whether the variable or expression
is used throughout the program. The Private Monitor window, however, is a
secondary window to the program view window for which it was opened. It closes
when its associated program view window closes. You should, therefore, monitor
local variables in the Private Monitor window, and monitor global variables in
the Program Monitor window.
Menu Summary
Private monitor
Move the variable or expression you are monitoring to the Private Monitor
window.
Program monitor
Move the variable or expression you are monitoring to the Program Monitor
window.
ΓòÉΓòÉΓòÉ 16.2.9. Private Monitor Choice ΓòÉΓòÉΓòÉ
Select the Private monitor choice to move the variable or expression you are
monitoring to the Private Monitor window.
ΓòÉΓòÉΓòÉ 16.2.10. Program Monitor Choice ΓòÉΓòÉΓòÉ
Select the Program monitor choice to move the variable or expression you are
monitoring to the Program Monitor window.
ΓòÉΓòÉΓòÉ 16.2.11. Data Manipulation Icons ΓòÉΓòÉΓòÉ
You can select any of the following icons from any monitor window (Program,
Private, Data Popup, or Local Variables) to manipulate the data parts of
variables:
Expands the contracted parts of an array.
Expands the contracted parts of a structure.
Expands the contracted parts of a class.
Contracts the parts of an array, structure or class that has been
expanded.
Displays the object referenced by a pointer in a new monitor.
The four windows to monitor variables and expressions are:
o Program Monitor
o Private Monitor
o Data Popup
o Local Variables Monitor
ΓòÉΓòÉΓòÉ 16.2.12. Show Context Choice ΓòÉΓòÉΓòÉ
Select the Show context choice to display contextual information for the
variables you are monitoring. The following information is displayed:
o Source
o File
o Line
o Thread.
The Show context choice is selected when √ is displayed. To hide the contextual
information, select the Show context choice again to remove √.
ΓòÉΓòÉΓòÉ 16.2.13. Show Context Choice ΓòÉΓòÉΓòÉ
Select the Show context choice to display the contextual information for the
variable you are monitoring. The following information is displayed:
o Source
o File
o Line
o Thread.
ΓòÉΓòÉΓòÉ 16.2.14. Hide Context Choice ΓòÉΓòÉΓòÉ
Select the Hide context choice to hide the contextual information for the
variable you are monitoring.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
Trademark of IBM
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
There are two wait states in the debugger.
When the debugger is busy doing something, it displays a clock icon. This icon
will disappear 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.