Managing Debuggee Runtimes

See Also

The runtime manager dialog displays a list of the currently defined Java runtimes available for launching a debuggee. Each runtime specifies the path to the base directory of the Java runtime, the name of the executable that starts the runtime, and optional Java class source paths.

You can open the dialog box by choosing Tools > Runtime Manager.

Adding a Runtime

To add a new runtime for use in launching a debuggee, click on the "Add Runtime" button in the Runtime Manager dialog. A file chooser will appear -- use this to select the base directory of an installed Java runtime. The Runtime Manager dialog will then automatically attempt to determine the name of the runtime executable, as well as possible locations of the source code for the Java core classes.

Removing a Runtime

In the list of available runtimes, select the runtime to be deleted. Then click the Remove button and the selected runtime will be removed from the list. Note the installed runtime itself is left untouched.

Specifying Runtime Details

Executable Filename

The name of the runtime executable will very likely be java or java.exe, depending on whether your system is Unix-like or Microsoft Windows. The Runtime Manager will have already attempted to locate a suitable executable, but if your runtime is different than the standard, you may specify a different executable name here. Note that on Windows you will need to include the .exe extension on the name of the executable. You may include a path to the executable, if necessary, although the path must be relative to the runtime base directory.

Source Paths

In most cases, the standard src.zip will contain the source code for the Java core classes (e.g. java/lang/String.java). Other possible choices are src.jar and a directory named src. The Runtime Manager will have already attempted to locate all possible source locations, but if your runtime is different than the standard, you may specify different paths using the source path editor portion of the Runtime Manager dialog.

Note that the source paths provided for the runtime will be added to the source path of the current session. If you do not want this to happen, then remove all of the source paths for the runtime using the Runtime Manager dialog.

See Also


Legal Notices