OS/2 Professional Developers Kit 1992 November/Disc01/Disc01.mdf/cppbeta/pmd/dde4help.hl_/DDE4HELP.HLP

OS/2 Help File | 1992-09-26 | 102.4 KB | 3,975 lines

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

References in this publication 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.

Trademarks and Service Marks

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

o C Set/2

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 Event breakpoint
o Location breakpoint
o Local variable
o Program part
o Recursion level
o Shortcut keys
o Stopping thread
o Storage
o Synchronous
o Tag word
o Thread.


ΓòÉΓòÉΓòÉ 2.1. Shortcut keys: Definition ΓòÉΓòÉΓòÉ

Shortcut keys are the keyboard keys that you use to to invoke the pull-down
choices.


ΓòÉΓòÉΓòÉ 2.2. Asynchronous: Definition ΓòÉΓòÉΓòÉ

When the C Set/2* debugger is operating in asynchronous mode, the messages that
are passed between PM applications, including the C Set/2* debugger, are not
answered in the order that they occur. All PM messages are passed to the C
Set/2* debugger, which answers the messages with a simple generic response When
you are running the C Set/2* debugger in asynchronous mode, other PM
applications running in the system do not halt when the debugger stops.


ΓòÉΓòÉΓòÉ 2.3. Automatic variable: Definition ΓòÉΓòÉΓòÉ

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.4. Local variable: Definition ΓòÉΓòÉΓòÉ

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

A breakpoint is a defined location or condition in a program that, when it is
met, stops the execution of the program. You can set and clear breakpoints.


ΓòÉΓòÉΓòÉ 2.6. Event breakpoint: Definition ΓòÉΓòÉΓòÉ

An event breakpoint stops the execution of a program when a specified type of
event occurs during the execution of the program. An event occurs when:

o The named dynamic load library is loaded
o A given range of memory changes.


ΓòÉΓòÉΓòÉ 2.7. Stopping thread: Definition ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 2.8. Location breakpoint: Definition ΓòÉΓòÉΓòÉ

A location breakpoint stops the execution of a program at a specific statement
in the program. These statements can be:

o A specific line
o A specific instruction address
o The entry point to a specific routine.


ΓòÉΓòÉΓòÉ 2.9. Program part: Definition ΓòÉΓòÉΓòÉ

A program part is a function or a collection of functions that is contained in
a single object (.obj) file and the corresponding source file.


ΓòÉΓòÉΓòÉ 2.10. Recursion level: Definition ΓòÉΓòÉΓòÉ

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 can repeat itself indefinitely or until a specified condition is met.


ΓòÉΓòÉΓòÉ 2.11. Storage: Definition ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 2.12. Synchronous: Definition ΓòÉΓòÉΓòÉ

When the C Set/2* debugger is operating in synchronous mode, the messages that
are passed between PM applications are answered in the order that they occur.
Messages are not lost. The messages that are passed within the C Set/2*
debugger take priority over any other messages that are passed in the system.
They are answered before any other messages.


ΓòÉΓòÉΓòÉ 2.13. Tag word: Definition ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 2.14. Thread: Definition ΓòÉΓòÉΓòÉ

A thread is the basic OS/2 unit of execution.  A thread gives a program its
context, including registers, stack, and CPU mode. Multiple threads can be
running at the same time, and any particular thread can start another thread.


ΓòÉΓòÉΓòÉ 3. Debug Session Controls ΓòÉΓòÉΓòÉ

The Debug Session Controls 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 list box contains the threads and the state of the threads that
have been started by your program.  To view the state of a thread, click on the
plus icon in front of the thread. You  enable or disable the thread highlighted
in the Threads list by toggling the Enabled choice from the Thread pull-down.
When a checkmark is displayed, threads are enabled and and the debugger allows
the highlighted thread to execute.  When the checkmark is not displayed.
threads are disabled.

The Component list box contains the EXE and DLL files that are in the program
you are debugging. These files are called executable files. If you click on the
plus icon in front of the executable file it will expand to show the objects
that make up the executable file. If you click on the plus icon in front of the
object name, the entries will be displayed that make up the object.  This
allows you to view all the components that exist in your program. You can view
any component by double-clicking on the name of the component displayed in the
Component list box, or by highlighting the component and selecting a view from
the Open as cascading pull-down in the File pull-down.  The view that is
displayed is determined by the display order and is specific to the thread
highlighted in the Threads list box.

You specify which components are displayed in the Component list by selecting
Options  Window Settings  Display all components.  If this option is not
enabled, only components containing debug information are listed.  Otherwise,
all components are listed.

You can also access any debugger window that is already open and hidden or
iconized by selecting the pull-down choice that displays that window.

Menu Bar Summary

File
  Start and end a C Set/2* debugger session, and control the way in which
  commands and program units are accessed by the C Set/2* debugger.

Breakpoints
  Set and manipulate breakpoints in your programs.

Thread
  Control whether or not a thread is executed when you run the program, and
  display information about the current program and environment.

Options
  Access various utility dialog boxes where you can set debugger options. These
  debugger options control how the components of your program are displayed and
  how your program executes.

Help
  You have access to several kinds of help information that complement the
  online help information that you can get for the debugger.  Press F1 or click
  on a Help pushbutton.


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

Select choices from the File pull-down to start and end a C Set/2* debugger
session and to control the way in which commands and program units are accessed
by the C Set/2* debugger.

Pull-Down Summary

Open as
  Select a particular view for the selected component.

Inheritance
  Display the class hierarchy of a C++ program.

ftype=hd refid='PM_03_FRMEFILE_START'.Startup
  Start the program you want to debug after saving and terminating the
  debugging session.

Restart
  Save and terminate the current program you are debugging, and restore the
  saved environment at the beginning of the program.

Close debug
  End the debugging session.


ΓòÉΓòÉΓòÉ 3.1.1. Where ΓòÉΓòÉΓòÉ

Select the Where pull-down choice to quickly locate the next line to be
executed in the thread. When you select Where, the line is placed at the top of
the view with the highest display order, and this view becomes the active view.
(You select the display order in the Display Order dialog box.)


ΓòÉΓòÉΓòÉ 3.1.2. Startup ΓòÉΓòÉΓòÉ

Select the Startup pull-down choice to start a program for debugging. You can
select Startup 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 dialog box appears.


ΓòÉΓòÉΓòÉ 3.1.3. Restart ΓòÉΓòÉΓòÉ

Select the Restart pull-down choice to save and terminate the current program,
and prepare the program for execution from the beginning with the following
items restored:

o Breakpoints
o Monitors (registers, stack, storage, data pop-up windows)
o Monitor list information (program, private, and local variables).

Note:  Only information relating to the primary thread is restored (for
executable files and pre-loaded DLLs).


ΓòÉΓòÉΓòÉ 3.1.4. Part - Filename Specifications ΓòÉΓòÉΓòÉ

The Part - Filename Specifications dialog box appears when you try to open a
component for which you have debug information, but the debugger cannot locate
the source code.

To use the Part - Filename Specifications dialog box:

 1. If the source code is located in another directory on the system, type in
    the fully qualified path name and click on OK.

 2. If you do not have the source code for this component, click on Cancel. The
    Disassembly view is opened for this component.


ΓòÉΓòÉΓòÉ 3.2. Startup Information ΓòÉΓòÉΓòÉ

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

To use the Startup Information dialog box:

 1. If you are not going to select the Use restart information check box, type
    the name of the program you want to start in the Program entry field, or
    open the Program and select the program name. (If you type in the name, it
    must be the full path name of the file if you have not set the PMDPATH
    search order, or if the program is not in your current directory.)

    If you are going to select Use restart information:

    a. Select the arrow to open the Program list.

    b. Select the fully qualified program name that defines the program you
       want to restart. The programs listed are those for which restart
       information has been saved.

       Note:  Restart information is saved with a time stamp. A time stamp
       check is done before the program is started with restart information.

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

 3. Select the Use restart information check box to restart the previous
    debugging session for the program.

 4. Select Debug application initialization to debug any initialization
    routines that you have written.

 5. Select the Save session settings check box to save your selections for the
    next debugging session.

 6. Click on one of the  pushbuttons to finish your dialog.

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 initialization 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 previous debugging
session with breakpoints, monitor lists, data pop-up windows, and displays for
any of the Thread  Show pull-down choices.

Debug application initialization

Select Debug application initialization to halt execution of the application
before any initialization routines that you have written are executed. If you
select Debug application initialization, the initial program view is the
run-time library initialization routine.

Save session settings

Select the Save session settings check box to save your selections for the next
debugging session.


ΓòÉΓòÉΓòÉ 3.2.1. Pushbuttons ΓòÉΓòÉΓòÉ

OK
  Click on OK to accept the information you have entered and close this dialog
  box.

Cancel
  Click on Cancel to close this dialog box.

Help
  Click on Help to display help information that tells you how to use this
  dialog box.


ΓòÉΓòÉΓòÉ 3.2.2. Time Stamp Check ΓòÉΓòÉΓòÉ

Information that is saved for restart 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.

Click on Ignore from the message box to start the program without the restart
information, click on OK to load the program with the restart information that
is available, or click on Cancel to cancel the startup process and return to
the Debug Session Controls window.

If the source has been changed but not compiled, breakpoints might be invalid
or appear on the wrong line.


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

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 in the Source, Disassembly, or Mixed view. When you set
a breakpoint in one view of your program, it is reflected in one of the
appropriate views.

Two types of breakpoints are provided by the C/Set Debugger: location and
event.  You customize breakpoints using the breakpoints dialog boxes.

Select the Set pull-down choice to set location breakpoints and event
breakpoints. Set simple line breakpoints using the mouse.

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.

Pull-Down Summary

Set
  Set any kind of location or event breakpoints.

List
  List and manipulate the breakpoints that are already set.


ΓòÉΓòÉΓòÉ 3.3.1. Setting Simple Line Breakpoints ΓòÉΓòÉΓòÉ

To set a simple line breakpoint, 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.


ΓòÉΓòÉΓòÉ 3.3.2. Clearing Simple Line Breakpoints ΓòÉΓòÉΓòÉ

To remove a simple line breakpoint, double-click in a red prefix area of the
Source, Disassembly, or Mixed view. The red disappears indicating that the
breakpoint has been cleared. If the prefix area turns grey instead,
double-click again to make sure the breakpoint is cleared.


