Search VisualAge for Java Information Go to Information Home Page Go to VisualAge for Java WWW Site

Process List dialog box

Restriction: This dialog box applies to AIX and Windows only.

Use the Process List dialog box to select and attach to an already running process so it can be debugged.

When you exit the debugger, any attached process is terminated. Do not attach to operating system processes or to the debugger's own process. Attaching to such processes can cause unpredictable results.

Controls and control groupings are described below. Group and subgroup names appear in italics, and control names appear in bold.

Select local or remote execution of the program Select one of the following options to define the location in which the process being attached to will be running.
Local If checked, all process execution and debugging takes place on the local system.
TCP/IP Connection If checked, process execution takes place on a remote system while debugging control and display remains with the local system. If you choose this option, you must have started a debug engine daemon on the remote system using the irmtdbgc command. You must also provide the following information regarding the remote system:
Host This field incorporates a selection list containing the names of remote hosts recently used by the debugger. Select any remote host name from this list. If the remote host you want to use is not named in the list, type the name of that host into this field.
Port Enter the port number the remote debug engine daemon is listening on. If not specified, port 8000 is assumed.
Select Process Select the process you want to attach to from this list of processes currently running on your system.
Process Path If this field is enabled, enter the full path name for the executable associated with the process you want to debug. Some operating systems, such as AIX, can determine the process path from the process ID and do not require you to specify this information.
Use program profile Check this box if you want the window sizes, positions, fonts, and breakpoints for your program restored from the last time you debugged the program. If you are debugging the program for the first time, the debugger windows start up with their default appearance, and no breakpoints are initially set.

If you check this box, any changes you make to the windows and breakpoints are saved.

If you do not want this information to be restored or saved, do not check this box. When the check box is off, the debugger windows start up with their default appearance, and no breakpoints are initially set.

Note: If you add or delete lines in your source file, recompile it, and then debug the program again with a saved program profile, line breakpoints may no longer match the code they were initially set for because line breakpoint information is saved by line number, not by the content of the line.

Push-buttons
Attach Attaches the selected process so you can debug it.
Refresh Refreshes the list, removing processes that have terminated and adding ones that have started since the Process List dialog box opened or since the last refresh.
Cancel Selecting this cancels the attach operation and closes the Process List dialog box. All selections are discarded.
Help Displays this help.