# Using the `batch` Command

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 harness begins running tests automatically. The `runTests` command supercedes the `batch` command.

The `batch` command is also used in the command line to close the harness when all commands are processed. If the `batch`command is used, the 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 including the `monitorAgent` command), after all commands are executed the harness displays a dialog that enables the user to cancel the automatic shutdown and to use the 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.

> jtharness ... `-batch` ... [setup-commands] ... [task-command] ...

See About the Command-Line Examples for a description of use of > 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:

> jtharness `-batch -config` myconfig`.jti`

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

Copyright © 2001, 2009, Oracle and/or its affiliates. All rights reserved.