ΓòÉΓòÉΓòÉ 3.3.3. Set ΓòÉΓòÉΓòÉ

Select the Set pull-down choice to set any location or event breakpoints. When
you select Set, the Set/Modify Breakpoint dialog box appears.  If you highlight
a line number (in the Source or Mixed view) or an address (in the Disassembly
or Mixed view) before selecting Set, the line number or address is
automatically placed in the Set/Modify dialog box.


ΓòÉΓòÉΓòÉ 3.3.4. List ΓòÉΓòÉΓòÉ

Select the List pull-down choice to display a scrolling list of the breakpoints
that have been set in your program. Each breakpoint entry displayed in the List
dialog box contains the following information.

o The enablement state
o The type of breakpoint
o The position of the breakpoint (program name, line number, or address)
o The conditions under which the breakpoint is activated.


ΓòÉΓòÉΓòÉ 3.3.5. Set/Modify Breakpoint ΓòÉΓòÉΓòÉ

Use the Set/Modify Breakpoint dialog box to set any kind of breakpoint or to
modify breakpoints that already exist. You can set location or event
breakpoints in all of the active threads or only specific active threads. When
a breakpoint is set at a particular location in a program view, it is reflected
in all views of the same program. Breakpoints can be thread-specific or can be
applied to all threads.

Note:  When you modify an existing breakpoint, the breakpoint is automatically
enabled.

Breakpoints are set when you click on either the Set or the OK pushbutton in
the Set/Modify Breakpoint dialog box. (If you click on Set to set the
breakpoint, you must click on Cancel to close the dialog box.) The execution of
your program stops only when the conditions that satisfy the breakpoint are
met.

To apply the breakpoint, the debugger checks the Every, From, and To conditions
first. When these conditions are met, the other conditions you selected in the
Set/Modify Breakpoint dialog box are checked.

After you have finished updating the fields you require, click on the
appropriate pushbuttons to complete your dialog.

Note:  If you set a breakpoint using the Set pushbutton, you must click on
Cancel to close the dialog box.

For a description of types of data you are required to enter in this dialog
box, double-click on one of the following topics:

o Type
o Parameters
o Line number
o Part
o View
o Condition
o Thread id
o Every
o From
o To


ΓòÉΓòÉΓòÉ 3.3.6. Type ΓòÉΓòÉΓòÉ

You can set location or event breakpoints. To select the breakpoint:

 1. Select the arrow with your mouse to open the Type list and display the
    types of breakpoints available.

 2. Highlight the type of breakpoint you want.

The default type is Line.


ΓòÉΓòÉΓòÉ 3.3.7. Parameters ΓòÉΓòÉΓòÉ

If you are setting a location breakpoint, other than a line breakpoint, type
the parameter that corresponds to the type of location breakpoint you are
setting:

Address   Type the hexadecimal address.

          The following diagram shows the syntax of the parameters you can type
          for an address breakpoint:

ΓöÇΓöÇΓöÇΓöÇaddress_specΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ

where address_spec is:

ΓöÇΓöÇΓö¼ΓöÇhhhh:hhhhΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
   Γöé           Γöé
   ΓööΓöÇhhhhhhhhΓöÇΓöÇΓöÿ

          Address Example:

          You would type the following in the Parameters entry field to set an
          address breakpoint when the address 000A1FCC is encountered:

                    000A1FCC

Entry     Type the name of the routine or component.

          If an entry is an overloaded entry, then a container appears with a
          list of all the overloaded entriesnames.  Select one of the entries
          from the list.

          Entry Example:

          You would type the following in the Parameters entry field to set an
          entry breakpoint when the module my_func is entered:

                    my_func

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


If you are setting an event breakpoint, type in the parameter that corresponds
to the type of event breakpoint you are setting:

Load
          Type the name of the DLL. Execution stops when the DLL is loaded.

          The following diagram shows the syntax of the parameters you can type
          for a load breakpoint:

ΓöÇΓöÇΓöÇΓöÇmod_nameΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ

          Load Example:

          You would type the following in the Parameters entry field to set a
          load breakpoint when the DLL DDE4CRT is loaded:

                    DDE4CRT

Change - Address
          Type a hexadecimal address followed by the range of bytes. The range
          of bytes can be one of the numbers:1, 2, or 4. Place a comma between
          the hexadecimal address and the number that indicates the byte range.
          The 2-byte range must be aligned on a word boundary and the 4-byte
          range must be aligned on a doubleword boundary. Only addresses that
          are multiples of 4 are valid arguments as Change - Address
          breakpoints.

          Execution stops when the specified range of memory changes.

          The following diagram shows the syntax of the parameters you can type
          for a change - address breakpoint:

ΓöÇΓöÇΓöÇΓöÇaddress_specΓöÇΓöÇΓö¼ΓöÇ,lengthΓöÇΓö¼ΓöÇΓöÇ
                    Γöé         Γöé
                    ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ

where address_spec is:

ΓöÇΓöÇΓö¼ΓöÇhhhh:hhhhΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
   Γöé          Γöé
   ΓööΓöÇhhhhhhhhΓöÇΓöÿ

          Change - Address Example:

          You would type the following in the Parameters entry field to set a
          change - address breakpoint starting at address 000A1FCC and
          continuing for 4 bytes:

                    000A1FCC,4


ΓòÉΓòÉΓòÉ 3.3.8. Line number ΓòÉΓòÉΓòÉ

If you are setting a line breakpoint, type in a number that represents the line
number in your program where you want to set the breakpoint.  Use this
parameter for line breakpoints only.


ΓòÉΓòÉΓòÉ 3.3.9. Part ΓòÉΓòÉΓòÉ

If you are setting a line breakpoint, select a component from the Component
list:

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

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

    As new components are entered by the program you are debugging, they appear
    in this list.


ΓòÉΓòÉΓòÉ 3.3.10. File(s) ΓòÉΓòÉΓòÉ

If the part you selected has include files, then the file(s) list displays all
the file names that are in the included in the part.

 1. Open the File(s) list by selecting the arrow with your mouse.

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


ΓòÉΓòÉΓòÉ 3.3.11. Condition ΓòÉΓòÉΓòÉ

If you are setting an address, entry, or line breakpoint, you can also type in
a simple expression. The execution of the program stops only if this condition
tests true.

Note:  Variables in a conditional expression associated with an Entry
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.


ΓòÉΓòÉΓòÉ 3.3.12. Thread id ΓòÉΓòÉΓòÉ

To select a thread ID from the Thread id list:

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

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

    As new threads are created by the program you are debugging, they appear in
    this list.

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 thread IDs to set a breakpoint in one thread only. Thread IDs are
added to the Thread id list as new threads are activated.


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


ΓòÉΓòÉΓòÉ 3.3.14. 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. Breakpoints begin being set when the location is encountered this
number of times.


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


ΓòÉΓòÉΓòÉ 3.3.16. Pushbuttons ΓòÉΓòÉΓòÉ

OK
  Click on OK to set the breakpoint and close this dialog box.

List
  Click on List to activate the List dialog box. The List dialog box displays
  the breakpoints that are currently set in your program.

Set
  Click on Set to set a breakpoint that is defined by the parameters you have
  selected. You must click on Cancel to close the dialog box after you click on
  Set to set a breakpoint.

Cancel
  Click on Cancel to close this dialog box.

Help
  Click on Help to display help information that tells you how to use this
  dialog box.


ΓòÉΓòÉΓòÉ 3.3.17. List ΓòÉΓòÉΓòÉ

Use the List container dialog box to display a list of the breakpoints that
have been set. The following information is also provided for each breakpoint.
The container allows multiple selections.

o The enablement state
o The type of breakpoint
o The position of the breakpoint (program name, line number, or address)
o The conditions under which the breakpoint is activated.

When selctions are made, press and hold down the right mouse button to activate
the action pop-up menu.  This menu contains the following:

Action Menu Summary

Modify
  You can change the parameters that define the highlighted breakpoint. The
  Set/Modify dialog box appears. When you modify a breakpoint, it is
  automatically activated. When more than one breakpoint has been selected, the
  modify option will be disabled.

Delete
  Remove the highlighted breakpoint.

Enable
  Activate the highlighted breakpoint if it is deactivated.

Disable
  Disable the highlighted breakpoint if it is activated.

Delete all
  Remove all of the breakpoints displayed in the dialog box.

Pushbutton Summary

Set
  Set a new breakpoint in your program. When you click on the Set pushbutton,
  the Set/Modify dialog box appears.

Include
  Create a filter to display a subset of the breakpoints set in your program.
  When you click on the Include pushbutton, the Breakpoint List Include dialog
  box appears.

OK
  Close the List dialog box.

Help
  Displays the online help for this dialog box.


ΓòÉΓòÉΓòÉ 3.3.18. Breakpoint List Include ΓòÉΓòÉΓòÉ

Use the Breakpoint List Include dialog box to create a filter to display a
subset of the breakpoints set in your program.

Breakpoints can be filtered according to the following categories of
information:

o Breakpoint type
o Enablement state
o Thread ID
o Component.

Click on the appropriate  pushbuttons to finish your dialog.

Type

You can select one of the following types of breakpoints from the Type list:

o All
o Address
o Change - Address.
o Entry
o Line
o Load

The default is All.

To select a breakpoint type, highlight the type of breakpoint you want to view.
If you select All, every type of breakpoint you have set in your program is
displayed.

Display Format

Select either of the following Display Format radio buttons:

Concise     Displays a short description for each breakpoint listed

Detailed    Displays a more detailed description for each breakpoint listed.

The default is Concise.

State

You can select one of the following states:

o All
o Enabled
o Disabled.

The default is All.

To select a breakpoint state, do the following:

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

 2. Highlight the state that classifies the breakpoints you want to view. The
    state is placed in the State entry field.

    If you select All, both the enabled and disabled breakpoints are displayed.

Thread

You can select one of the following thread IDs:

o All
o Every
o thread_number, where the thread_number IDs are added and deleted from the
  list as threads are started and stopped by your program.

The default is All.

To select a thread ID, do the following:

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

 2. Highlight the thread ID that contains the breakpoints you want to view. The
    thread ID is placed in the Thread entry field.

    If you select All, the breakpoints for all of the threads will be
    displayed.

Component

You can select one of the following components:

o All
o program_part_name.

The default is All.

