About Batch Runs

Applies to LoadComplete 4.97, last modified on May 20, 2019

You use batch runs to execute a group of load tests. This topic describes the batch runs and explain how you can create and launch them.

About Batch Runs

A batch is a collection of load tests. You can run the entire collection with just one command. You can run it at a scheduled time without further user interaction.

To create and edit batch runs, you use the BatchRuns project item:

Load testing with LoadComplete: Batch runs in the project

Each batch can include one or multiple load tests. You can add one test to a batch to schedule this test execution.

BatchRun Editor

To invoke the Batch Run editor, double-click a BatchRun project item in the Project Explorer.

Load testing with LoadComplete: Batch runs editor
The Editor Toolbar

Use the following commands to add new tests to a batch, and then to run it:

Command Description
Run Selected Batch Runs the batch opened in the editor.
New Item Adds a test to the batch (see below).

Use these commands to configure the batch run parameters:

Command Description
Stop on error Stops the batch run if some test finishes with an error.

Note that LoadComplete checks the test results after the test execution is over. If you want the batch run to stop right after the first error occurs in a test, enable the Stop on error settings both for the batch run and for your load tests.

Export summary Commands LoadComplete to export summary test results to PDF files. LoadComplete saves one file per each test after that test execution is over. The PDF files have the same data and sections as the test log panels.
Export details Commands LoadComplete to export detailed test results in XML files. LoadComplete saves results for a test after that test execution is over.
Use this setting, if you are going to process test results after the run. For information on the XML result format, see Structure of Exported XML Files and Data Description.

Creating a Batch Run

  1. Right-click BatchRuns in the Project Explorer and select Create New Batch Run from the context menu:

    Create New Batch

    This will add a new BatchRun item to the project and open it for editing.

  2. In the batch run editor, click New Item on the toolbar to add a new test to the batch. Then choose a test from the drop-down list or enter the test name:

    Create New Batch

    To change a test, simply select another test from the drop-down list.

    To delete a test from the batch, select it and press DEL, or right-click the test and choose Delete from the context menu

  3. If needed, check the Stop on error, Export summary and Export details settings. See above.

Running a Batch

  1. Open the batch for editing. Then click Run Selected Batch on the editor toolbar to start the batch or to schedule its run.

    Load testing with LoadComplete: Running a batch

    This will invoke the following dialog:

    Load testing with LoadComplete: Specify the time to run the batch
  2. In the dialog, you can choose –

    • To run the batch right at the moment.

    • Run the batch at specified date and time.

    • Postpone the run for the specified time.

    You can also set the timeout for the batch run.

    Select the options you need and click OK to run the batch or to schedule its start.

Once the batch run has started, its tests will run one after another in the order they have in the batch.

You can monitor the test execution on the Graphs page.

You can also run a batch from the command line. To do this, use the following arguments:

LoadComplete.exe "C:\Work\MyProject.ltp /RunBatch:"My Batch Run 1" /Delay:"00:01:30" /TimeLimit:"00:02:00"

For more information on the /RunBatch, /Delay and /TimeLimit arguments, see LoadComplete Command Line.


After the batch run is over, LoadComplete displays a message box informing you about the results:

Load testing with LoadComplete: The batch run results message box

If you selected the Export summary or Export details setting before the run, the message box will also display the path to the resulting PDF and XML files. You can find these files any time later in the <YourProject>/Log/<BatchName_DateTime-of-the-Run> folder.

You can find detailed results of each test of a batch in the test log:

Load testing with LoadComplete: Test results in the test log

These results do not differ from the results that you get when run a test individually (not from a batch).

Tip: LoadComplete checks parameters of every test before running this test. If this check fails, the test log will not contain an error for the test, because the test log includes only the errors that occur during the test run, and the check error occurs “before” the run. An example of such an error is the error that occurs when a load test does not specify a scenario for some virtual users. To find the cause of the problem, see the error description in the Errors.log file. You can find it in the <YourProject>/Log/<BatchName_DateTime-of-the-Run> folder. LoadComplete creates this file if there are no log files that inform you about the problem.

See Also

About Test Results
About Load Test Editor
Scheduling Test Runs
Runtime Pages
Structure of Exported XML Files
Data Description
Analyzing Results

Highlight search results