Setting Concurrency and Timeout Factor

You can set the concurrency and the timeout factor in one of three ways, as follows:

The Execution pane from the Configuration Editor: Question Mode view

The following text is a Note
You can also use the Configuration Editor window in Question Mode to specify the concurrency and the timeout factor.

Use the Execution pane to set the following:

Concurrency

The JavaTest harness can run tests concurrently. If you are running the tests on a multiprocessor computer or are using multiple agents on a test system, concurrency can reduce the time required to run tests. For detailed information about using agents to run tests, refer to your test suite documentation and to the JavaTest Harness Agent User's Guide if it is proviided by the test suite.

When using multiple agents to run tests, the concurrency value must not exceed the number of agents. If the concurrency value exceeds the total number of available agents, an error will occur in the test run.

If you have unexpected test failures, run the tests again, one at a time. Some test suites may not work correctly if you run tests concurrently. The default range of values used by the JavaTest harness is from 1 to 50.

For your first test run, leave this field set to 1. After the tests run properly, you can increase this value. Unless your test suite restricts concurrency, the maximum number of threads specified by the concurrency command is 50. See your test suite documentation for additional information about using concurrency values greater than 1.

This field is disabled for some test suites.

Time Factor

To prevent a stalled test from stopping a test run, most test suites set a timeout limit for each test. 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.

If you are running the tests on a particularly slow CPU or slow network, you can change the time limit by specifying a floating point value in the time factor field. Each test's timeout limit is multiplied by the time factor value. The default range of values used by the JavaTest harness is from 0.1 to 100.0.

The following text is a note
In the Time Factor field, the JavaTest harness uses the form of floating point values that is specific to the locale in which it is run. For example, if your locale uses floating point values in the form of x,x, JavaTest harness uses that form of floating point value in the Time Factor field. In setting the timeout factor in the following example, specify values of 2,0 and 0,5 if your locale uses floating point values in the form of x,x.

Example:

If you specify a value of 2.0, the timeout limit for tests with a basic 10-minute time limit becomes 20 minutes. Specifying a value of 0.5 for tests with a 10-minute limit produces a 5-minute timeout limit.

At first, use the default value of 1.0 to run tests and then, if necessary, increase the value. The actual timeout calculation for any particular test suite might vary.