A configuration for running Eclipse is defined using the Eclipse Configuration dialog. The configuration dialog is divided into three sections as described below. Text fields that require a value to be specified are identified by a red background. If an invalid value is specified, a red marker will be displayed on the right side of the incorrect item when the OK button is pressed. Hovering over the error marker displays a description of the error.

This section contains information which identifies the configuration.

Configuration Name - (Required) The name used to identify the Eclipse configuration. The name must be unique from all other configuration names.

Taskbar Name - The name to be displayed in task bar item that represents the running Eclipse. When this parameter is empty, the task bar displays the name of the Eclipse executable.

Description - Provides a brief description of the configuration. When specified, the description is displayed as a tool tip when hovering over the configuration name in the configuration list.

The parameters for the Eclipse program are specified in this section.

Eclipse Executable - (Required) The absolute pathname to the Eclipse executable (e.g. C:\Program Files\eclipse\eclipse.exe).

Workspace Location - (Required) The absolute path for the Eclipse workspace directory. This parameter is required to avoid accidentally using an Eclipse default workspace location. This parameter is equivalent to specifying the -data Eclipse command line option.

Clean plugin cache - If this parameter is checked, any cached data used by the OSGi framework and the Eclipse runtime will be wiped clean. This will clean the caches used to store bundle dependency resolution and Eclipse extension registry data. Using this option will force Eclipse to reinitialize these caches. If plugins are frequently updated, this parameter should be checked. Checking this parameter is equivalent to specifying the -clean Eclipse command line option.

Show splash screen - If this parameter is unchecked, the Eclipse splash screen is not displayed when Eclipse is run. Unchecking this parameter is equivalent to specifying the -nosplash Eclipse command line option.

Refresh workspace on startup - If this parameter is checked, a global refresh of the Eclipse workspace is performed on startup. This will reconcile any changes that were made in the file system since Eclipse was last run. Checking this parameter is equivalent to specifying the -refresh Eclipse command line option.

Additional Eclipse Arguments - This field is used to directly specify additional Eclipse command line options. Refer to the Eclipse help for information about Eclipse command line options.

The parameters for the Java virtual machine are specified in this section.

Java VM - The absolute pathname of the Java Virtual Machine executable. The drop down list is pre-populated with the Java VM's available on the system. The Java VM can be selected from the drop down list, selected using the Browse... button or entered directly into the text field. Specifying this parameter is equivalent to specifying the -vm Eclipse command line option.

Initial VM Memory - Specifies the initial size of the VM memory allocation pool. The memory size is specified either in megabytes (MBytes) or kilobytes (KBytes). The value must be greater than 1 MByte. Specifying this parameter is equivalent to specifying the -Xms Java VM command line option.

Maximum VM Memory - Specifies the maximum size of the VM memory allocation pool. The memory size is specified either in megabytes (MBytes) or kilobytes (KBytes). This value must be greater than 2 MByte. To reduce garbage collection and improve the performance of Eclipse, it is recommended that this parameter be set as high as possible (e.g. half the installed physical memory). Specifying this parameter is equivalent to specifying the -Xmx Java VM command line option.

Additional VM Arguments - This field is used to directly specify additional Java VM command line options. Refer to the Java VM documentation for information about VM command line options.