Extending initialization and finalization during a test run

You can specify code for your protocol to be executed by the HCL OneTest™ Performance engine threads at strategic points during startup and shutdown. For example, you can specify code to load libraries, unload libraries, or perform other initialization or cleanup as required by the protocol.

Before you begin

You create a class that implements IKInitializeFinalize. The interface requires the following methods:
  • public void initializeEngine()
  • public void finalizeEngine()
  • public void initializeWorker()
  • public void finalizeWorker()
  • public interface IKInitializeFinalize
The IKInitializeFinalize interface provides a way for protocols to specify code that must be executed to the HCL OneTest Performance engine:
  • once by the engine at startup
  • once by the engine at shutdown
  • once by each engine worker thread at startup
  • once by each engine worker thread at shutdown
Use this startup and shutdown code when it is necessary for the engine to execute initialization or shutdown code. Also use this code for each worker thread before test execution occurs or after test execution finishes.


  1. Specify a dependency on com.ibm.rational.test.lt.execution in the plugin.xml file of a protocol.
  2. Use Add under plugin Extensions to specify an extension for com.ibm.rational.test.lt.execution.InitializeFinalize.
  3. Create a new extension element called InitializeFinalize. This element must have the following properties:
    • class: The class name that implements IKInitializeFinalize
    • id: The protocol feature ID
    • dependsOn: Leave blank
    For example:
    • class="com.ibm.rational.test.lt.execution.http.impl.HTTPInitializeFinalize"
    • id="com.ibm.rational.test.lt.feature.http"
    • dependsOn=