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 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. |
-E name=value |
Sets an environment variable that is inherited in every test environment created.
The |
-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 |
-params [commands] [initial-files] |
Specify Parameters
If you are running a test suite that uses a parameter file (
If you are using the JavaTest GUI to run tests, refer to Using Parameter Commands for detailed information about using the |
-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. |