Java Add-in environments

The Java Add-in uses a mechanism that supports multiple Java environments (such as IBM JRE, Oracle JRE, and Oracle JInitiator) and multiple Java versions (such as, JDK 1.5.x, 1.6.x and so on) without requiring any configuration changes. (For a list of supported environments and versions, see the Unified Functional Testing Product Availability Matrix.

This mechanism, known as the dynamic transformation support mechanism, adjusts the Java Add-in support classes according to the Java environment and version used. The dynamic transformation support mechanism uses the Tool Interface of the Java Virtual Machine (JVMTI) (or the Profiler Interface (JVMPI) when working with JDK 1.5 and earlier).

When you run the Java Add-in on Java 6 or Java 7 environments, the dynamic transformation support mechanism is invoked by the -agentlib:jvmhook, which is defined in the JAVA_TOOL_OPTIONS environment variable.

The Java agent searches for the jvmhook.dll according to the java.library.path system property. You can identify any override of this system property using the Java command line: -djava.library.path = <path> However, although you can override the java.library.path system property, we recommend extending the java.library.path and not to overwrite it.

By default, the value of the java.library.path system property is the system path. If your application is loaded with a different library path, you must either add the jvmhook.dll to a location within the java.library.path, or change the java.library.path to contain <Windows installation folder>/system32.

The <JRE root folder>/bin folder is always located in the java.library.path. If needed, you can manually copy the jvmhook.dll to this folder. However, if you need to modify more than one computer, we recommend modifying the batch file that alters the java.library.path.

For task details, see Disable Dynamic Transformation support (Advanced).