To select a component, do the following:

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

 2. Highlight the name of the component that contains the breakpoints you want
    to view. The name of the component you select is placed in the Part entry
    field.

    If you select All, the breakpoints in all of the components of your program
    will be displayed.

Keep Selections

Select the Keep Selections check box to save all of the parameters you have
selected for the duration of the debugging session. When you close the
debugger, these settings for the parameters are lost.


ΓòÉΓòÉΓòÉ 3.4. Thread ΓòÉΓòÉΓòÉ

Select choices from the Thread pull-down to control whether or not a
highlighted thread will be executed when the program runs, to control the
display of the monitor list windows, and to display information about the
storage, registers, and call stacks for your program. All of these choices are
specific to one thread, except for Show  Storage.

Pull-Down Summary

Enabled
  Either enable or disable threads.

Show
  Display specific thread information.


ΓòÉΓòÉΓòÉ 3.4.1. Show ΓòÉΓòÉΓòÉ

Select choices from the Show cascading menu to display information about the
current program and environment.

Pull-Down 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 List window.

Storage
  Monitor the storage for a component or thread in your program.

Window Analysis
  Display the program in a ...................


ΓòÉΓòÉΓòÉ 3.4.2. Enabled ΓòÉΓòÉΓòÉ

Select the Enabled pull-down choice so that the thread that is highlighted in
the Threads box to execute when the program runs. When threads are enabled √
appears beside the Enabled pull-down choice. When threads are not enabled (√ is
not displayed), the highlighted thread is not executed when the program runs.


ΓòÉΓòÉΓòÉ 3.4.3. Storage ΓòÉΓòÉΓòÉ

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

Pull-Down Summary

New
  Open a new Storage window.

storage_address
  Locate a Storage window that is already open.


ΓòÉΓòÉΓòÉ 3.4.4. New ΓòÉΓòÉΓòÉ

Select the New pull-down choice to open a new Storage window. You can monitor
storage in multiple windows. When the program state changes (through execution
or when data is updated), the data displayed in the Storage windows is updated
to reflect these changes.

The storage information displayed in the Storage window consists of the storage
contents and the address to the storage. Multiple storage windows can display
the same storage. Double-click on using the storage window for more information
about manipulating the storage content and addresses displayed.


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


ΓòÉΓòÉΓòÉ 3.4.6. Storage Data Displayed ΓòÉΓòÉΓòÉ

The following types of storage data can be monitored 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:

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

o Titles for the displayed addresses and storage content fields.


ΓòÉΓòÉΓòÉ 3.4.7. Registers ΓòÉΓòÉΓòÉ

Select the Registers pull-down choice to display the processor registers and
the math coprocessor information.


ΓòÉΓòÉΓòÉ 3.4.8. Stack ΓòÉΓòÉΓòÉ

Select the Stack pull-down choice to list all of the active functions or
procedures for a particular thread.

One call stack exists for each thread. Each Stack window displays the call
stack information for one thread only. The functions are displayed in the order
that they were called.

The Stack view contains a line of data for each call stack entry. Each line
contains the entry name of the procedure or function followed by the data you
select in the Display Style dialog box. You can display the following
information for call stack items:

o Entry number
o Entry name
o Part name
o Recursion level.


ΓòÉΓòÉΓòÉ 3.4.9. Local variables ΓòÉΓòÉΓòÉ

Select the Local variables pull-down choice to display the local variables
(static, automatic, and parameters) for the current function. The local
variables are displayed in the Local Variable Monitor List window. You can use
the data manipulation icons in the Local Variable Monitor List window to show
the contents of structures, arrays, and pointers.


ΓòÉΓòÉΓòÉ 3.4.10. Window Analysis ΓòÉΓòÉΓòÉ

Select the Window analysis pull-down choice to display the


ΓòÉΓòÉΓòÉ 3.5. Options ΓòÉΓòÉΓòÉ

Select choices from the Options pull-down to access various utility dialog
boxes that allow you to set debugger options. These debugger options control
the operation of the debugger.

Pull-Down Summary

Window settings
  Control how the items in the Debug Session Controls window are displayed.

Session settings
  Set various debugger options.

Profile
  Change the location of the IPMD.INI file and delete restart information for
  programs that you have debugged.


ΓòÉΓòÉΓòÉ 3.5.1. Window settings ΓòÉΓòÉΓòÉ

Select choices from the Window settings cascading menu to change the font for
the Debug Session Controls window and to select which components are displayed
in the Components list.

Pull-Down Summary

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

Display all components
  Filter the components list.

Sort threads
  Sort the threads in ...........

Sort components
  Sort the components ....

Titles
  Select to have titles ..


ΓòÉΓòÉΓòÉ 3.5.2. Display all components ΓòÉΓòÉΓòÉ

You can specify which components are displayed in the Components list. If this
option is enabled (√ appears beside the Display all components pull-down
choice), all components are listed. If it is not, only components containing
debug information are listed.


ΓòÉΓòÉΓòÉ 3.5.3. Session settings ΓòÉΓòÉΓòÉ

Select choices from the Session settings cascading menu to set various debugger
options that control how your program is executed and is displayed. These
settings affect the behavior of the debugger and remain in effect for the
duration of the debugging session. If you select Save settings, they apply to
future debugging sessions.

Pull-Down Summary

Animation rate
  Specify the rate at which you can automatically execute lines of code in your
  program.

Display order
  Select the initial view for components and threads and control the isolation
  of the view for a stopping thread.

Initial window placement
  Select the position and size of the debugger windows.

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

PM debugging mode
  Set parameters that control how the C Set/2* debugger handles messages passed
  within the debugger and between other PM applications.

Initial window placement
  Set the initial position and size of windows.

Debug session controls
  Focus the Debug Session Controls window and move it in front of the other
  windows.


ΓòÉΓòÉΓòÉ 3.5.4. Sort threads ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 3.5.5. Sort components ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 3.5.6. Titles ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 3.5.7. PM debugging mode ΓòÉΓòÉΓòÉ

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, canalso 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 C Set/2* 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.
When you select PM debugging mode, the PM Debugging Mode dialog box appers..


ΓòÉΓòÉΓòÉ 3.5.8. Asynchronous ΓòÉΓòÉΓòÉ

When the C Set/2* 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
C Set/2* 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 C Set/2* 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 C Set/2* 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.


ΓòÉΓòÉΓòÉ 3.5.9. Synchronous ΓòÉΓòÉΓòÉ

When the C Set/2* 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 C
Set/2* 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.


ΓòÉΓòÉΓòÉ 3.6. Animation Rate ΓòÉΓòÉΓòÉ

When you select Animate from the Run pull-down, the debugger automatically does
Step over commands to execute your code 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. Click on the appropriate pushbuttons to end your dialog.

To stop the animation, select SysRq (Alt + Print Screen) or select Animate
again.


ΓòÉΓòÉΓòÉ 3.6.1. PM Debugging Mode ΓòÉΓòÉΓòÉ

Use the PM Debugging Mode dialog box to set the debugging mode to asynchronous
or synchronous, and control the interaction between the application windows and
PM, while the application has stopped executing. This interaction is controlled
by the choices under the Application windows group heading.

After you have selected the parameters you want from this dialog box, click on
the appropriate pushbuttons.

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 or damaged 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 damaged or invalid areas of the window is repainted.

Color invalid areas

The Color invalid areas option works only in asynchronous mode. This option
paints the damaged or 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 application 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 application windows when
  execution resumes.

  Note:  The application 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.


ΓòÉΓòÉΓòÉ 3.6.2. Debug session controls ΓòÉΓòÉΓòÉ

Select the Debug session controls pull-down choice to make the Debug Session
Controls window the active window and move it in front of any other windows
that are open.


ΓòÉΓòÉΓòÉ 3.7. Help ΓòÉΓòÉΓòÉ

Select choices from the Help pull-down to complement the online help
information that you can get for the debugger when you press F1 or select the
Help pushbutton.

Pull-Down 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 C Set/2* debugger help facility.


ΓòÉΓòÉΓòÉ 3.7.1. Using help ΓòÉΓòÉΓòÉ

Select the Using help pull-down choice to display online help information about
the OS/2* help facility.


ΓòÉΓòÉΓòÉ 3.7.2. General help ΓòÉΓòÉΓòÉ

Select the General help pull-down 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.


ΓòÉΓòÉΓòÉ 3.7.3. Shortcut Keys ΓòÉΓòÉΓòÉ

This help panel lists the  shortcut keys you use to invoke C Set/2* debugger
pull-down 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.

You can use shortcut keys for most of the pull-down choices in these windows:

o Debug Session Controls
o Source View
o Disassembly View
o Mixed View
o Storage
o Register
o Stack
o Data Pop-up
o Private Monitor List
o Program Monitor List
o Local Variables Monitor List.


ΓòÉΓòÉΓòÉ 3.7.4. Debug Session Controls ΓòÉΓòÉΓòÉ

For choices in the File pull-down, use the following keys:

Where                                   Ctrl+W
Close debug                             F3

For choices in the Thread pull-down, use the following keys:

Show  Local variables                  Ctrl+V
Show  Registers                        Ctrl+E
Show  Stack                            Ctrl+K
Show  Storage  New                    Ctrl+G


ΓòÉΓòÉΓòÉ 3.7.5. Source View ΓòÉΓòÉΓòÉ

For choices in the File pull-down, use the following keys:

Where                                   Ctrl+W
Search                                  Ctrl+S
Find next                               Ctrl+F
Close debug                             F3

For choices in the Variable pull-down, use the following keys:

Monitor expression                      Ctrl+M

For choices in the Thread pull-down, use the following keys:

Show  Local variables                  Ctrl+V
Show  Registers                        Ctrl+E
Show  Stack                            Ctrl+K
Show  Storage  New                    Ctrl+G

For choices in the Run pull-down, use the following keys:

Step over                               O or Ctrl+O
Step into                               I or Ctrl+I
Step return                             T or Ctrl+T
Step debug                              D or Ctrl+D
Run                                     R or Ctrl+R
Run to location                         L or Ctrl+L
Halt step or run                        SysRq
Animate                                 A or Ctrl+A


ΓòÉΓòÉΓòÉ 3.7.6. Disassembly View ΓòÉΓòÉΓòÉ

For choices in the File pull-down, use the following keys:

