TOC PREV NEXT INDEX DOC LIST MASTER INDEX




Windows > Programs

The Windows > Programs command invokes the Programs window. This window provides the user the capability of debugging multiple programs at once. Multiple program debugging is a general term that describes several debugging situations. Multiple program debugging is available for all languages supported by Apex.

From the GUI, multiprogram debugging can be invoked by selecting the Multi-program debugging check box from the Debug dialog or the Run dialog (this option appears after both Debug and Debug Set Options have been selected.)

Additional information on multiprogram debugging is also available in Using the Apex Debugger.

Simultaneous Programs

Users can debug multiple programs via the command line and/or from within the debugging session.

The debugger reads in the symbols from each of the programs and when the debugger prompt appears, users may debug each of the programs in a single debug session.

Once in a debugging session, users may debug additional running programs using the Programs > Attach command. Each use of the Programs > Attach command brings in another program that the user can debug in the single debugging session.

Current program

The current program is the program that the debugger is currently focused on. Most debugger commands apply only to the current program.

The current program defaults to the last program with an event. For example, when the programs are run, the first program to announce an event becomes the current program. Users may also change the current program to the program of choice using the select command.

Programs Window

When the Windows > Programs command is selected, the Programs window is displayed. This window provides the capability of debugging and manipulating multiple programs from the debugger.

The following information is displayed for each entry in this window

P#
Program number. Note that * indicates the current program
PID
Process identification number of the program
PPID
PID of the parent program. It is not 0 when the debugger is debugging both the parent and the child
ATTACH
Indicates if the program was attached
STATUS
Status of the program. Possible values are: exited, running, loaded, stopped or unknown.
EXECUTABLE NAME
Name of the program being debugged

A number of actions can be taken from this window, either through the hot buttons or the Programs menu. These actions are listed in the "Additional Topics" section below and more information on each action is available by selecting its entry in the list.

Additional Topics

To see related information, click on a topic:


Rational Software Corporation 
http://www.rational.com
support@rational.com
techpubs@rational.com
Copyright © 1993-2001, Rational Software Corporation. All rights reserved.
TOC PREV NEXT INDEX DOC LIST MASTER INDEX TECHNOTES APEX TIPS