Command-Line Interface

The test harness provides two interfaces, a Graphical User Interface (GUI) and a command-line interface.The command-line interface provides test harness functionality for configuring and executing tests as well as creating reports without using the GUI. This enables you to use the harness to run tests in build scripts and other automated processes. See the Graphical User Interface User's Guide for a description of the harness GUI.

Features

Features of the command-line interface include the following capabilities:

Configuration Information

The GUI Configuration Editor collects the required configuration information about how tests are run on a specific test platform and saves that information in a configuration file (.jti file). By using configuration files, the harness can run programs on a variety of Java platforms. The harness writes the test results in the work directory associated with that configuration and test suite. See the Glossary for detailed descriptions of the terms .jti file, work directory, and configuration file. See the Graphical User Interface User's Guide for a description of the GUI Configuration Editor.

Legacy Environment Files and Parameter Files

For backwards compatibility, older test suites can continue to use environment and parameter files in the command line. See the Glossary for detailed descriptions of the terms .jte file and .jtp file.

See the Graphical User Interface User's Guide for a description of using a legacy configuration file to create current configuration file.

Online Documentation

The harness provides extensive online documentation that is available from the command line. To display the available command-line options, type the following at a system prompt:

java -jar testsuite/lib/javatest.jar -help

See Information Commands for detailed information about using special -help options to search for and display command-line information.

To display the online User's Guide without starting the GUI, type the following at a system prompt:

java -jar testsuite/lib/javatest.jar -onlinehelp

Include the path of the directory where the javatest.jar file is installed (represented as testsuite/lib in the example). The javatest.jar file is usually installed in the test suite lib directory when the harness is bundled with a test suite.