Where                                   Ctrl+W
Search                                  Ctrl+S
Find next                               Ctrl+F
Close debug                             F3

For choices in the Thread pull-down, use the following keys:

Show  Local variables                  Ctrl+V
Show  Registers                        Ctrl+E
Show  Stack                            Ctrl+K
Show  Storage  New                    Ctrl+G

For choices in the Run pull-down, use the following keys:

Step over                               O or Ctrl+O
Step into                               I or Ctrl+I
Step return                             T or Ctrl+T
Step debug                              D or Ctrl+D
Run                                     R or Ctrl+R
Run to location                         L or Ctrl+L
Halt step or run                        SysRq


ΓòÉΓòÉΓòÉ 3.7.7. Mixed View ΓòÉΓòÉΓòÉ

For choices in the File pull-down, use the following keys:

Where                                   Ctrl+W
Search                                  Ctrl+S
Find next                               Ctrl+F
Close debug                             F3

For choices in the Thread pull-down, use the following keys:

Show  Local variables                  Ctrl+V
Show  Registers                        Ctrl+E
Show  Stack                            Ctrl+K
Show  Storage  New                    Ctrl+G

For choices in the Run pull-down, use the following keys:

Step over                               O or Ctrl+O
Step into                               I or Ctrl+I
Step return                             T or Ctrl+T
Step debug                              D or Ctrl+D
Run                                     R or Ctrl+R
Run to location                         L or Ctrl+L
Halt step or run                        SysRq


ΓòÉΓòÉΓòÉ 3.7.8. Register ΓòÉΓòÉΓòÉ

For choices in the Options pull-down, use the following keys:

Close debug                             F3


ΓòÉΓòÉΓòÉ 3.7.9. Stack ΓòÉΓòÉΓòÉ

For choices in the File pull-down, use the following keys:

Close debug                             F3


ΓòÉΓòÉΓòÉ 3.7.10. Storage ΓòÉΓòÉΓòÉ

For choices in the Options pull-down, use the following keys:

Close debug                             F3


ΓòÉΓòÉΓòÉ 3.7.11. Data Pop-up ΓòÉΓòÉΓòÉ

For choices in the Options pull-down, use the following keys:

Enabled                                 Ctrl+E
Show context                            Ctrl+X

See Keyboard Sequences for a list of keys that let you move among, and within,
monitors.


ΓòÉΓòÉΓòÉ 3.7.12. Private Monitor List ΓòÉΓòÉΓòÉ

For choices in the Options pull-down, use the following keys:

Delete                                  Ctrl+D
Enable                                  Ctrl+E
Disable                                 Ctrl+I
Show context                            Ctrl+X
Hide Context                            Ctrl+H

See Keyboard Sequences for a list of keys that let you move among, and within,
monitors.


ΓòÉΓòÉΓòÉ 3.7.13. Program Monitor List ΓòÉΓòÉΓòÉ

For choices in the Options pull-down, use the following keys:

Delete                                  Ctrl+D
Enable                                  Ctrl+E
Disable                                 Ctrl+I
Show context                            Ctrl+X
Hide Context                            Ctrl+H
Close debug                             F3

See Keyboard Sequences for a list of keys that let you move among, and within,
monitors.


ΓòÉΓòÉΓòÉ 3.7.14. Local Variables Monitor List ΓòÉΓòÉΓòÉ

For choices in the Options pull-down, use the following keys:

Show context                            Ctrl+X
Hide context                            Ctrl+H
Close debug                             F3

See Keyboard Sequences for a list of keys that let you move among, and within,
monitors.


ΓòÉΓòÉΓòÉ 3.7.15. Help index ΓòÉΓòÉΓòÉ

Select the Index pull-down choice display an alphabetical list of index topics
for the C Set/2* debugger. Use the Search pull-down choice provided with the
online help facility to locate topics in the index.


ΓòÉΓòÉΓòÉ 4. Program Views ΓòÉΓòÉΓòÉ

The Source, Disassembly, and the Mixed views offer the same pull-down options,
except that:

o The Variable pull-down is not available in the Disassembly view.

o The Change file choice is not available in the File pull-down for the
  Disassembly view.

These program views differ, however, 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.

Source View

The Source view displays the source code for the component you have selected.

When you start the C Set/2* debugger, the source view is displayed if the
source code is available. If it is not, the Part - Filename Specifications
dialog box is displayed. (You can change the order of the views displayed using
the Display Orderdialog box.)

Disassembly View

The Disassembly view displays your program as assembler instructions, without
symbolic information.

Mixed View

This view displays each source statement followed by the assembler instructions
that the particular source statement generates.

The Mixed view works as follows:

o Each source line is prefixed with its line number as it is in the Source
  view.

o Each disassembled line is prefixed with an address as it is 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 or if the
  part was compiled with optimization on.

Menu Bar Summary

File
  Start and end the C Set/2* debugger and control the way in which program
  units are accessed by the C Set/2* debugger.

Edit
  Select......

Breakpoints
  Set and manipulate breakpoints in your program.

Variable
  Display the contents of program variables and expressions.

Thread
  Control whether or not a thread executes when you run the program, and to
  display information about the current program and environment.

Run
  Execute your program in several ways.

Options all.Change the parameters that control how your program is displayed
and executed.

Help
  Online help information that complements the information you get when you
  press F1 or click on a Help pushbutton.


ΓòÉΓòÉΓòÉ 4.1. File ΓòÉΓòÉΓòÉ

You can start programs and look at them, find the current line, search for text
strings, replace your current program file with a program file in 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.

Pull-Down Summary

Open as
  Open a view of your program.

Inheritance
  Look at classes of C++ programs.

Locate entries
  Locate .............

Open module
  Open  .............

Where
  Quickly locate the next line to be executed. Search for the next occurrence
  of a search string.

Change file
  Replace the source you are currently debugging with the source code in
  another location, or with a different name.

Startup
  Allows you to start the program you want to debug, or restart a previous
  debugging session.

Restart
  Restart the current debugging session.

Close debug
  Close the debugging session.


ΓòÉΓòÉΓòÉ 4.1.1. Open as ΓòÉΓòÉΓòÉ

Select Open as to open a view of your program or change current window to the
notebook format. The selected view is displayed in a new window and previous
views are not affected. Each type of view can be opened only once for a program
part; 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. If you select a view that is already open, that view is focused and moved
in front of the other windows. You can view the program as:

o Source
o Disassembly
o Mixed.

The Source and Mixed views can be displayed in a notebook format. This is the
default.  You can enable or disable the Notebook option by toggling the enabled
choice in the Notebook option box.  When the checkmark is displayed, it is
enabled and the views will be displayed in notebook format.  When the checkmark
is not displayed, it is disabled.


ΓòÉΓòÉΓòÉ 4.1.2. Source ΓòÉΓòÉΓòÉ

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

The initial Source view displays the source code for the component that
contains the main entry to the program being debugged. If it is available, the
Source view appears along with the Debug Session Controls 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
display order in the Display Order dialog box.)


ΓòÉΓòÉΓòÉ 4.1.3. Disassembly ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 4.1.4. Mixed ΓòÉΓòÉΓòÉ

Select the Mixed pull-down choice to display each source statement followed by
the assembler instructions that the particular source statement generates.

The Mixed view works as follows:

o Each source line is prefixed with its line number as it is in the Source
  view.

o Each disassembled line is prefixed with an address as it is 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, or the
  part was compiled with optimization on.


ΓòÉΓòÉΓòÉ 4.1.5. Inheritance ΓòÉΓòÉΓòÉ

Select the Inheritance pull-down choice to view the class heirarchy of a C++
program.  This view allows you to see


ΓòÉΓòÉΓòÉ 4.1.6. Locate entries ΓòÉΓòÉΓòÉ

Select the Locate entries pull-down choice to


ΓòÉΓòÉΓòÉ 4.1.7. Open module ΓòÉΓòÉΓòÉ

Select the Open module pull-down choice to


ΓòÉΓòÉΓòÉ 4.1.8. Where ΓòÉΓòÉΓòÉ

Select the Where pull-down choice to quickly locate the next line to be
executed in the thread. If you select Where from the Debug Session Controls
window, the line is highlighted in the view with the highest display order
priority. (You select the display order in the Display Order dialog box.)
Otherwise the line is highlighted in the view from which you selected the Where
pull-down choice.


ΓòÉΓòÉΓòÉ 4.1.9. Change file ΓòÉΓòÉΓòÉ

Select the Change file pull-down choice to specify the file name for the C
Set/2* debugger to use as the source for the component in the current view.

When you select the Change file pull-down choice, the Change File dialog box is
displayed.


ΓòÉΓòÉΓòÉ 4.1.10. Restart ΓòÉΓòÉΓòÉ

Select the Restart pull-down choice to save and terminate the current session,
and prepare the program for execution from the beginning with the following
restored:

o Breakpoints
o Monitors (registers, stack, storage, data pop-up windows)
o Monitor list information (program, private, and local variables).

Note:  Only information relating to the primary thread is restored (for
executable files and preloaded DLLs).


ΓòÉΓòÉΓòÉ 4.1.11. Close debug ΓòÉΓòÉΓòÉ

Select the Close debug pull-down choice to close your current debugging
session. The Close Debug dialog box prompts you to confirm that you wantto end
the debugging session. Click on OK to end the debugging session, or select
Cancel to remain in the debugging session.


ΓòÉΓòÉΓòÉ 4.2. Edit ΓòÉΓòÉΓòÉ

You can search for strings of text or for the next occurrence of a search
string.

Pull-Down Summary

Cut
  Cut

Cut
  Copy

Cut
  Copy

Search
  Search for strings of text in the active program view.

Find next


ΓòÉΓòÉΓòÉ 4.2.1. Cut ΓòÉΓòÉΓòÉ

Select the Cut pull-down choice to search for a


ΓòÉΓòÉΓòÉ 4.2.2. Copy ΓòÉΓòÉΓòÉ

Select the Copy pull-down choice to search for a


ΓòÉΓòÉΓòÉ 4.2.3. Paste ΓòÉΓòÉΓòÉ

Select the Paste pull-down choice to search for a


ΓòÉΓòÉΓòÉ 4.2.4. Search ΓòÉΓòÉΓòÉ

Select the Search pull-down 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.
The search is not case-sensitive. The debugger beeps if the text is not found.

