Using Parameter Commands

These commands are deprecated. You should use the -batch commands to perform these functions. If you are running a test suite that uses a parameter file (.jtp), for backwards compatibility you can continue to use the following commands with the -param option to change one or more parameter values used to start the JavaTest harness:

Command Description
-t testsuite
or
-testsuite testsuite
Specifies the test suite that is run.
-keywords keyword-expr Restricts the set of tests to be run based on keywords associated with tests in the test suite.
-status status-expr Includes or excludes tests from a test run based on their status from a previous test run. Valid status expressions are error, failed, not run, and passed.
-exclude exclude-list-file Specifies an exclude list file. Exclude list files contain a list of tests that are not to be run. Exclude list files conventionally use the .jtx extension and are normally supplied with a test suite.
-envFile environment-file Specifies an environment file that contains information used by the JavaTest harness to run tests in your computing environment. You can specify an environment file for the JavaTest harness to use when running tests.
-env environment Specifies a test environment from an environment file.
-concurrency number Specifies the number of tests run concurrently. If you are running the tests on a multi-processor computer, concurrency can speed up your test runs.
-timeoutFactor number Increases the timeout limit by specifying a value in the time factor option.

The timeout limit is the amount of time that the JavaTest harness waits for a test to complete before moving on to the next test. Each test's timeout limit is multiplied by the time factor value.

For example, if you specify a value of "2", the timeout limit for tests with a 10 basic time limit becomes 20 minutes.

-r report-directory
or
-report report-directory
Specifies the directory where the JavaTest harness writes test report files. If this path is not specified, the reports are written to a directory named report in the directory from which you started the JavaTest harness.
-w work-directory
or
-workDir workDirectory
Specifies a work directory for the test run. Each work directory is associated with a test suite and stores its test result files in a cache.