How to: Specify the Maximum Test Iterations for a Scenario Using the Load Test Editor
This topic applies to:
Visual Studio Ultimate |
Visual Studio Premium |
Visual Studio Professional |
Visual Studio Express |
|---|---|---|---|
.gif "Topic applies") |
.gif "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.
.png "Specifying test iterations in a scenario")
To specify the maximum test iterations in a scenario
Open a load test.
The Load Test Editor appears. The load test tree is displayed.
In the load test trees Scenarios folder, click the scenario node for which you want to specify the maximum number of test iterations.
On the View menu, select Properties Window.
The categories and properties of the scenario are displayed in the Properties window.
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.
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: 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
Concepts
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