Load Occurrence Breakpoint dialog box
Restrictions: This dialog box is not available when debugging on the
AS/400, or when debugging interpreted Java programs.
Use the Load Occurrence Breakpoint dialog box to set a new breakpoint that stops execution when a
specified DLL, dynamically called routine, or program loads. The dialog box is
available when debugging on the AIX, Solaris, OS/390, and Windows NT operating
systems. On AIX, Solaris, and Windows,
you also use this dialog box to redefine a breakpoint.
This applies to
programs that are called dynamically either through the CALL identifier in the calling
program or by compiling the calling program with DYNAM compiler option.
Controls and control groupings are described below. Group and subgroup names appear in italics,
and control names appear in bold.
Required Parameters |
Use controls in this group to define where the breakpoint is placed in
the program being debugged.
DLL File Name |
Enter the name of the Windows DLL or Unix shared
library in this field. On Windows, names are case insensitive. On
Unix, names are case sensitive.
The file name can be entered with or without its file extension.
For example, on Windows, you can enter filename.dll or filename.
If a DLL or load module in this
field is a member of a partitioned data set, specify the member name in upper case.
|
|
Optional Parameters |
Provide additional control over when breakpoints are triggered.
Thread |
This selection list lets you choose what threads to set the breakpoint
in. To select a thread ID from the list, highlight the thread where you want to set the
breakpoint. This list is available only on platforms that support multithreaded programs. |
Frequency |
Use the Frequency controls to tell the debugger when to stop on a
breakpoint and when to skip it. The debugger keeps track of how many times each breakpoint
is encountered. The fields in this section tell the debugger on which encounter of a
breakpoint the debugger should first stop, how often it should stop, and on which
encounter the debugger should no longer stop.
From |
Enter the first breakpoint encounter you want the debugger to stop on.
For example, if you want the debugger to skip over the breakpoint the first five times it
is encountered, enter "6". |
To |
Enter the last breakpoint encounter you want the debugger to stop on. For
example, if you want it to start ignoring the breakpoint after the 20th encounter, enter
"20". To have it always stop on the breakpoint, enter "Infinity". |
Every |
Enter the frequency with which you want the debugger to stop on this
breakpoint. For example, if you want it to stop on only one out of every four it
encounters, enter "4". |
|
|
Push buttons |
OK |
Creates the load occurrence breakpoint using the settings you specified,
then closes the Load Occurrence Breakpoint dialog box. |
Set |
Creates the load occurrence breakpoint using the settings you specified,
but keeps the Load Occurrence Breakpoint dialog box open so you can create more
breakpoints. |
Default |
Saves the settings in the Optional Parameters group for use as
default settings when you next set a new breakpoint. |
Browse |
Opens a file-selection window so you can locate the DLL you want. Locates
files on the workstation only. |
Cancel |
Closes the Load Occurrence Breakpoint dialog box without creating a new
breakpoint. |
Help |
Displays this help panel. |
|