Specifying Additional Options

In most cases, command-line options perform functions that are also available through the GUI. However, there are several situations in which using command-line options to specify how the JavaTest harness starts is either uniquely useful or necessary.

When starting the JavaTest harness you can use options in the command line to:

Start the JavaTest harness from a writeable directory where you intend to creatre files and store test results. You must include the path of the directory [jt_dir] where the javatest.jar file is installed. The javatest.jar file is usually installed in the TCK lib directory when the JavaTest harness bundled with a TCK.

Use the following example to start the JavaTest harness with command-line options:

java -jar [jt_dir]/javatest.jar [options]

If you are running the JavaTest harness in batch mode, refer to Using Batch Mode for detailed information about using batch commands with the command-line options.

The following text is a Note
The JavaTest harness uses a new desktop when you include GUI options in the command line.

The following options can be used in the command line to specify how the Javatest harness starts:

Option Function
-EsysProps Includes all system properties in test execution environments.
-Ename=value Sets an environment variable that is inherited in every test environment created.

The -Ename=value command line option tunnels in values from the external shell. The method used in previous versions of the JavaTest harness to tunnel in values from the external shell is now deprecated.

-agentPoolPort port Set the Agent Pool Port Number

Use this option only if you are configuring the JavaTest harness and the agent to use a port other than 1907.

-agentPoolTimeout #seconds Set the Agent Pool Timeout

Sets the number of seconds that the JavaTest harness waits between tests for an available agent before reporting the test result as an error. The default value of 180 seconds is usually sufficient. You can also set this value in the GUI if you are not running the JavaTest harness in batch mode.

-startAgentPool Start the Active Agent Pool

If you use an active agent and run the JavaTest harness in batch mode, you must add -startAgentPool to the command string to start the Agent Pool.

-params [commands] [initial-files] Specify Parameters

If you are running a test suite that uses a parameter file (.jtp), you can specify different parameter values when starting the JavaTest harness by including the -params option and the appropriate parameter command in the command line.

If you are using the JavaTest GUI to run tests, refer to Using Parameter Commands for detailed information about using the -params option and its commands.

-newDesktop Add -newDesktop to the command string to start the JavaTest GUI without using a previous desktop. The JavaTest GUI will ignore any previous settings and open the Welcome to JavaTest dialog box. Refer to Welcome Dialog Boxes for a description of the dialog box.

A new desktop is automatically started and the old desktop is ignored when explicit GUI command line options are used.