When you select Search, the Search dialog box appears prompting you to type
text string you want to find. If you are searching in the same program part,
the default text string is the string you entered the last time you completed
the Search pull-down choice for this component.


ΓòÉΓòÉΓòÉ 4.2.5. Find next ΓòÉΓòÉΓòÉ

Select the Find next pull-down choice to search for the next occurrence of a
string of text. The last text string that was typed in the Search dialog box
for this component is used.


ΓòÉΓòÉΓòÉ 4.3. Search ΓòÉΓòÉΓòÉ

To use the Search dialog box 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 pushbutton to end your dialog.

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.

If you have already used the Search pull-down choice for this component and in
this debugging session, the default value is the string that you typed the last
time you used Search.


ΓòÉΓòÉΓòÉ 4.3.1. Change File ΓòÉΓòÉΓòÉ

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

To replace the file name:

 1. Type the path name or file name of the program you are currently debugging
    in the Current File field.

 2. Type the new path name or file name in the New File field.

 3. Click on the appropriate pushbutton to end your dialog.

Current File

The path name or file name of the program you are currently debugging. It can
be up to 251 characters in length.

New File

The path name or file name of the program with which you want to replace the
program you are currently debugging. It can be up to 251 characters in length.


ΓòÉΓòÉΓòÉ 4.3.2. Pushbuttons ΓòÉΓòÉΓòÉ

OK
  Click on OK to accept the information you have entered and to close this
  dialog box.

Apply
  Click on Apply to substitute the file name or path name and leave this dialog
  box open.

Cancel
  Click on Cancel to close this dialog box.

Help
  Click on Help to display help information that tells you how to use this
  dialog box.


ΓòÉΓòÉΓòÉ 4.4. Variable ΓòÉΓòÉΓòÉ

Note:  Bit fields are supported for C Set/2 compiled code only. You can display
and update bit fields, but you cannot use them in expressions.

Note:  You cannot look at variables that have been defined using the define
       preprocessor directive.

Select choices from the Variable pull-down to display the variables and
expressions in your program. You can select the variables or expressions you
want to display:

o Using the mouse

o Using the mouse and the Monitor Expression dialog box

o Using the keyboard.

You must select an expression with:

o A valid operand type
o A valid operator
o A valid typecasting operation

For more information about manipulating the variable monitors, double-click on
Using the data pop-up and monitor list windows.

Pull-Down Summary

Popup expression
  Monitors the highlighted variable or expression in a data pop-up window.

Add to private monitor
  Adds the highlighted variable or expression to the Private Monitor List
  window.

Add to program monitor
  Adds the highlighted variable or expression to the Program Monitor List
  window.

Monitor expression
  Type the variable or expression you want to monitor.


ΓòÉΓòÉΓòÉ 4.4.1. Popup expression ΓòÉΓòÉΓòÉ

Select the Popup expression pull-down choice to monitor the highlighted
variable or expression in a data pop-up window.


ΓòÉΓòÉΓòÉ 4.4.2. Add to private monitor ΓòÉΓòÉΓòÉ

Select the Add to private monitor pull-down choice to add the highlighted
variable or expression to the Private Monitor List window.

To use the Add to private monitor pull-down choice:

 1. Highlight the variable or expression you want to monitor by dragging the
    mouse across the variable or expression while holding down button 1.

 2. Select the Add to private monitor pull-down choice.

    The variable or expression you highlighted is added to the Private Monitor
    List window.


ΓòÉΓòÉΓòÉ 4.4.3. Add to program monitor ΓòÉΓòÉΓòÉ

Select the Add to program monitor pull-down choice to add the highlighted
variable or expression to the Program Monitor List window.

To use the Add to program monitor pull-down choice:

 1. Highlight the variable or expression you want to monitor by dragging the
    mouse across the variable or expression while holding down button 1.


 2. Select the Add to program monitor pull-down choice.

    The variable or expression you highlighted is added to the Program Monitor
    List window.


ΓòÉΓòÉΓòÉ 4.4.4. Monitor expression ΓòÉΓòÉΓòÉ

Select the Monitor expression pull-down choice if you want to use the keyboard
to type the variable or expression you want to monitor. The expression you type
does not have to be in your program.

Note:  If you highlight the expression before selecting the Monitor expression
pull-down choice, the expression is automatically placed into the Monitor
Expression dialog box.

When you select Monitor expression, the Monitor Expression dialog box is
displayed.


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

o Highlight the variable name or expression by dragging the mouse while
  pressing mouse button 1, and then double-click mouse button 1 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 pull-down.

To select an expression for display using the mouse:

 1. Highlight the expression by dragging the mouse while pressing mouse button
    1.
 2. Double-click mouse button 1 anywhere within the expression.


ΓòÉΓòÉΓòÉ 4.4.6. With the Mouse and Monitor Expression ΓòÉΓòÉΓòÉ

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

o For a single variable name:

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

      - Point to the variable name and click mouse button 1.

      - Point to the variable name and drag the mouse across the entire
        variable name while pressing mouse button 1.

    2. Select Monitor expression from the Variable pull-down.

       The Monitor Expression dialog box appears, and the highlighted variable
       name is placed in the Expression entry field.

    3. If you want to change the defaults that control how a variable is
       displayed in a monitor list or data pop-up window:

       a. Click on the Monitor Properties pushbutton to display the Monitor
          Properties dialog box.

       b. Click on OK to close the Monitor Properties dialog box.

    4. Click on OK to close the Monitor Expression dialog box.

o For an expression

    1. Highlight the expression by pointing to the beginning of the expression
       with the mouse and dragging the mouse across the entire expression while
       pressing mouse button 1.

    2. Select Monitor expression from the Variable pull-down.

       The Monitor Expression dialog box appears, and the highlighted
       expression is placed in the Expression entry field.

    3. If you want to change the defaults that control how a expression is
       displayed in a monitor list or data pop-up window:

       a. Click on the Monitor Properties pushbutton to display the Monitor
          Properties dialog box.

       b. Click on OK to close the Monitor Properties dialog box.

    4. Click on OK to close the Monitor Expression dialog box.


ΓòÉΓòÉΓòÉ 4.4.7. With the Keyboard ΓòÉΓòÉΓòÉ

To monitor a variable or expression using the keyboard:

 1. Select Monitor expression from the Variable pull-down.  The Monitor
    Expression dialog box appears.

 2. Type 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 list or data pop-up window:

    a. Select Monitor Properties pushbutton to display the Monitor Properties
       dialog box.

    b. Select OK to close the Monitor Properties dialog box.

 4. Select OK to close the Monitor Expression dialog box.


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

o Enable or disable monitors

o Display context

o Change the value of a variable or expression

o Change the representation of a variable or expression.


ΓòÉΓòÉΓòÉ 4.4.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 part. (The cursor moves in a circular
          fashion from part to part. The monitor, itself, is included in the
          circular path.)

BackTab   Move to the previous monitor part

Alt+     Dereference a highlighted pointer

Enter     Open or close data structures (structures or arrays)

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

, , PageUp, and PageDown Scroll through the monitor parts


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


ΓòÉΓòÉΓòÉ 4.4.11. Displaying Context ΓòÉΓòÉΓòÉ

Monitors display the data value in their context. The context consists of:

o Component
o Line number
o Thread
o Variable or expression name.


ΓòÉΓòÉΓòÉ 4.4.12. Changing the Value Displayed ΓòÉΓòÉΓòÉ

You can change the value that is displayed in a monitor. To change the
displayed value:

 1. Select the monitor with your mouse or the Tab key. The monitor turns black
    when it is selected.

 2. Type in the new value.

 3. Press Enter (or select another part of the debugger).


ΓòÉΓòÉΓòÉ 4.4.13. Changing the Representation ΓòÉΓòÉΓòÉ

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.
To change the representation:

 1. Select the monitor or data item.

 2. Select an alternate representation from the Options  Representation
    cascading pull-down menu. The new representation takes effect immediately.

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


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


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


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


ΓòÉΓòÉΓòÉ 4.5. Monitor Expression ΓòÉΓòÉΓòÉ

Use this dialog box to type in the expression that you want to monitor.

This dialog box 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
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 variable or expression you want to monitor.

 2. Click on the Monitor properties pushbutton. The Monitor Properties dialog
    box appear

 3. If you want the context of the monitored variable or expression to be
    displayed, select the Show context check box.

 4. Select a radio button from under the Monitor location group heading to
    indicate the window where you want the variable or expression to be
    monitored.

 5. If you want the displayed contents of the monitored variable or expression
    to be updated as the program executes, select the Enabled check box.

 6. If you selected Popup in step 4, select a radio button from under the
    Duration group heading to indicate when you want the monitor window to
    close.

 7. Select Save settings to save your selections for the next debugging
    session.

 8. Click on the appropriate  pushbutton to end the dialog.

Expression

Type the variable name or expression you want to monitor.

The following fields are in the Monitor Properties dialog box:

Show context

Select the Show context check box to display the context of the variable or
expression as well as the contents of the variable or expression.

Monitor location

Select a radio button to choose the window in which you want the variable or
expression monitored. The radio buttons and the corresponding windows are:

Popup          A data pop-up window

Private        The Private Monitor List window

Program        The Program Monitor List window.

Enabled

Select the Enabled check box to update the displayed contents of the variable
or expression as the program executes.

Duration

Select a radio button to choose when you want the monitor window to close:

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

New part       The monitor window closes when a new component is entered.

Permanent      The monitor window stays open for the remainder of the debugging
               session.


ΓòÉΓòÉΓòÉ 4.6. Thread ΓòÉΓòÉΓòÉ

Select choices from the Thread pull-down to control whether or not a
highlighted thread will be executed when the program runs, to display the
automatic variables for the current line, to display the Program Monitor List
window, to display the Private Monitor List window, and to display information
about the storage, registers, and call stacks.

Pull-Down Summary

Enabled
  Enable or disable the highlighted thread.

Show
  Display information about the current program and environment.


ΓòÉΓòÉΓòÉ 4.6.1. Show ΓòÉΓòÉΓòÉ

Select choices from the Show cascading menu to display information about the
current program and environment.

Pull-Down 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
  Create or focus the Private Monitor List window.

Program monitor
  Create or focus the Program Monitor List window.

Storage
  Monitor the storage that a program thread is using.


