Java Environments tab of the Enable Environments dialog box
This dialog is opened by clicking Configure > Enable Environments for Testing from Functional Tester. The Java Environments tab is used to enable Java environments and to add and configure Java environments. Information about enabling JRE's is presented first. Information about adding and configuring JRE's is presented below that.
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 Functional Tester to test Java applications. It modifies your Java environments to allow Java programs run under them to be tested by Functional Tester. The enabler scans your hard drive(s) looking for Java environments. It allows 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 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, rerun the enabler after you complete the installation of the Java environment. You can run the enabler any time from Functional Tester by clicking Configure > Enable Environments for Testing. Note that the first time you run 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, rerun the enabler to enable it.
Java Environments List
Functional Tester is shipped with a JRE that is automatically enabled during your install. 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 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 Functional Tester search your hard 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. We recommend that you use the Search button to locate all JREs on your system, at least for the first time you use Functional Tester. 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 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 Functional Tester classes to the JRE and modifying the accessibility.properties file, which tells Java to load 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 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.
If your JRE is not enabled, you will be able to tell because the Record Monitor is blank when you try to record against a Java application. You should leave the Record Monitor in view while recording for this reason. If you see this symptom, you need to run the enabler.
To enable browsers for HTML testing, click on the Web Browsers tab of the enabler and click the Help button, or see Enabling Web Browsers topic.
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 on its name 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 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. Functional Tester will fill in 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 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.
Related tasks