Batch (batch)

The batch command is a legacy command that is used to run tests from the command line or as part of a build process. If a task command is not included in the command line, the JavaTest harness begins running tests automatically. The batch command has been superceeded by the runTests command.

The batch command is also used in the command line to close the JavaTest harness when all commands have been processed. If the batchcommand is used, the JavaTest harness GUI will not start unless explicitly started by another commands in the command string.

If the GUI is started in batch mode (such as by using the monitorAgent command), the JavaTest harness displays a dialog after all commands are executed that allows the user to cancel the automatic shutdown and to use the JavaTest harness GUI in normal mode.

In its legacy format, the batch command was required to precede the other commands. In the present format, the batch command can be specified in any location on the command line.

> javatest ... -batch ... [Setup commands] ... [task command] ...

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

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

Detailed Example of batch Command

In the following example, myconfig.jti represents a configuration file name that might exist on your system.

Command Options Format Example:

> javatest -batch -config myconfig.jti

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