ΓòÉΓòÉΓòÉ 4.7. Run ΓòÉΓòÉΓòÉ

Select choices from the Run pull-down to control the execution of your program.
The execution of the line of code is reflected in all open views. 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 pull-down by using the shortcut
keys. In the case of the Step over command, you can use the mouse.

When you select a choice from the Run pull-down, a clock icon indicates that
the application is running and might require input to continue to the next
breakpoint or termination of the program.

Pull-Down Summary

Step over
  Execute the current line and step over any called functions.

Step into
  Step into any called program or function.

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

Step debug
  Execute the current line in the program.

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.

Go to location

Halt step or run
  Interrupt the program you are debugging.

Animate
  Automatically repeat Step over commands.


ΓòÉΓòÉΓòÉ 4.7.1. Step debug ΓòÉΓòÉΓòÉ

Select the Step debug pull-down choice to execute the current line in the
program. The debugger steps over any function for which debug information is
not available, (for example, library and system functions) and steps into any
function for which debugging information is available. The execution of the
line of code is reflected in all open views.


ΓòÉΓòÉΓòÉ 4.7.2. Step into ΓòÉΓòÉΓòÉ

Select the Step into pull-down choice to execute the current line and enter any
called program, or function.


ΓòÉΓòÉΓòÉ 4.7.3. Step over ΓòÉΓòÉΓòÉ

Select the Step over pull-down choice to execute the current line of the
program, without entering any called function. You can also access the Step
over function by placing the mouse cursor in a program view window and
single-clicking mouse button 2 to execute one line.

All enabled threads will continue executing.

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


ΓòÉΓòÉΓòÉ 4.7.4. Step return ΓòÉΓòÉΓòÉ

Select the Step return pull-down choice to automatically execute the lines of
code up to, and including, the return statement of the current function (unless
a breakpoint is encountered).

Note:  If a user program steps into a system routine that does not chain the
EBP register, the Step return function will return to the statement following
the call to the routine that calls the system routine, not the statement after
the call to the system routine.

All enabled threads will continue executing.

Note:  This function is unavailable if you are debugging a PM application.


ΓòÉΓòÉΓòÉ 4.7.5. Run ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 4.7.6. Run to location ΓòÉΓòÉΓòÉ

You can execute your program from the current line up to the line that is
highlighted with gray in the prefix area. The Run to location choice stops only
on executable lines. If a highlighted line is not encountered, the run is not
performed.

To use the Run to location pull-down 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 cursor pull-down choice.

    The program is executed up to the line that you marked.


ΓòÉΓòÉΓòÉ 4.7.7. Go to location ΓòÉΓòÉΓòÉ

To use the Go to location pull-down choice:

     1.


ΓòÉΓòÉΓòÉ 4.7.8. Halt step or run ΓòÉΓòÉΓòÉ

Select the Halt step or run pull-down choice to interrupt the program that you
are debugging. You can also access this pull-down choice by pressing SysRq
(Alt+PrintScreen).


ΓòÉΓòÉΓòÉ 4.7.9. Animate ΓòÉΓòÉΓòÉ

When you select Animate, the debugger automatically performs Step over
commands. As the program runs, the position of the current line changes and the
values of the monitored variables correspondingly change in the monitor
windows.

To stop the animation, select Animate again or press SysRq (Alt + Print
Screen).


ΓòÉΓòÉΓòÉ 4.8. Options ΓòÉΓòÉΓòÉ

Select choices from the Options pull-down to change the parameters that control
how your program is displayed and executed, and to set the default settings for
the variable monitor windows.

Pull-Down Summary

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

Session settings
  Set various debugger options.

Debug session controls
  Activate the Debug Session Controls window and moves it in front of any other
  windows that are open.


ΓòÉΓòÉΓòÉ 4.8.1. Monitor properties ΓòÉΓòÉΓòÉ

Select the Monitor Properties pull-down choice to select the default settings
for monitoring variables or expressions.

When you select the Monitor properties pull-down choice, the Monitor Properties
dialog box is displayed.


ΓòÉΓòÉΓòÉ 4.8.2. Monitor Properties ΓòÉΓòÉΓòÉ

Use the Monitor Properties dialog box to select the default settings for
monitoring variables or expressions. You can set the following default 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 pop-up windows, the duration of time that the monitor windows are
  displayed.

After you have selected the settings you want from this dialog box, click on
one of the pushbuttons to complete your dialog.

For a description of the option settings that you can select from this dialog
box, double-click on one of the following topics:

o Show context
o Monitor location
o Enabled
o Duration


ΓòÉΓòÉΓòÉ 4.8.3. Show context ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 4.8.4. Monitor location ΓòÉΓòÉΓòÉ

Choose one of the following radio buttons to select the default 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 variable data
                    pop-up window.

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

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


ΓòÉΓòÉΓòÉ 4.8.5. Enabled ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ 4.8.6. Duration ΓòÉΓòÉΓòÉ

If you select Popup from under the Monitor location group heading, select one
of the following radio buttons to select the default length of time that the
data pop-up window will stay displayed:

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

New part        The monitor window closes when a new component is entered.

Permanent       The monitor window stays open for the remainder of the
                debugging session.


ΓòÉΓòÉΓòÉ 4.8.7. Initial Window Placement ΓòÉΓòÉΓòÉ

Select the Initial window placement pull-down 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 dialog box is displayed.


ΓòÉΓòÉΓòÉ 4.8.8. Profile ΓòÉΓòÉΓòÉ

Select the Profile pull-down choice to specify the location in which you want
the IPMD.INI file placed, or to delete restart information for a program that
you have debugged.

Pull-Down Summary

Change location
  Allows you to change the location of the file that holds the debugger
  settings.

Delete restart information
  Allows you to delete restart information for a program that you have
  debugged.


ΓòÉΓòÉΓòÉ 4.8.9. Change location ΓòÉΓòÉΓòÉ

Select the Change location pull-down choice to specify the location in which
you want the IPMD.INI file placed. The IPMD.INI file contains your selections
for most of the debugger options and the restart 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
dialog box.

When you select the Change location pull-down choice, the Change Location
dialog box appears displayed.


ΓòÉΓòÉΓòÉ 4.8.10. Delete restart information ΓòÉΓòÉΓòÉ

Select the Delete restart information pull-down choice to delete restart
information for a program that you have previously debugged.

When you select Delete restart information, the Delete Restart Information
dialog box is displayed.


ΓòÉΓòÉΓòÉ 4.8.11. Delete Restart Information ΓòÉΓòÉΓòÉ

Use the Delete Restart Information dialog box to delete the restart information
from the IPMD.INI file for a program that you have previously debugged.

Note:  You can delete restart information to minimize the amount of space your
IPMD.INI file takes up.

To delete restart information:

 1. Select the path names of the programs whose restart information you want to
    delete.

 2. Click on the Delete pushbutton.

 3. Click on Cancel to close the Delete Restart Information dialog box.


ΓòÉΓòÉΓòÉ 4.8.12. Initial Window Placement ΓòÉΓòÉΓòÉ

Use the Initial Window Placement dialog box to set the position and size of the
debugger windows when they are first opened. The windows you can edit this way
are:

o Local Monitor
o Debug Session Controls
o Monitor List
o Register
o Source, Disassembly, or Mixed
o Stack
o Storage.

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 pushbuttons to complete your dialog.

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


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

 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 pushbutton to complete your dialog.


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

 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 pushbutton to complete your dialog.


ΓòÉΓòÉΓòÉ 4.8.15. Pushbuttons ΓòÉΓòÉΓòÉ

OK
  Click on OK to accept the information you have entered and to close this
  dialog box.

Reset
  Click on Reset to clear any changes you have made in this dialog session.

Default
  Click on Default to replace the current window positions and sizes with the
  debugger defaults.

Cancel
  Click on Cancel to close this dialog box.

Help
  Click on Help to display help information that tells you how to use this
  dialog box.


ΓòÉΓòÉΓòÉ 4.8.16. Change Location ΓòÉΓòÉΓòÉ

Use the Change Location dialog box to specify the directory where you want the
IPMD.INI default options file saved.

After you have completed your dialog, click on the appropriate pushbutton.

Path

Type the full path name of the directory where you want the IPMD.INI file
stored. The path name can be a maximum of 251 characters.


ΓòÉΓòÉΓòÉ 4.8.17. Pushbuttons ΓòÉΓòÉΓòÉ

OK
  Click on OK to accept the information you have entered and to close this
  dialog box.

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

Help
  Click on Help to display help information that tells you how to use this
  dialog box.


ΓòÉΓòÉΓòÉ 4.8.18. Fonts ΓòÉΓòÉΓòÉ

Select the Fonts pull-down choice to set the font you want to use for the text
that is displayed in the active window. The Font Selection dialog box is
displayed.


ΓòÉΓòÉΓòÉ 4.8.19. Private monitor ΓòÉΓòÉΓòÉ

Select the Private monitor pull-down choice to create or focus the Private
Monitor List window.


ΓòÉΓòÉΓòÉ 4.8.20. Program monitor ΓòÉΓòÉΓòÉ

Select the Program monitor pull-down choice to create or focus the Program
Monitor List window.


ΓòÉΓòÉΓòÉ 4.8.21. Animation rate ΓòÉΓòÉΓòÉ

Select the Animation rate pull-down choice to set the rate that you will
automatically step through your program.

When you select Animation rate, the Animation Rate dialog box is displayed.


ΓòÉΓòÉΓòÉ 4.8.22. Display order ΓòÉΓòÉΓòÉ

Select the Display order pull-down choice to determine how your threads and
components are initially displayed and how they are handled when they halt or
are no longer active. When you select Display order, the Display Order dialog
box is displayed.


ΓòÉΓòÉΓòÉ 4.9. Font Selection ΓòÉΓòÉΓòÉ

Use this dialog box to change the font that is used for the text displayed in
this window. You can select larger fonts to make the text larger in the windows
or you can use smaller fonts to display more text at one time. The font is
immediately applied to the current window. If you select the Save settings
option, it is applied to all new windows.

The Selection prompt displays the font that is currently being used.

To select a new font:

 1. Highlight the font that you want in the Font Family scroll box.

    The font you selected is placed under the Current Font Selection group
    heading, and a sample of the font is displayed beside the Font Sample
    prompt.

 2. Click on the appropriate  pushbutton to end your dialog.

