Java Environments tab of the Enable Environments dialog box

For enabling Java environments:

The Java™ enabler is the Java Environments tab of the Enable Environments dialog box. The Java™ enabler must be run before you can use Rational® Functional Tester to test Java™ applications. It modifies your Java™ environments to allow Java™ programs run under them to be tested by Rational® Functional Tester. The enabler scans your hard disk drive(s) looking for Java™ environments. It allows Rational® Functional Tester to "see" your Java™ environments by adding files into the directory where your Java™ Runtime Environments (JREs) are located.

The first time you run Rational® Functional Tester, it automatically enables your Java™ environments. If you install a new Java™ environment, such as a new release of a browser or a JDK, you must rerun the enabler after you complete the installation of the Java™ environment. You can run the enabler any time from Rational® Functional Tester by clicking Configure > Enable Environments for Testing. Note that the first time you run Rational® Functional Tester it automatically enables the JVM of your browser's Java™ plug-in so that HTML recording works properly. If you install a different JVM, you must rerun the enabler to enable it.

Java Environments List

Rational® Functional Tester is shipped with a JRE that is automatically enabled during your installation. It is called "Default JRE," and will appear in this list. Other than the Default JRE, this list is populated by the Search or Add buttons. It displays the list of Java™ environments that the enabler locates on your hard disk drive(s). After the name, the enabler indicates in parentheses whether that environment is currently enabled.

Select All Button

Use this to select all the JREs that are listed in the Java Environments list. This is useful if you want to enable or disable all the environments. To clear them all, click any of the individual environments.

Search Button

Click this button to have Rational® Functional Tester search your hard disk drive(s) for Java™ environments. This opens the Search for Java™ Environments dialog box. Choose one of the search options in that dialog and click the Search button. Note: You should not use the Search All Drives option to find JREs on Linux® or UNIX® systems. Instead use the Search In option and browse for the JRE. See Enabling Java Environments topic for information on the search options. When the search is complete, the Java Environments list is populated with all found environments. At least the first time that you use Rational® Functional Tester, use the Search button to locate all JREs on your system. After the initial search, it will list any JREs that were already enabled, plus any new ones it finds.

Add Button

Click this button to locate Java™ environments individually by browsing. It brings up the Add Java™ Environment dialog box to locate a JRE on your system. To select a JRE, you can point to the JRE's root directory or any file under the root directory. The JRE you select will be added to the Java Environments list. You can also use the Search In option in the Search for Java Environments dialog box to browse for a JRE.

Remove Button

To remove an environment from the JREs list, select it, then click Remove.

Set as Default Button

Use this to choose which JRE you want to be your default environment used in playback. Select the JRE in the list, and click the button. That JRE will then become the default, and will be indicated in parentheses after the name. You can change the default any time by coming back to this tab.

Enable Button

Use this button to enable selected Java™ environments for testing with Rational® Functional Tester. Select the JRE(s) to enable in the list, then click Enable. The modifications to the JRE(s) are done at this time. This includes adding Rational® Functional Tester classes to the JRE and modifying the accessibility.properties file, which tells Java™ to load Rational® Functional Tester classes when it runs a Java™ application. Once a JRE is enabled, that will be indicated in parentheses after its name in the list.

Disable Button

Use this button to disable selected Java™ environments for testing with Rational® Functional Tester. Select the JRE(s) to disable in the list, then click Disable. This undoes all the modifications made by Enable. Once disabled, that will be indicated in parentheses after each JRE name in the list.

Test Button

You can test that your JRE is enabled properly by clicking the Test button in the enabler. This opens the JRE Tester. It will report the JRE version, JRE vendor, and whether it is enabled successfully.

For adding and configuring Java environments:

The Java Environments tab is also used to add and edit JRE configurations. To edit the information on an existing JRE, click the name of the JRE in the Java Environments list. To add a new JRE, click the Search or Add button. Use the Set as Default button to set one of the JREs as your default to be used during playback. Whether editing or adding, make your changes, then click OK for the changes to be saved.

Java Environments List

Select the JRE that you want to edit or view. Its information will then appear to the right of the list. The information fields are described below. If your JRE is not in the list yet, click Search or Add to find and enter it.

The JRE that has default listed after it in parentheses in the list is the default JRE. It will be used in all Java™ testing unless you change this setting in the properties of a specific application.

Detailed Information for Java Environment

Contains the following fields:

Name -- This is the logical name of your JRE. For example, "Java2" may be used to represent JDK 1.2.2. This will default to the name at the end of your class path. You can edit this name.

Path -- This is the full path to the root of the JRE installation. If the path is incorrect, you will get an error message.

Run Command -- The command line that runs your Java™ applications with this JRE. The default is "java" for most JRE's. The JRE that comes with Rational® Functional Tester is "javaw."

Run Options -- This is blank by default. If you need to use any special flags for this JRE, enter them here.

Search Button

Click Search to add all your JREs into the Java environments list. This opens the Search for Java™ Environments dialog box. Choose one of the search options in that dialog and click the Search button. Note: You should not use the Search All Drives option to find JREs on Linux® or UNIX® systems. Instead use the Search In option and browse for the JRE. Rational® Functional Tester will enter all the detailed information on each JRE, except for the Run Options field.

Add Button

Click Add to browse for a new JRE to add to the list. The Add Java™ Environment dialog appears. Browse to the JRE you want to add. You can select any file under the root of the JRE, or the root directory itself. With the file selected, click the Add button. The JRE will then show up in the Java Environments list and you can edit its configuration information if necessary. Note: it is quicker to use the Search button and let Rational® Functional Tester find and enter your environments if you are entering multiple JREs.

Set as Default Button

Use this to choose which JRE you want to be your default environment used in playback. Select the JRE in the list, and click the button. That JRE will then become the default, and will be indicated in parentheses after the name. You can change the default any time by coming back to this tab. You can also override the default environment for a specific application, by indicating it in the JRE field in the Application Configuration Tool.

Remove Button

To remove an environment from the JREs list, select it, then click Remove.

OK Button

You must click OK when you are finished to save the additions or edits you made on this tab.

For more information, see Configuring Java Environments for Testing topic.

Apply Button

If you want to apply edits you make in this dialog box before you exit the dialog, click Apply . If you click Cancel, any changes you made before you clicked Apply will be saved, and changes made after will be canceled.