Increasing the Timeout (timeoutFactor)

Each test in a test suite has a timeout limit. The JavaTest harness waits for a test to complete for the duration of that limit before moving on to the next test. You can use the timeoutFactor command to change the timeout limit:

> javatest ... [initial set-up commands] ... -timeoutFactor number ... [task command] ...

See About the Command-Line Examples for a description of the use of > javatest in the example.

Each test's timeout limit is multiplied by the time factor value. For example, if you specify a value of 2.0, the timeout limit for tests with a 10 basic time limit becomes 20 minutes. See Formatting a Command for descriptions of the command formats. Note that the format of the value input for the timeout factor is dependant on the locale.

When creating a command string to change the timeout limit, include the commands in the following sequence:

  1. Set up a configuration
  2. Specify the timeout limit (timeoutFactor number)
  3. Include the runtests command (optional).

See Command-Line Overview for a detailed description of the command-line structure.

Detailed Example of timeFactor Command

In the following example, myconfig.jti and myexcludelist.jtx represent file names that might exist on your system.

Command Options Format Example:

> javatest -config myconfig.jti -timeoutFactor 2.0 -runtests

See Formatting a Command for descriptions and examples of other command formats that you can use.