Note:  You can also double-click on the font you want, to select the font and
to close the dialog box at the same time.


ΓòÉΓòÉΓòÉ 4.9.1. Pushbuttons ΓòÉΓòÉΓòÉ

OK
  Click on OK to accept the information you have entered and to close this
  dialog box.

Apply
  Click on Apply to apply the font to the window. The change applies only until
  you close the dialog box. 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 dialog box.

Help
  Click on Help to display help information that tells you how to use this
  dialog box.


ΓòÉΓòÉΓòÉ 4.10. Display Order ΓòÉΓòÉΓòÉ

Use this dialog box to define:

o The program view that is to be displayed when the C Set/2* 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.

o Whether or not the Old part disposition is applied to all of the view windows
  for all threads, or applied to all of the view windows except for the view
  windows of the stopping thread.

New part 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 that
                      has started

Disassembly           Displays the unassembled machine code for the thread or
                      component that has started

Mixed                 Displays a line of source code followed by the compressed
                      image code for that line of source code. The Mixed view
                      is displayed for the thread or component that has
                      started.

The default New part view priority is Source.

You can change the priority by dragging the view icons with mouse button 2 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 dialog box. 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 part view priority as
icons or text. Click on the appropriate pushbutton to set the display mode.

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

The default Old part disposition is Discard.

Display at stop

You can control how many windows are displayed at one time by centralizing the
visual activity only on part windows that apply to the thread that stops
execution. The Display at stop selections control the behavior of view windows
across threads.

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 part disposition
applies to all of the view windows except the current view of the stopping
thread. If you select All threads, the Old part disposition applies only to the
view windows for the components from which execution has just left within a
thread.

The default Display at stop choice is Only stopping thread.

Save session settings

You can choose to save your selections for the next debugging session. This is
the default.

Save as Notebook

You can choose to save your session in a notebook format. This is the default.

Click on the appropriate pushbutton to complete your dialog.


ΓòÉΓòÉΓòÉ 5. Storage ΓòÉΓòÉΓòÉ

Use the Storage window to view and update the contents of the storage used by
your program.

You can open multiple storage windows to view different storage locations at
the same time. When of the state of your program changes, the contents of the
Storage window is updated to reflect the change.

Storage can be displayed in various styles. You can display only one storage
style at a time.

To scroll through memory, use one of the following methods:

o Scroll bars
o Up and Down cursor keys
o PageUp and PageDown keys.

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 Update storage method
o Specify address location method.

Menu Bar Summary

Options
  Set options that control how the storage content and addresses are displayed,
  set the debugger options, and display additional window control attributes.

Help
  Provides you with several kinds of help information.


ΓòÉΓòÉΓòÉ 5.1. Storage Display Styles ΓòÉΓòÉΓòÉ

Storage can be displayed in the following value styles:

o Hexadecimal and character text (default)
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.

Storage can be displayed in the following address styles:

o Flat and 16:16
o Flat only
o 16:16 only.

You can also change the number of bytes per line that are displayed. This
number varies depending on the content style you have selected.


ΓòÉΓòÉΓòÉ 5.2. Update storage methods ΓòÉΓòÉΓòÉ

To update the contents of storage, type over the current contents in the
storage field.

The contents of storage are updated on a character-by-character basis. As each
character is changed, the window scrolls to the appropriate storage location.


ΓòÉΓòÉΓòÉ 5.3. Specify address location methods ΓòÉΓòÉΓòÉ

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

The contents of the address are updated on a character-by-character basis. The
Storage window is scrolled to the appropriate address each time you change a
character in the address.


ΓòÉΓòÉΓòÉ 5.4. Options ΓòÉΓòÉΓòÉ

Select choices from the Options pull-down to control how the storage contents
and addresses are displayed, control the display of the window control
attributes, set the debugger options, and end your debugging session.

Pull-Down Summary

Window settings
  Change the storage display format, and display additional window control
  parts.

Session settings
  Set the debugger options.

Debug session controls
  Activates the Debug Session Controls window.

Close debug
  Ends your debugging session.


ΓòÉΓòÉΓòÉ 5.4.1. Window settings ΓòÉΓòÉΓòÉ

Select the Window settings pull-down choice to display additional parts of the
Storage window where yo can control how the storage is displayed.

Pull-Down Summary

Fonts
  Change the font used to display text in the Storage window.

Content style
  Select the display format for the contents of storage.

Address style
  Select the display format for storage addresses.

Window controls
  Control the display of the horizontal scroll bar and the headings in the
  Storage window.


ΓòÉΓòÉΓòÉ 5.4.2. Content style ΓòÉΓòÉΓòÉ

Select the Content pull-down choice to select the display format for the
contents of storage. You can select from several storage display styles.

When you select the Content pull-down choice, the Storage Content Style dialog
box is displayed.


ΓòÉΓòÉΓòÉ 5.4.3. Address style ΓòÉΓòÉΓòÉ

Select the Address pull-down choice to display the format of the storage
addresses, and the number of bytes per line displayed. You can select from
several  storage display styles.

When you select the Address pull-down choice, the Storage Address Style dialog
box is displayed.


ΓòÉΓòÉΓòÉ 5.4.4. Window controls ΓòÉΓòÉΓòÉ

Select the Display window controls pull-down 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 dialog
box is displayed.


ΓòÉΓòÉΓòÉ 5.4.5. Storage Window Controls ΓòÉΓòÉΓòÉ

Use the Storage Window Controls dialog box 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
dialog box, select one of the pushbuttons.

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
dialog box for the next debugging session.


ΓòÉΓòÉΓòÉ 5.4.6. Storage Content Style ΓòÉΓòÉΓòÉ

Use the Storage Content Style dialog box to select the parameters that control
how the storage contents are displayed.

After you have completed your dialog, select the appropriate pushbutton.

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 you want to select.

    The value style you highlighted is placed in the Style entry field.

Bytes per line

You can select from a range of quantities 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
dialog box for the next debugging session.


ΓòÉΓòÉΓòÉ 5.4.7. Storage Address Style ΓòÉΓòÉΓòÉ

Use the Storage Address Style dialog box to select the parameters that control
how the storage addresses are displayed.

After you have completed your dialog, select the appropriate pushbutton.

Style

You can select from the following address styles:

o Flat and 16:16
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 you want to select.

    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
dialog box for the next debugging session.


ΓòÉΓòÉΓòÉ 5.4.8. Push Buttons ΓòÉΓòÉΓòÉ

OK
  Click on OK to accept the information you have entered and to close this
  dialog box.

Reset
  Click on Reset to clear any changes you have made in this dialog 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 dialog box.

Help
  Click on Help to display Help information that tells you how to use this
  dialog box.


ΓòÉΓòÉΓòÉ 6. Register ΓòÉΓòÉΓòÉ

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.

Menu Bar Summary

Options
  Enable or disable monitoring, change the fonts used for the text displayed in
  the Register window, and end your debugging session.

Help
  Provides you with online help information that complements the online help
  that you can get press F1 or click on a Help push button.


ΓòÉΓòÉΓòÉ 6.1. Options ΓòÉΓòÉΓòÉ

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.

Pull-Down Summary

Fonts
  Change the fonts for the text displayed in the Register window.

Session settings
  Set various debugger options.

Debug session controls
  Activates the Debug Session Controls window.

Close debug
  End your C Set/2* debugger session.


ΓòÉΓòÉΓòÉ 7. Stack ΓòÉΓòÉΓòÉ

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 a view for that
program.

Menu Bar Summary

File
  Open different views 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,
  and set the debugger options,

Help
  Provides you with online help information that complements the online help
  you can get when you press F1 or click on a Help pushbutton.


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

Select the File menu bar choice to open different views of r your program and
to end your debugging session.

Pull-down Summary

Open as
  Open program views of the call stack items.

Close debug
  End your debugging session.


ΓòÉΓòÉΓòÉ 7.2. Options ΓòÉΓòÉΓòÉ

Select the Options menu bar choice to control how the items on the stack are
displayed, and to set various debugger options.

Pull-down Summary

Window settings
  Control how the items on the call stack are displayed.

Session settings
  Set the debugger options.

Debug session controls
  Activate the Debug Session Controls window.


ΓòÉΓòÉΓòÉ 7.2.1. Window settings ΓòÉΓòÉΓòÉ

Select choices from the Window settings cascading menu to change the font for
the Stack window and to select the information that is displayed for the items
on the call stack.

Pull-down Summary

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

Display style
  Select the parameters that control how the items on the stack are displayed.


ΓòÉΓòÉΓòÉ 7.2.2. Display style ΓòÉΓòÉΓòÉ

Select the Display style pull-down choice to select the parameters that 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 pull-down choice, the Display Style dialog
box appears.


ΓòÉΓòÉΓòÉ 7.3. Display Style ΓòÉΓòÉΓòÉ

Use the Display Style dialog box to select the parameters that 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 and you can
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. Click on one of the pushbuttons 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 entry level of the call
                      stack item. Entry level 1 is the first function invoked.

Entry name            The name of the program or the address of the function
                      call that created the new stack entry.

Part name             The name of the program part that has been entered. The
                      name displayed corresponds with a name listed in the
                      Parts scroll box in the Debug Session Controls window.

Recursion level       Recursion level 0 is the first invocation.

Growth Direction

Select one radio button to display new stack items at the top or the bottom of
the stack:

Up        Displays new stack items at the top of the stack.

Down      Displays new stack items at the bottom of the stack.

Keep settings

Select the Keep settings check box to save the selections you made in this
dialog box for this debugging sessions.


ΓòÉΓòÉΓòÉ 8. Data Pop-up ΓòÉΓòÉΓòÉ

The data pop-up window displays the contents of the variable or expression you
select for monitoring. As you execute the statements in your program, the
contents of the variable or expression you are monitoring can change.

You can have these changes displayed in the data pop-up window as they occur,
or you can disable the variable or expression so that these updates are not
displayed.

You can use the data manipulation icons to show the contents of structures,
arrays, and pointers.

Menu Bar Summary

Options
  Transfer a variable to the Private Monitor List or Program Monitor List
  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 complements the online help
  you can get when you press F1 or click on a Help push button.


ΓòÉΓòÉΓòÉ 8.1. Options ΓòÉΓòÉΓòÉ

Select choices from the Options pull-down 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 pop-up window remains open, and the window to
which you can transfer the variable.

