IBM® Engineering Test Management script arguments

You can pass arguments from IBM® Engineering Test Management while running an IBM® Rational® Functional Tester script.

You can pass the following types of arguments while running functional test scripts from Engineering Test Management:
  • Script arguments: These arguments are available to a script writer within the script as arguments to the testMain() method.
  • Execution arguments: These arguments govern playback. If Rational® Functional Tester test scripts that run from Engineering Test Management have a dependency on a third-party library, you must consider the following points:
    • You must use the -projectpath or -classpath command line argument to specify a third-party library. For example: -projectpath C:\temp\myjar.jar. See Command line interface.
      Note: Command line arguments such as -enable, -inspector, or -appconfig that are not applicable for Engineering Test Management is not considered during playback.
    • You can pass java properties along with execution arguments. For example, -Dmyprop=value. You can also pass multiple java properties that are separated by space along with execution arguments. For example, -Dmyprop1=value1 -Dmyprop2=value2 -projectpath C:\tmp\myjar.jar.

  • dataset iteration: If there is a dataset associated with a script, you can pass the number of times the scripts must run by accessing records from the dataset.
Additionally, you can pass execution task details of Engineering Test Management to a functional test script so that information about the Engineering Test Management test cases is accessed during script execution.

To access execution task details within the testMain() method in a functional test script, you must provide the path to the XML file that describes the Engineering Test Management execution task.

In the functional test script, you must add String path = System.getProperty("rqm.task") to get the path of the XML file.

Refer to the XML Representation of an adapter Task section on the http://open-services.net/bin/view/Main/QmExecutionAdapter web page for information about the schema of the execution task that is represented in this file.

This file points to other resources for other Engineering Test Management assets such as test cases. You can find the schemas for the other resources on the same site. By using the data in this XML file, you can communicate with Engineering Test Management.

Note: The details Engineering Test Management that you pass using this method are specific and local to the script. If you want to specify details from the Engineering Test Management test script, test case, or test suite levels, you use execution variables. See IBM Engineering Test Management execution variables.