How to: Specify the Maximum Test Iterations for a Scenario Using the Load Test Editor

  • Article

This topic applies to:

Visual Studio Ultimate

Visual Studio Premium

Visual Studio Professional 

Visual Studio Express
Topic applies Topic does not apply Topic does not apply Topic does not apply

After you create your load test by using the New Load Test Wizard, you can use the Load Test Editor to change the scenarios properties to meet your testing needs and goals. For more information, see How to: Create a New Load Test Using the New Load Test Wizard.

Note

For a full list of the load test scenario properties and their descriptions, see Load Test Scenario Properties.

You can specify the maximum number of times that you want your tests to run for a scenario by using the Load Test Editor to change the Maximum Test Iterations property in the Properties window.

The Maximum Test Iterations property controls the maximum number of test iterations to run for the scenario. Just as for the Test Iterations property in the load test run settings, this is the maximum across all users on all agents, not a per user setting.

For sequential test mix, one iteration is one pass through all the tests in the mix. For all other test mixes, each test execution counts as an iteration. For more information, see About the Mix Control for Load Tests.

If the load test is a duration-based load test, and the duration expires before the iteration count is complete, the test will still stop. If the test is iteration-based, and the test iterations are met before scenario iterations, the test will stop. The duration is configured by using the Run Duration property in the Properties window associated with a run setting in a load test.

When the scenario iteration count is met, the scenario will stop running, but any other active scenarios will continue to run.

Note

A related property is the Unique property on a Web test data source, which move sequentially through the data, row-by-row, but only one time for each record. For more information, see Binding a Data Source to a Web Performance Test.

The Maximum Test Iterations property is useful for a variety of situations. Some load testers prefer to conduct iteration-based testing, whereas other load testers prefer to conduct duration-based testing.

Specifying test iterations in a scenario

To specify the maximum test iterations in a scenario

  1. Open a load test.

  2. The Load Test Editor appears. The load test tree is displayed.

  3. In the load test trees Scenarios folder, click the scenario node for which you want to specify the maximum number of test iterations.

  4. On the View menu, select Properties Window.

    The categories and properties of the scenario are displayed in the Properties window.

  5. In the text box for the Maximum Test Iterations property, type a value that indicates the maximum number of tests to run for the scenario when the load test is run.

    Note

    Using a value of 0 for the Maximum Test Iterations property specifies no maximum iterations.

  6. After you have finished changing the property, click Save on the File menu. You can then run your load test by using the new Maximum Test Iterations value.

See Also

Tasks

How to: Create a Scenario Used to Model User Activities, Tests, Browsers and Networks Using the New Load Test Wizard

How to: Run a Load Test Using Test Controllers and Test Agents Specified in a Test Setting

How to: Specify the Number of Test Iterations in a Load Test Run Setting

How to: Specify the Think Times Between Test Iterations for a Scenario Using the Load Test Editor

Reference

New Load Test Wizard

Concepts

Load Test Scenario Properties

Configuring Test Iterations in a Load Test Scenario

Other Resources

Editing Load Test Scenarios Using the Load Test Editor

Creating Load Tests Using the New Load Test Wizard

Distributing Load Tests Across Multiple Test Machines Using Test Controllers and Test Agents