Pull-Down Summary

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 pop-up window is dismissed.

Transfer to
  Transfer the variable to the Program Monitor window or the Private Monitor
  window.

Fonts
  Choose the font for the text displayed in the data pop-up window.


ΓòÉΓòÉΓòÉ 8.1.1. Enabled ΓòÉΓòÉΓòÉ

Select the Enabled pull-down choice to update the displayed value of the
variables or expressions you are monitoring as the state of the program
changes. The Enabled pull-down choice is selected when √ is displayed. To
disable the variable, select the Enabled pull-down choice again, to remove √.


ΓòÉΓòÉΓòÉ 8.1.2. Enable ΓòÉΓòÉΓòÉ

Select the Enable pull-down choice to have the displayed contents of a variable
or expression updated as the state of the program changes.


ΓòÉΓòÉΓòÉ 8.1.3. Disable ΓòÉΓòÉΓòÉ

Select the Disable pull-down choice to prevent the displayed contents of a
variable or expression from being updated as the state of the program changes.


ΓòÉΓòÉΓòÉ 8.1.4. Duration ΓòÉΓòÉΓòÉ

Select the Duration pull-down choice to set the conditions under which the data
pop-up window is dismissed.

Pull-Down Summary

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

New part
  The monitor window closes when a new program part is entered.

Permanent
  The monitor window stays open for the remainder of the debugging session.


ΓòÉΓòÉΓòÉ 8.1.5. Step/run ΓòÉΓòÉΓòÉ

Select the Step/run pull-down choice to close the data pop-up window the next
time a step command or Run is executed.


ΓòÉΓòÉΓòÉ 8.1.6. New part ΓòÉΓòÉΓòÉ

Select the New part pull-down choice to close the data pop-up window when the
current line moves to a different part of the program.


ΓòÉΓòÉΓòÉ 8.1.7. Permanent ΓòÉΓòÉΓòÉ

Select the Permanent pull-down choice to cause the data pop-up window to remain
open for the remainder of the debugging session.


ΓòÉΓòÉΓòÉ 8.1.8. Transfer to ΓòÉΓòÉΓòÉ

Select the Transfer pull-down choice to move the variable or expression you are
monitoring to the Private Monitor List or Program Monitor List window. Any
variable or expression can be transferred to either the Private Monitor List
window or to the Program Monitor List window. It does not matter whether the
variable or expression is used throughout the program. The Private Monitor List
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 List window,
and monitor global variables in the Program Monitor List window.

Pull-Down Summary

Private monitor
  Move the variable or expression you are monitoring to the Private Monitor
  List window.

Program monitor
  Move the variable or expression you are monitoring to the Program Monitor
  List window.


ΓòÉΓòÉΓòÉ 8.1.9. Private monitor ΓòÉΓòÉΓòÉ

Select the Private monitor pull-down choice to move the variable or expression
you are monitoring to the Private Monitor List window.


ΓòÉΓòÉΓòÉ 8.1.10. Program monitor ΓòÉΓòÉΓòÉ

Select the Program monitor pull-down choice to move the variable or expression
you are monitoring to the Program Monitor List window.


ΓòÉΓòÉΓòÉ 8.1.11. Data Manipulation Icons ΓòÉΓòÉΓòÉ

You can select any of the following icons from the data pop-up window to
manipulate the data parts of variables:


          Expands the contracted parts of an array.

          Expands the contracted parts of a structure.

          Contracts the parts of an array or structure that has been expanded.

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


ΓòÉΓòÉΓòÉ 8.1.12. Show context ΓòÉΓòÉΓòÉ

Select the Show context pull-down choice to display contextual information for
the variables you are monitoring. The following information is displayed:

o Line number
o Part name
o Thread number
o Variable name.

The Show context pull-down choice is selected when √ is displayed. To hide the
contextual information, select the Show context pull-down choice again to
remove √.


ΓòÉΓòÉΓòÉ 8.1.13. Show context ΓòÉΓòÉΓòÉ

Select the Show context pull-down choice to display the contextual information
for the variable you are monitoring. The following information is displayed:

o Line number
o Part name
o Thread number
o Variable name.


ΓòÉΓòÉΓòÉ 8.1.14. Hide context ΓòÉΓòÉΓòÉ

Select the Hide context pull-down choice to hide the contextual information for
the variable you are monitoring.


ΓòÉΓòÉΓòÉ 9. Local Variables Monitor List ΓòÉΓòÉΓòÉ

The Local Variables Monitor List window is displayed when you select the Show 
Local variables choice from the Thread pull-down.

The Local Variables Monitor List window displays the local variables for the
current line of your program. You can use the data manipulation icons in the
Local Variables Monitor List window to show the contents of structures, arrays,
and pointers.

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 List window, the Program Monitor List window, or a data pop-up
window.

Menu Bar Summary

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 complements the online help
  you can get when you press F1 or click on a Help pushbutton.


ΓòÉΓòÉΓòÉ 9.1. Options ΓòÉΓòÉΓòÉ

Select choices from the Options pull-down to control how the contents of
variables are displayed, to set the debugger options, and end your debugging
session.

Pull-Down Summary

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

Show context
  Display the contextual information for a variable being monitored.

Hide context
  Prevent the contextual information for a monitored variable from being
  displayed.

Fonts
  Select the font you want to use for the text displayed in the Local Variables
  Monitor List window.

Session settings
  Set the debugger options.

Debug session controls
  Activate the Debug Session Controls window.

Close debug
  Close the debugging session.


ΓòÉΓòÉΓòÉ 9.1.1. Representation ΓòÉΓòÉΓòÉ

Select the Representation pull-down choice to display the contents of the
variable in a new representation. The types of representation that appear on
the pull-down 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.


ΓòÉΓòÉΓòÉ 9.1.2. Hexadecimal ΓòÉΓòÉΓòÉ

Select the Hexadecimal pull-down choice to display the contents of a variable
that is being monitored in hexadecimal notation.


ΓòÉΓòÉΓòÉ 9.1.3. Decimal ΓòÉΓòÉΓòÉ

Select the Decimal pull-down choice to display the contents of a variable that
is being monitored in decimal notation.


ΓòÉΓòÉΓòÉ 9.1.4. String ΓòÉΓòÉΓòÉ

Select the String pull-down choice to display the contents of a monitored
variable as a character string.


ΓòÉΓòÉΓòÉ 9.1.5. Hexadecimal pointer ΓòÉΓòÉΓòÉ

Select the Hexadecimal pointer pull-down choice to display the contents of a
monitored variable as a hexadecimal pointer.


ΓòÉΓòÉΓòÉ 9.1.6. Decimal pointer ΓòÉΓòÉΓòÉ

Select the Decimal pointer pull-down choice to display the contents of a
monitored variable as a decimal pointer.


ΓòÉΓòÉΓòÉ 9.1.7. Array ΓòÉΓòÉΓòÉ

Select the Array pull-down choice to display the contents of a monitored
variable as an array.


ΓòÉΓòÉΓòÉ 9.1.8. Floating point ΓòÉΓòÉΓòÉ

Select the Floating point pull-down choice to display the contents of a
monitored variable in floating point notation.


ΓòÉΓòÉΓòÉ 10. Program Monitor List ΓòÉΓòÉΓòÉ

The Program Monitor List window is displayed when you:

o Select the Show  Program monitor choice from the Thread pull-down.

o Click on the Program monitor radio button in the Monitor Properties dialog
  box, and then highlight or double-click on a variable or expression to select
  it for monitoring.

Use the Program Monitor List window to display the global variables that are
used in your program because this window remains open as your program enters
and exits components and threads. You can use the data manipulation icons in
the Program Monitor List window to show the contents of structures, arrays, and
pointers.

Menu Bar Summary

Options
  Control how variables or expression are displayed, delete variables or
  expressions from the monitor list, set the debugger options, and close your
  debugging session.

Help
  Provides you with online help information that complements the online help
  you can get when you press F1 or click on a Help pushbutton.


ΓòÉΓòÉΓòÉ 10.1. Options ΓòÉΓòÉΓòÉ

Select choices from the Options pull-down to change the representation of a
variable or expression, delete a variable or expression from the Program
Monitor List window, control the updating of the displayed contents, control
the display of context, change the font for the text displayed in the monitor
list, set the debugger options, and end your debugging session.

Pull-Down Summary

Representation
  Display the contents of a monitored variable or expression in either
  hexadecimal or decimal notation.

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.

Fonts
  Select the font you want to use for the text displayed in the Program Monitor
  List window.

Session settings
  Set various debugger options.

Debug session controls
  Activates the Debug Session Controls window.

Close debug
  Closes the debugging session.


ΓòÉΓòÉΓòÉ 10.1.1. Delete ΓòÉΓòÉΓòÉ

Select the Delete pull-down choice to delete variables or expressions that are
being monitored from a monitor list window.

To delete a variable or expression from a monitor list window:

 1. Select the variable or expression with your mouse. The monitor for the
    variable or expression is highlighted.

 2. Select the Delete pull-down choice from the Options pull-down.


ΓòÉΓòÉΓòÉ 11. Private Monitor List ΓòÉΓòÉΓòÉ

The Private Monitor List window is displayed when you:

o Select the Show  Private monitor choice from the Thread pull-down.

o Click on the Private monitor radio button in the Monitor Properties dialog
  box, and then highlight or double-click on a variable or expression to select
  it for monitoring.

Use the Pivate Monitor List window to display the variables or expressions that
are particular to a program part or thread because this window closes when its
associated view closes. You can use the data manipulation icons in the Private
Monitor List window to show the contents of structures, arrays, and pointers.

Action Bar Summary

Options
  Delete selected monitor items, select all of items in a monitor window, reset
  the values for the selected monitor items, change the font used for the
  displayed text, and show or hide the data manipulation icons.

Help
  Provides you with several kinds of help information.


ΓòÉΓòÉΓòÉ 11.1. Options ΓòÉΓòÉΓòÉ

Select choices from the Options pull-down to change the representation of a
variable or expression, delete a variable or expression from the Private
Monitor List window, control the updating of the displayed contents, display
context, and change the font for the text displayed in this window.

Pull-Down Summary

Representation
  Display the contents of a monitored variable or expression in a different
  representation.

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.

Fonts
  Select the font you want to use for the text displayed in the Private Monitor
  List window.