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 of the command-line interface include the following capabilities:
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.
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.
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.