Enable Java environments
You need to enable Java environments before you can use Functional Tester to test Java applications. Functional Tester is shipped with a JRE that is automatically enabled during your install. The JRE is called "Default JRE." To enable other JREs, or if you install a new JRE, rerun the enabler.
To run the Java Enabler:
Procedure
- Click Configure > Enable Environments for Testing any time from Functional Tester to invoke the Enable Environments dialog box (the enabler). Click the Java Environments tab.
- Click Search. The Search for Java Environments dialog box opens.
- Select one of the following search mechanisms.
- Quick Search can only be used on Windows systems. It searches the Windows registry for the Java environments, and is quicker than searching your hard drive(s)
- Search All Drives scans all of your hard drives or partitions to locate all the Java environments on your system
You should not use the Search All Drives option to find JREs on Linux systems. Instead use the Search in option and browse for the JRE.
- Select Search in to browse to a specific drive or root directory to search.
- After choosing one of the search mechanisms, click the Search button.
- When the search is complete,IBM Rational Functional Tester lists the JREs in the Java Environments list on the left side of the Java Environments tab. The list includes the full path name of each environment. Decide which environments you want to enable.
- Select the environments you want to enable by clicking on them in the list. You can select multiple JREs by using the Ctrl key while selecting. Click the Select All button if you want to enable all of the JREs.
- Click Enable. The selected environment(s) will be enabled for Java testing. The enabled environments will be indicated in parentheses after each JRE name in the list.
- Select a JRE to be the default, and click the Set as Default button.
- Click Close.
Results
Notes:
Enable JVM: If you are using Windows XP, enable the JVM by specifying the JRE location using the Add button.
But for other platforms, when you run the Functional Tester for the first time, 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.
However, if you experience an error regarding the Java plug-in during HTML testing, or when trying to launch the Verification Point Comparator from the HTML log, you need to make sure your plug-in is configured properly. See Enable the Java Plug-in of a Browser for instructions.
You do not have to use the Search button to add an environment. You can click the Add button instead in Step 2. This brings up the Add Java Environment dialog box, which you can use to locate the new Java environment. After you select it and click Add, the environment will then be added to the Java Environments list, and you follow steps 4 - 7 to enable or disable it. If you try to add a file that is not a Java environment, you will get an error and it won't be added to the list.
If your JRE is not enabled, you will be able to tell because the Recording Monitor will be blank when you try to record against a Java application. We recommend leaving the Recording 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, see Enable Web Browsers.
You can test that your JRE is enabled properly by clicking the Test button in the enabler. This opens the JRE Tester, which reports the JRE version, JRE vendor, and whether the JRE is enabled successfully. Click OK to close the JRE Tester.
Upgrade Note: If you are upgrading IBM Rational Functional Tester from earlier version versions, you might have to re-enable the Java environment. For more information, see upgrading from earlier versions of IBM Rational Functional Tester topic.
Related concepts
Browser enablement diagnostic tool
Related tasks
Configure Java environments for testing
Run a script from Functional Tester
Related reference