Additional Setup Commands

In most cases, you use the command line to perform functions that are also available through the GUI. However, you can also use the command line to specify how the JavaTest harness starts.

When starting the JavaTest harness, you can include additional commands in the command line to:

The JavaTest harness uses a new desktop when you include GUI commands in the command line.

The following table describes the commands used in the command line to specify how the JavaTest harness starts.

Command 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 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 command only when 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 from the command line.

-startAgentPool Start the Active Agent Pool

If you use an active agent and run the JavaTest harness from the command line, you must add -startAgentPoolto the command string to start the Agent Pool.