Modified: jmeter/trunk/docs/usermanual/test_plan.html URL: http://svn.apache.org/viewvc/jmeter/trunk/docs/usermanual/test_plan.html?rev=1664961&r1=1664960&r2=1664961&view=diff ============================================================================== --- jmeter/trunk/docs/usermanual/test_plan.html (original) +++ jmeter/trunk/docs/usermanual/test_plan.html Sun Mar 8 10:22:58 2015 @@ -1,552 +1,201 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> -<!-- - Licensed to the Apache Software Foundation (ASF) under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - The ASF licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. ---> - -<!-- Content Stylesheet for Site --> - - -<!-- start the processing --> -<html> -<head> -<link rel="stylesheet" type="text/css" href="../css/style.css"/> -<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/> - -<title>Apache JMeter - User's Manual: Elements of a Test Plan</title> -</head> - -<body bgcolor="#ffffff" text="#000000" link="#525D76"> -<table width="100%" cellspacing="0" border="0"> -<tr> -<td width="90%" align="left"> -<table border="0" cellspacing="0"> -<tr> -<td width="10%"> -<a href="http://www.apache.org";><img title="Apache Software Foundation" width="290" height="75" src="../images/asf-logo.png" border="0"/></a> -</td> -<td align="left" width="40%"> - -<a href="http://jmeter.apache.org/";><img width="182" height="88" src="../images/logo.jpg" alt="Apache JMeter" title="Apache JMeter" border="0"/></a> -</td> -</tr> -</table> -</td> -<td align="left" width="50%"> -<table cellspacing="0" align="right" border="0"> -<tr> -<td align="left"> <a href="https://twitter.com/share"; -class="twitter-share-button" -data-text="Powerful Load Testing with -Apache #JMeter" data-via="ApacheJMeter" -data-lang="en-gb" data-size="large">Tweet</a> -<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script> -</td> -<td align="right"> <a -href="https://twitter.com/ApacheJMeter"; -class="twitter-follow-button" -data-show-count="false" data-lang="en-gb" -data-size="large">Follow</a> -<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script> -</td> -</tr> -</table> -</td></tr> -</table> - -<table border="0" width="100%" cellspacing="4"> -<tr><td colspan="2"> -<hr noshade size="1"/> -</td></tr> -<tr> -<!-- LEFT SIDE NAVIGATION --> -<td width="20%" valign="top" nowrap="true"> -<table border="0" width="100%" cellspacing="0"> -<tr><td> -<p><strong>About</strong></p> -<ul> -<li><a href="../index.html">Overview</a> -</li> -<li><a href="http://twitter.com/ApacheJMeter";>JMeter on Twitter</a> -<img src="../images/twitter.png" align="top"/></li> -<li><a href="../issues.html">Issue Tracking</a> -</li> -<li><a href="http://projects.apache.org/feeds/rss/jmeter.xml";>Subscribe to What's New</a> -</li> -<li><a href="http://www.apache.org/licenses/";>License</a> -</li> -</ul> -<p><strong>Download</strong></p> -<ul> -<li><a href="../download_jmeter.cgi">Download Releases</a> -</li> -<li><a href="../nightly.html">Developer (Nightly) Builds</a> -</li> -</ul> -<p><strong>Documentation</strong></p> -<ul> -<li><a href="../changes.html">Changes per version</a> -</li> -<li><a href="../usermanual/get-started.html">Get Started</a> -</li> -<li><a href="../usermanual/index.html">User Manual</a> -</li> -<li><a href="../usermanual/best-practices.html">Best Practices</a> -</li> -<li><a href="../usermanual/component_reference.html">Component Reference</a> -</li> -<li><a href="../usermanual/functions.html">Functions Reference</a> -</li> -<li><a href="../api/index.html">Javadocs</a> -</li> -<li><a href="../building.html">Building JMeter and Add-Ons</a> -</li> -<li><a href="http://wiki.apache.org/jmeter";>JMeter Wiki</a> -</li> -<li><a href="http://wiki.apache.org/jmeter/JMeterFAQ";>FAQ (Wiki)</a> -</li> -</ul> -<p><strong>Tutorials (PDF format)</strong></p> -<ul> -<li><a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a> -</li> -<li><a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording Tests</a> -</li> -<li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit Sampler</a> -</li> -<li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a> -</li> -<li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a> -</li> -</ul> -<p><strong>Community</strong></p> -<ul> -<li><a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a> -</li> -<li><a href="../mail.html">Mailing Lists</a> -</li> -<li><a href="../svnindex.html">SVN Repositories</a> -</li> -</ul> -<p><strong>Foundation</strong></p> -<ul> -<li><a href="http://www.apache.org/";>ASF</a> -</li> -<li><a href="http://www.apache.org/foundation/getinvolved.html";>Get Involved in the ASF</a> -</li> -<li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a> -</li> -<li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a> -</li> -</ul> -</td></tr> -<tr><td> -<iframe src="http://www.apache.org/ads/button.html"; style="border-width:0; float: left;" frameborder="0" scrolling="no"></iframe> -</td></tr> -</table> -</td> -<td width="80%" align="left" valign="top"> -<table> -<tr> -<td bgcolor="#525D76"> -<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-web-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div> -</td> -</tr> -</table> -<br> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<strong>4. Elements of a Test Plan</strong></font> -</td></tr> -<tr><td> -<blockquote> -<p> -The Test Plan object has a checkbox called "Functional Testing". If selected, it +<!DOCTYPE html SYSTEM "about:legacy-compat"> +<html lang="en"><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-15"><title>Apache JMeter + - + User's Manual: Elements of a Test Plan</title><meta name="viewport" content="width=device-width, initial-scale=1"><link href="http://fonts.googleapis.com/css?family=Merriweather:400normal"; rel="stylesheet" type="text/css"><link rel="stylesheet" type="text/css" href="../css/new-style.css"></head><body role="document"><a href="#content" class="hidden">Main content</a><div class="header"><!-- + APACHE LOGO + --><div><a href="http://www.apache.org";><img title="Apache Software Foundation" width="290" height="75" src="../images/asf-logo.png" alt="Logo ASF"></a></div><!-- + PROJECT LOGO + --><div><a href="http://jmeter.apache.org/";><img src="../images/logo.jpg" alt="Apache JMeter"></a></div><div class="twitter"><div><a href="https://twitter.com/share"; class="twitter-share-button" data-text="Powerful Load Testing with Apache #JMeter" data-via="ApacheJMeter" data-lang="en-gb" data-size="large">Tweet</a><script> + (function(d,s,id){ + var js, + fjs=d.getElementsByTagName(s)[0], + p=/^http:/.test(d.location)?'http':'https'; + if (!d.getElementById(id)) { + js=d.createElement(s); + js.id=id; + js.src=p+'://platform.twitter.com/widgets.js'; + fjs.parentNode.insertBefore(js,fjs); + } + })(document, 'script', 'twitter-wjs'); + </script></div><div><a href="https://twitter.com/ApacheJMeter"; class="twitter-follow-button" data-show-count="false" data-lang="en-gb" data-size="large">Follow</a><script>(function(d,s,id){ + var js, + fjs=d.getElementsByTagName(s)[0], + p=/^http:/.test(d.location)?'http':'https'; + if (!d.getElementById(id)) { + js=d.createElement(s); + js.id=id; + js.src=p+'://platform.twitter.com/widgets.js'; + fjs.parentNode.insertBefore(js,fjs); + } + })(document, 'script', 'twitter-wjs'); + </script></div></div><div class="banner"><iframe src="http://www.apache.org/ads/bannerbar.html"; style="border-width:0;" frameborder="0" scrolling="no"></iframe><div class="clear"></div></div></div><div class="nav"><ul class="menu"><li><div class="menu-title">About</div><ul><li><a href="../index.html">Overview</a></li><li><a href="http://twitter.com/ApacheJMeter";>JMeter on Twitter<img src="../images/twitter.png" alt="Icon for JMeter on Twitter"></a></li><li><a href="../issues.html">Issue Tracking</a></li><li><a href="http://projects.apache.org/feeds/rss/jmeter.xml";>Subscribe to What's New</a></li><li><a href="http://www.apache.org/licenses/";>License</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Download</div><ul><li><a href="../download_jmeter.cgi">Download Releases</a></li><li><a href="../nightly.html">Developer (Nightly) Builds</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Documentation</div><ul><li><a href="../changes.html" >Changes per version</a></li><li><a href="../usermanual/get-started.html">Get >Started</a></li><li><a href="../usermanual/index.html">User >Manual</a></li><li><a href="../usermanual/best-practices.html">Best >Practices</a></li><li><a >href="../usermanual/component_reference.html">Component >Reference</a></li><li><a href="../usermanual/functions.html">Functions >Reference</a></li><li><a href="../api/index.html">Javadocs</a></li><li><a >href="../building.html">Building JMeter and Add-Ons</a></li><li><a >href="http://wiki.apache.org/jmeter";>JMeter Wiki</a></li><li><a >href="http://wiki.apache.org/jmeter/JMeterFAQ";>FAQ >(Wiki)</a></li></ul></li></ul><ul class="menu"><li><div >class="menu-title">Tutorials (PDF format)</div><ul><li><a >href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed >Testing</a></li><li><a >href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording >Tests</a></li><li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit >Sampler</a></li><li><a href="../us ermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a></li><li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Community</div><ul><li><a href="http://wiki.apache.org/jmeter/JMeterCommitters";>Contributors</a></li><li><a href="../mail.html">Mailing Lists</a></li><li><a href="../svnindex.html">SVN Repositories</a></li></ul></li></ul><ul class="menu"><li><div class="menu-title">Foundation</div><ul><li><a href="http://www.apache.org/";>ASF</a></li><li><a href="http://www.apache.org/foundation/getinvolved.html";>Get Involved in the ASF</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li></ul></li></ul></div><div class="main" id="content"><ul class="pagelinks"><li><a href="build-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-web-test- plan.html">Next ></a></li></ul><div class="section"><h1>4. Elements of a Test Plan</h1> + +<p>The Test Plan object has a checkbox called "Functional Testing". If selected, it will cause JMeter to record the data returned from the server for each sample. If you have selected a file in your test listeners, this data will be written to file. This can be useful if you are doing a small run to ensure that JMeter is configured correctly, and that your server is returning the expected results. The consequence is that the file will grow huge quickly, and JMeter's performance will suffer. This option should be off if you are doing stress-testing (it -is off by default). -</p> -<p> -If you are not recording the data to file, this option makes no difference. -</p> -<p> -You can also use the Configuration button on a listener to decide what fields to save. -</p> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="thread_group"><strong>4.1 ThreadGroup</strong></a> -<a class="sectionlink" href="#thread_group" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -Thread group elements are the beginning points of any test plan. +is off by default). </p> +<p>If you are not recording the data to file, this option makes no difference.</p> +<p>You can also use the Configuration button on a listener to decide what fields to save.</p> + +<div class="subsection"><h2>4.1 Thread Group<a class="sectionlink" href="#thread_group" title="Link to here">¶</a></h2> +<p>Thread group elements are the beginning points of any test plan. All controllers and samplers must be under a thread group. Other elements, e.g. Listeners, may be placed directly under the test plan, in which case they will apply to all the thread groups. As the name implies, the thread group element controls the number of threads JMeter will use to execute your test. The controls for a thread group allow you to: +<ul><li>Set the number of threads</li> +<li>Set the ramp-up period</li> +<li>Set the number of times to execute the test</li> +</ul></p> -<ul> -<li> -Set the number of threads -</li> - - -<li> -Set the ramp-up period -</li> - - -<li> -Set the number of times to execute the test -</li> - - -</ul> -</p> -<p> -Each thread will execute the test plan in its entirety and completely independently +<p>Each thread will execute the test plan in its entirety and completely independently of other test threads. Multiple threads are used to simulate concurrent connections -to your server application. -</p> -<p> -The ramp-up period tells JMeter how long to take to "ramp-up" to the full number of +to your server application.</p> + +<p>The ramp-up period tells JMeter how long to take to "ramp-up" to the full number of threads chosen. If 10 threads are used, and the ramp-up period is 100 seconds, then JMeter will take 100 seconds to get all 10 threads up and running. Each thread will start 10 (100/10) seconds after the previous thread was begun. If there are 30 threads -and a ramp-up period of 120 seconds, then each successive thread will be delayed by 4 seconds. -</p> -<p> -Ramp-up needs to be long enough to avoid too large a work-load at the start +and a ramp-up period of 120 seconds, then each successive thread will be delayed by 4 seconds.</p> + +<p>Ramp-up needs to be long enough to avoid too large a work-load at the start of a test, and short enough that the last threads start running before the first ones finish (unless one wants that to happen). - </p> <p> - Start with Ramp-up = number of threads and adjust up or down as needed. - </p> -<p> -By default, the thread group is configured to loop once through its elements. -</p> -<p> -Version 1.9 introduces a test run -<b> -scheduler -</b> -. + +<p>By default, the thread group is configured to loop once through its elements.</p> + +<p>Version 1.9 introduces a test run <b>scheduler</b>. Click the checkbox at the bottom of the Thread Group panel to reveal extra fields in which you can enter the start and end times of the run. When the test is started, JMeter will wait if necessary until the start-time has been reached. At the end of each cycle, JMeter checks if the end-time has been reached, and if so, the run is stopped, - otherwise the test is allowed to continue until the iteration limit is reached. -</p> -<p> -Alternatively, one can use the relative delay and duration fields. - Note that delay overrides start-time, and duration over-rides end-time. -</p> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="controllers"><strong>4.2 Controllers</strong></a> -<a class="sectionlink" href="#controllers" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> + otherwise the test is allowed to continue until the iteration limit is reached.</p> + <p>Alternatively, one can use the relative delay and duration fields. + Note that delay overrides start-time, and duration over-rides end-time.</p> +</div> +<div class="subsection"><h2>4.2 Controllers<a class="sectionlink" href="#controllers" title="Link to here">¶</a></h2> + +<p> JMeter has two types of Controllers: Samplers and Logical Controllers. These drive the processing of a test. - </p> -<p> -Samplers tell JMeter to send requests to a server. For + +<p>Samplers tell JMeter to send requests to a server. For example, add an HTTP Request Sampler if you want JMeter to send an HTTP request. You can also customize a request by adding one or more Configuration Elements to a Sampler. For more information, see +<a href="#samplers">Samplers</a>.</p> -<a href="#samplers"> -Samplers -</a> -. -</p> -<p> -Logical Controllers let you customize the logic that JMeter uses to +<p>Logical Controllers let you customize the logic that JMeter uses to decide when to send requests. For example, you can add an Interleave Logic Controller to alternate between two HTTP Request Samplers. -For more information, see -<a href="#logic_controller"> -Logical Controllers -</a> -. -</p> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="samplers"><strong>4.2.1 Samplers</strong></a> -<a class="sectionlink" href="#samplers" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> +For more information, see <a href="#logic_controller">Logical Controllers</a>.</p> + +</div> + +<div class="subsection"><h2>4.2.1 Samplers<a class="sectionlink" href="#samplers" title="Link to here">¶</a></h2> +<p> Samplers tell JMeter to send requests to a server and wait for a response. They are processed in the order they appear in the tree. Controllers can be used to modify the number of repetitions of a sampler. - </p> <p> - JMeter samplers include: - <ul> - - -<li> -FTP Request -</li> - - -<li> -HTTP Request -</li> - - -<li> -JDBC Request -</li> - - -<li> -Java object request -</li> - - -<li> -LDAP Request -</li> - - -<li> -SOAP/XML-RPC Request -</li> - - -<li> -WebService (SOAP) Request -</li> - - + <li>FTP Request</li> + <li>HTTP Request</li> + <li>JDBC Request</li> + <li>Java object request</li> + <li>LDAP Request</li> + <li>SOAP/XML-RPC Request</li> + <li>WebService (SOAP) Request</li> </ul> - Each sampler has several properties you can set. You can further customize a sampler by adding one or more Configuration Elements to the Test Plan. - </p> -<p> -If you are going to send multiple requests of the same type (for example, + +<p>If you are going to send multiple requests of the same type (for example, HTTP Request) to the same server, consider using a Defaults Configuration -Element. Each controller has one or more Defaults elements (see below). -</p> -<p> -Remember to add a Listener to your test plan to view and/or store the -results of your requests to disk. -</p> -<p> -If you are interested in having JMeter perform basic validation on -the response of your request, add an -<a href="#assertions"> -Assertion -</a> - to +Element. Each controller has one or more Defaults elements (see below). </p> + +<p>Remember to add a Listener to your test plan to view and/or store the +results of your requests to disk.</p> + +<p>If you are interested in having JMeter perform basic validation on +the response of your request, add an <a href="#assertions">Assertion</a> to the sampler. For example, in stress testing a web application, the server may return a successful "HTTP Response" code, but the page may have errors on it or may be missing sections. You could add assertions to check for certain HTML tags, common error strings, and so on. JMeter lets you create these assertions using regular -expressions. -</p> -<p> -<a href="component_reference.html#samplers"> -JMeter's built-in samplers -</a> -</p> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="logic_controller"><strong>4.2.2 Logic Controllers</strong></a> -<a class="sectionlink" href="#logic_controller" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -Logic Controllers let you customize the logic that JMeter uses to +expressions.</p> + +<p><a href="component_reference.html#samplers">JMeter's built-in samplers</a></p> +</div> + +<div class="subsection"><h2>4.2.2 Logic Controllers<a class="sectionlink" href="#logic_controller" title="Link to here">¶</a></h2> +<p>Logic Controllers let you customize the logic that JMeter uses to decide when to send requests. Logic Controllers can change the order of requests coming from their child elements. They can modify the requests themselves, cause JMeter to repeat requests, etc. - </p> -<p> -To understand the effect of Logic Controllers on a test plan, consider the -following test tree: -</p> -<p> - - -<ul> +<p>To understand the effect of Logic Controllers on a test plan, consider the +following test tree:</p> -<li> -Test Plan -</li> - - -<ul> - - -<li> -Thread Group -</li> - - -<ul> - - -<li> -Once Only Controller -</li> - - -<ul> - - -<li> -Login Request (an -<a href="../usermanual/component_reference.html#HTTP_Request">HTTP Request</a> -) -</li> - - -</ul> - - -<li> -Load Search Page (HTTP Sampler) -</li> - - -<li> -Interleave Controller -</li> - - +<p> <ul> - - -<li> -Search "A" (HTTP Sampler) -</li> - - -<li> -Search "B" (HTTP Sampler) -</li> - - -<li> -HTTP default request (Configuration Element) -</li> - - -</ul> - - -<li> -HTTP default request (Configuration Element) -</li> - - -<li> -Cookie Manager (Configuration Element) -</li> - - -</ul> - - -</ul> - - +<li>Test Plan</li> + <ul> + <li>Thread Group</li> + <ul> + <li>Once Only Controller</li> + <ul> + <li>Login Request (an <a href="../usermanual/component_reference.html#HTTP_Request">HTTP Request</a>)</li> + </ul> + <li>Load Search Page (HTTP Sampler)</li> + <li>Interleave Controller</li> + <ul> + <li>Search "A" (HTTP Sampler)</li> + <li>Search "B" (HTTP Sampler)</li> + <li>HTTP default request (Configuration Element)</li> + </ul> + <li>HTTP default request (Configuration Element)</li> + <li>Cookie Manager (Configuration Element)</li> + </ul> + </ul> </ul> - - </p> -<p> -The first thing about this test is that the login request will be executed only + +<p>The first thing about this test is that the login request will be executed only the first time through. Subsequent iterations will skip it. This is due to the -effects of the -<a href="../usermanual/component_reference.html#Once_Only_Controller">Once Only Controller</a> -. -</p> -<p> -After the login, the next Sampler loads the search page (imagine a +effects of the <a href="../usermanual/component_reference.html#Once_Only_Controller">Once Only Controller</a>.</p> + +<p>After the login, the next Sampler loads the search page (imagine a web application where the user logs in, and then goes to a search page to do a search). This -is just a simple request, not filtered through any Logic Controller. -</p> -<p> -After loading the search page, we want to do a search. Actually, we want to do +is just a simple request, not filtered through any Logic Controller.</p> + +<p>After loading the search page, we want to do a search. Actually, we want to do two different searches. However, we want to re-load the search page itself between each search. We could do this by having 4 simple HTTP request elements (load search, -search "A", load search, search "B"). Instead, we use the -<a href="../usermanual/component_reference.html#Interleave_Controller">Interleave Controller</a> - which passes on one child request each time through the test. It keeps the +search "A", load search, search "B"). Instead, we use the <a href="../usermanual/component_reference.html#Interleave_Controller">Interleave Controller</a> which passes on one child request each time through the test. It keeps the ordering (ie - it doesn't pass one on at random, but "remembers" its place) of its child elements. Interleaving 2 child requests may be overkill, but there could easily have -been 8, or 20 child requests. -</p> -<p> -Note the -<a href="../usermanual/component_reference.html#HTTP_Request_Defaults">HTTP Request Defaults</a> - that +been 8, or 20 child requests.</p> + +<p>Note the <a href="../usermanual/component_reference.html#HTTP_Request_Defaults">HTTP Request Defaults</a> that belongs to the Interleave Controller. Imagine that "Search A" and "Search B" share the same PATH info (an HTTP request specification includes domain, port, method, protocol, path, and arguments, plus other optional items). This makes sense - both are search requests, @@ -556,419 +205,176 @@ path, and arguments, plus other optional Controller "passes on" requests from "Search A" or "Search B", it will fill in the blanks with values from the HTTP default request Configuration Element. So, we leave the PATH field blank for those requests, and put that information into the Configuration Element. In this -case, this is a minor benefit at best, but it demonstrates the feature. -</p> -<p> -The next element in the tree is another HTTP default request, this time added to the +case, this is a minor benefit at best, but it demonstrates the feature.</p> + +<p>The next element in the tree is another HTTP default request, this time added to the Thread Group itself. The Thread Group has a built-in Logic Controller, and thus, it uses this Configuration Element exactly as described above. It fills in the blanks of any Request that passes through. It is extremely useful in web testing to leave the DOMAIN field blank in all your HTTP Sampler elements, and instead, put that information into an HTTP default request element, added to the Thread Group. By doing so, you can test your application on a different server simply by changing one field in your Test Plan. -Otherwise, you'd have to edit each and every Sampler. -</p> -<p> -The last element is a -<a href="../usermanual/component_reference.html#HTTP_Cookie_Manager">HTTP Cookie Manager</a> -. A Cookie Manager should be added to all web tests - otherwise JMeter will +Otherwise, you'd have to edit each and every Sampler.</p> + +<p>The last element is a <a href="../usermanual/component_reference.html#HTTP_Cookie_Manager">HTTP Cookie Manager</a>. A Cookie Manager should be added to all web tests - otherwise JMeter will ignore cookies. By adding it at the Thread Group level, we ensure that all HTTP requests -will share the same cookies. -</p> -<p> -Logic Controllers can be combined to achieve various results. See the list of -<a href="component_reference.html#logic_controllers"> -built-in -Logic Controllers -</a> -. -</p> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="test_fragments"><strong>4.2.3 Test Fragments</strong></a> -<a class="sectionlink" href="#test_fragments" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -The Test Fragment element is a special type of -<a href="#controllers"> -controller -</a> - that +will share the same cookies.</p> + +<p>Logic Controllers can be combined to achieve various results. See the list of <a href="component_reference.html#logic_controllers">built-in +Logic Controllers</a>.</p> +</div> + +<div class="subsection"><h2>4.2.3 Test Fragments<a class="sectionlink" href="#test_fragments" title="Link to here">¶</a></h2> +<p>The Test Fragment element is a special type of <a href="#controllers">controller</a> that exists on the Test Plan tree at the same level as the Thread Group element. It is distinguished from a Thread Group in that it is not executed unless it is -referenced by either a -<a href="../usermanual/component_reference.html#Module_Controller">Module Controller</a> - or an -<a href="../usermanual/component_reference.html#Include_Controller">Include_Controller</a> -. - +referenced by either a <a href="../usermanual/component_reference.html#Module_Controller">Module Controller</a> or an <a href="../usermanual/component_reference.html#Include_Controller">Include_Controller</a>. </p> -<p> -This element is purely for code re-use within Test Plans and was introduced in Version 2.5 -</p> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="listeners"><strong>4.3 Listeners</strong></a> -<a class="sectionlink" href="#listeners" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -Listeners provide access to the information JMeter gathers about the test cases while -JMeter runs. The -<a href="../usermanual/component_reference.html#Graph_Results">Graph Results</a> - listener plots the response times on a graph. +<p>This element is purely for code re-use within Test Plans and was introduced in Version 2.5</p> +</div> + +<div class="subsection"><h2>4.3 Listeners<a class="sectionlink" href="#listeners" title="Link to here">¶</a></h2> +<p>Listeners provide access to the information JMeter gathers about the test cases while +JMeter runs. The <a href="../usermanual/component_reference.html#Graph_Results">Graph Results</a> listener plots the response times on a graph. The "View Results Tree" Listener shows details of sampler requests and responses, and can display basic HTML and XML representations of the response. Other listeners provide summary or aggregation information. - </p> -<p> +<p> Additionally, listeners can direct the data to a file for later use. Every listener in JMeter provides a field to indicate the file to store data to. There is also a Configuration button which can be used to choose which fields to save, and whether to use CSV or XML format. - -<b> -Note that all Listeners save the same data; the only difference is in the way the data is presented on the screen. -</b> - - +<b>Note that all Listeners save the same data; the only difference is in the way the data is presented on the screen.</b> </p> -<p> +<p> Listeners can be added anywhere in the test, including directly under the test plan. They will collect data only from elements at or below their level. - </p> -<p> -There are several -<a href="component_reference.html#listeners"> -listeners -</a> - -that come with JMeter. -</p> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="timers"><strong>4.4 Timers</strong></a> -<a class="sectionlink" href="#timers" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -By default, a JMeter thread sends requests without pausing between each request. + +<p>There are several <a href="component_reference.html#listeners">listeners</a> +that come with JMeter.</p> +</div> + +<div class="subsection"><h2>4.4 Timers<a class="sectionlink" href="#timers" title="Link to here">¶</a></h2> + +<p>By default, a JMeter thread sends requests without pausing between each request. We recommend that you specify a delay by adding one of the available timers to your Thread Group. If you do not add a delay, JMeter could overwhelm your server by -making too many requests in a very short amount of time. -</p> -<p> -The timer will cause JMeter to delay a certain amount of time -<b> -before -</b> - each -sampler which is in its -<a href="#scoping_rules"> -scope -</a> -. -</p> -<p> +making too many requests in a very short amount of time.</p> + +<p>The timer will cause JMeter to delay a certain amount of time <b>before</b> each +sampler which is in its <a href="#scoping_rules">scope</a>.</p> +<p> If you choose to add more than one timer to a Thread Group, JMeter takes the sum of the timers and pauses for that amount of time before executing the samplers to which the timers apply. Timers can be added as children of samplers or controllers in order to restrict the samplers to which they are applied. - </p> <p> +To provide a pause at a single place in a test plan, one can use the <a href="../usermanual/component_reference.html#Test_Action">Test Action</a> Sampler. +</p> +</div> -To provide a pause at a single place in a test plan, one can use the -<a href="../usermanual/component_reference.html#Test_Action">Test Action</a> - Sampler. - -</p> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="assertions"><strong>4.5 Assertions</strong></a> -<a class="sectionlink" href="#assertions" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -Assertions allow you to assert facts about responses received from the +<div class="subsection"><h2>4.5 Assertions<a class="sectionlink" href="#assertions" title="Link to here">¶</a></h2> + +<p>Assertions allow you to assert facts about responses received from the server being tested. Using an assertion, you can essentially "test" that your -application is returning the results you expect it to. -</p> -<p> -For instance, you can assert that the response to a query will contain some +application is returning the results you expect it to. </p> + +<p>For instance, you can assert that the response to a query will contain some particular text. The text you specify can be a Perl-style regular expression, and you can indicate that the response is to contain the text, or that it should match -the whole response. -</p> -<p> -You can add an assertion to any Sampler. For example, you can +the whole response.</p> + +<p>You can add an assertion to any Sampler. For example, you can add an assertion to a HTTP Request that checks for the text, "</HTML>". JMeter will then check that the text is present in the HTTP response. If JMeter cannot find the -text, then it will mark this as a failed request. -</p> -<p> +text, then it will mark this as a failed request.</p> -Note that assertions apply to all samplers which are in its -<a href="#scoping_rules"> -scope -</a> -. +<p> +Note that assertions apply to all samplers which are in its <a href="#scoping_rules">scope</a>. To restrict the assertion to a single sampler, add the assertion as a child of the sampler. - </p> -<p> -To view the assertion results, add an Assertion Listener to the Thread Group. + +<p>To view the assertion results, add an Assertion Listener to the Thread Group. Failed Assertions will also show up in the Tree View and Table Listeners, and will count towards the error %age for example in the Aggregate and Summary reports. - -</p> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="config_elements"><strong>4.6 Configuration Elements</strong></a> -<a class="sectionlink" href="#config_elements" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -A configuration element works closely with a Sampler. Although it does not send requests -(except for -<a href="../usermanual/component_reference.html#HTTP(S)_Test_Script_Recorder">HTTP(S) Test Script Recorder</a> -), it can add to or modify requests. </p> -<p> -A configuration element is accessible from only inside the tree branch where you place the element. +</div> + +<div class="subsection"><h2>4.6 Configuration Elements<a class="sectionlink" href="#config_elements" title="Link to here">¶</a></h2> +<p>A configuration element works closely with a Sampler. Although it does not send requests +(except for <a href="../usermanual/component_reference.html#HTTP(S)_Test_Script_Recorder">HTTP(S) Test Script Recorder</a>), it can add to or modify requests.</p> + +<p>A configuration element is accessible from only inside the tree branch where you place the element. For example, if you place an HTTP Cookie Manager inside a Simple Logic Controller, the Cookie Manager will only be accessible to HTTP Request Controllers you place inside the Simple Logic Controller (see figure 1). -The Cookie Manager is accessible to the HTTP requests "Web Page 1" and "Web Page 2", but not "Web Page 3". -</p> -<p> -Also, a configuration element inside a tree branch has higher precedence than the same element in a "parent" +The Cookie Manager is accessible to the HTTP requests "Web Page 1" and "Web Page 2", but not "Web Page 3". </p> +<p>Also, a configuration element inside a tree branch has higher precedence than the same element in a "parent" branch. For example, we defined two HTTP Request Defaults elements, "Web Defaults 1" and "Web Defaults 2". Since we placed "Web Defaults 1" inside a Loop Controller, only "Web Page 2" can access it. The other HTTP -requests will use "Web Defaults 2", since we placed it in the Thread Group (the "parent" of all other branches). -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/http-config/http-config-example.png"/><br> -<font size="-1">Figure 1 - - Test Plan Showing Accessability of Configuration Elements -</font></td></tr></table></p> -<p> -<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2"> -<tr><td> -The -<a href="../usermanual/component_reference.html#User_Defined_Variables">User Defined Variables</a> - Configuration element is different. +requests will use "Web Defaults 2", since we placed it in the Thread Group (the "parent" of all other branches).</p> + +<figure><a href="../images/screenshots/http-config/http-config-example.png"><img src="../images/screenshots/http-config/http-config-example.png" width="" height="" alt="Figure 1 - + Test Plan Showing Accessability of Configuration Elements"></a><figcaption>Figure 1 - + Test Plan Showing Accessability of Configuration Elements</figcaption></figure> + +<div class="clear"></div><div class="note"> +The <a href="../usermanual/component_reference.html#User_Defined_Variables">User Defined Variables</a> Configuration element is different. It is processed at the start of a test, no matter where it is placed. For simplicity, it is suggested that the element is placed only at the start of a Thread Group. +</div><div class="clear"></div> +</div> -</td></tr> -</table> -</p> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="preprocessors"><strong>4.7 Pre-Processor Elements</strong></a> -<a class="sectionlink" href="#preprocessors" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -A Pre-Processor executes some action prior to a Sampler Request being made. +<div class="subsection"><h2>4.7 Pre-Processor Elements<a class="sectionlink" href="#preprocessors" title="Link to here">¶</a></h2> +<p>A Pre-Processor executes some action prior to a Sampler Request being made. If a Pre-Processor is attached to a Sampler element, then it will execute just prior to that sampler element running. A Pre-Processor is most often used to modify the settings of a Sample Request just before it runs, or to update variables that aren't extracted from response text. -See the -<a href="test_plan.html#scoping_rules"> -<b> -scoping rules -</b> -</a> - for more details on when Pre-Processors are executed. -</p> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="postprocessors"><strong>4.8 Post-Processor Elements</strong></a> -<a class="sectionlink" href="#postprocessors" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -A Post-Processor executes some action after a Sampler Request has been made. +See the <a href="test_plan.html#scoping_rules"><b>scoping rules</b></a> for more details on when Pre-Processors are executed.</p> +</div> + +<div class="subsection"><h2>4.8 Post-Processor Elements<a class="sectionlink" href="#postprocessors" title="Link to here">¶</a></h2> +<p>A Post-Processor executes some action after a Sampler Request has been made. If a Post-Processor is attached to a Sampler element, then it will execute just after that sampler element runs. A Post-Processor is most often used to process the response data, often to extract values from it. -See the -<a href="test_plan.html#scoping_rules"> -<b> -scoping rules -</b> -</a> - for more details on when Post-Processors are executed. -</p> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="executionorder"><strong>4.9 Execution order</strong></a> -<a class="sectionlink" href="#executionorder" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<ol start="0"> - - -<li> -Configuration elements -</li> - - -<li> -Pre-Processors -</li> - - -<li> -Timers -</li> - - -<li> -Sampler -</li> - - -<li> -Post-Processors (unless SampleResult is null) -</li> - - -<li> -Assertions (unless SampleResult is null) -</li> - - -<li> -Listeners (unless SampleResult is null) -</li> - +See the <a href="test_plan.html#scoping_rules"><b>scoping rules</b></a> for more details on when Post-Processors are executed.</p> +</div> +<div class="subsection"><h2>4.9 Execution order<a class="sectionlink" href="#executionorder" title="Link to here">¶</a></h2> +<ol start="0"> +<li>Configuration elements</li> +<li>Pre-Processors</li> +<li>Timers</li> +<li>Sampler</li> +<li>Post-Processors (unless SampleResult is null)</li> +<li>Assertions (unless SampleResult is null)</li> +<li>Listeners (unless SampleResult is null)</li> </ol> -<p> -<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2"> -<tr><td> + +<div class="clear"></div><div class="note"> Please note that Timers, Assertions, Pre- and Post-Processors are only processed if there is a sampler to which they apply. Logic Controllers and Samplers are processed in the order in which they appear in the tree. Other test elements are processed according to the scope in which they are found, and the type of test element. [Within a type, elements are processed in the order in which they appear in the tree]. - -</td></tr> -</table> -</p> +</div><div class="clear"></div> <p> - For example, in the following test plan: - <ul> - - -<li> -Controller -</li> - - +<li>Controller</li> <ul> - - -<li> -Post-Processor 1 -</li> - - -<li> -Sampler 1 -</li> - - -<li> -Sampler 2 -</li> - - -<li> -Timer 1 -</li> - - -<li> -Assertion 1 -</li> - - -<li> -Pre-Processor 1 -</li> - - -<li> -Timer 2 -</li> - - -<li> -Post-Processor 2 -</li> - - +<li>Post-Processor 1</li> +<li>Sampler 1</li> +<li>Sampler 2</li> +<li>Timer 1</li> +<li>Assertion 1</li> +<li>Pre-Processor 1</li> +<li>Timer 2</li> +<li>Post-Processor 2</li> </ul> - - </ul> - The order of execution would be: - <pre> - Pre-Processor 1 Timer 1 Timer 2 @@ -984,197 +390,81 @@ Sampler 2 Post-Processor 1 Post-Processor 2 Assertion 1 - </pre> - - </p> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="scoping_rules"><strong>4.10 Scoping Rules</strong></a> -<a class="sectionlink" href="#scoping_rules" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> +</div> -The JMeter test tree contains elements that are both hierarchical and ordered. Some elements in the test trees are strictly hierarchical (Listeners, Config Elements, Post-Procesors, Pre-Processors, Assertions, Timers), and some are primarily ordered (controllers, samplers). When you create your test plan, you will create an ordered list of sample request (via Samplers) that represent a set of steps to be executed. These requests are often organized within controllers that are also ordered. Given the following test tree: -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/scoping1.png"/><br> -<font size="-1">Example test tree -</font></td></tr></table></p> +<div class="subsection"><h2>4.10 Scoping Rules<a class="sectionlink" href="#scoping_rules" title="Link to here">¶</a></h2> <p> -The order of requests will be, One, Two, Three, Four. -</p> -<p> -Some controllers affect the order of their subelements, and you can read about these specific controllers in -<a href="component_reference.html"> -the component reference -</a> -. -</p> -<p> -Other elements are hierarchical. An Assertion, for instance, is hierarchical in the test tree. +The JMeter test tree contains elements that are both hierarchical and ordered. Some elements in the test trees are strictly hierarchical (Listeners, Config Elements, Post-Procesors, Pre-Processors, Assertions, Timers), and some are primarily ordered (controllers, samplers). When you create your test plan, you will create an ordered list of sample request (via Samplers) that represent a set of steps to be executed. These requests are often organized within controllers that are also ordered. Given the following test tree:</p> +<figure><a href="../images/screenshots/scoping1.png"><img src="../images/screenshots/scoping1.png" width="" height="" alt="Example test tree"></a><figcaption>Example test tree</figcaption></figure> +<p>The order of requests will be, One, Two, Three, Four.</p> +<p>Some controllers affect the order of their subelements, and you can read about these specific controllers in <a href="component_reference.html">the component reference</a>.</p> +<p>Other elements are hierarchical. An Assertion, for instance, is hierarchical in the test tree. If its parent is a request, then it is applied to that request. If its parent is a Controller, then it affects all requests that are descendants of -that Controller. In the following test tree: -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/scoping2.png"/><br> -<font size="-1">Hierarchy example -</font></td></tr></table></p> -<p> -Assertion #1 is applied only to Request One, while Assertion #2 is applied to Requests Two and Three. -</p> -<p> -Another example, this time using Timers: -</p> -<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/scoping3.png"/><br> -<font size="-1">complex example -</font></td></tr></table></p> -<p> -In this example, the requests are named to reflect the order in which they will be executed. Timer #1 will apply to Requests Two, Three, and Four (notice how order is irrelevant for hierarchical elements). Assertion #1 will apply only to Request Three. Timer #2 will affect all the requests. -</p> -<p> -Hopefully these examples make it clear how configuration (hierarchical) elements are applied. If you imagine each Request being passed up the tree branches, to its parent, then to its parent's parent, etc, and each time collecting all the configuration elements of that parent, then you will see how it works. -</p> +that Controller. In the following test tree:</p> +<figure><a href="../images/screenshots/scoping2.png"><img src="../images/screenshots/scoping2.png" width="" height="" alt="Hierarchy example"></a><figcaption>Hierarchy example</figcaption></figure> +<p>Assertion #1 is applied only to Request One, while Assertion #2 is applied to Requests Two and Three.</p> +<p>Another example, this time using Timers:</p> +<figure><a href="../images/screenshots/scoping3.png"><img src="../images/screenshots/scoping3.png" width="" height="" alt="complex example"></a><figcaption>complex example</figcaption></figure> +<p>In this example, the requests are named to reflect the order in which they will be executed. Timer #1 will apply to Requests Two, Three, and Four (notice how order is irrelevant for hierarchical elements). Assertion #1 will apply only to Request Three. Timer #2 will affect all the requests.</p> +<p>Hopefully these examples make it clear how configuration (hierarchical) elements are applied. If you imagine each Request being passed up the tree branches, to its parent, then to its parent's parent, etc, and each time collecting all the configuration elements of that parent, then you will see how it works. </p> <b> - The Configuration elements Header Manager, Cookie Manager and Authorization manager are treated differently from the Configuration Default elements. The settings from the Configuration Default elements are merged into a set of values that the Sampler has access to. However, the settings from the Managers are not merged. If more than one Manager is in the scope of a Sampler, -only one Manager is used, but there is currently no way to specify -<b> -which +only one Manager is used, but there is currently no way to specify <b>which</b> is used. </b> - is used. +</div> -</b> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="properties"><strong>4.11 Properties and Variables</strong></a> -<a class="sectionlink" href="#properties" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> -JMeter -<b> -properties -</b> - are defined in jmeter.properties (see -<a href="get-started.html#configuring_jmeter"> -Gettting Started - Configuring JMeter -</a> - for more details). +<div class="subsection"><h2>4.11 Properties and Variables<a class="sectionlink" href="#properties" title="Link to here">¶</a></h2> +<p> +JMeter <b>properties</b> are defined in jmeter.properties (see <a href="get-started.html#configuring_jmeter">Gettting Started - Configuring JMeter</a> for more details). <br> - - Properties are global to jmeter, and are mostly used to define some of the defaults JMeter uses. For example the property remote_hosts defines the servers that JMeter will try to run remotely. Properties can be referenced in test plans -- see -<a href="functions.html#__property"> -Functions - read a property -</a> - - +- see <a href="functions.html#__property">Functions - read a property</a> - but cannot be used for thread-specific values. - </p> <p> - -JMeter -<b> -variables -</b> - are local to each thread. The values may be the same for each thread, or they may be different. - +JMeter <b>variables</b> are local to each thread. The values may be the same for each thread, or they may be different. <br> - - If a variable is updated by a thread, only the thread copy of the variable is changed. -For example the -<a href="../usermanual/component_reference.html#Regular_Expression_Extractor">Regular Expression Extractor</a> - Post-Processor +For example the <a href="../usermanual/component_reference.html#Regular_Expression_Extractor">Regular Expression Extractor</a> Post-Processor will set its variables according to the sample that its thread has read, and these can be used later by the same thread. -For details of how to reference variables and functions, see -<a href="functions.html"> -Functions and Variables -</a> - - +For details of how to reference variables and functions, see <a href="functions.html">Functions and Variables</a> </p> <p> - -Note that the values defined by the -<a href="../usermanual/component_reference.html#Test_Plan">Test Plan</a> - and the -<a href="../usermanual/component_reference.html#User_Defined_Variables">User Defined Variables</a> - configuration element +Note that the values defined by the <a href="../usermanual/component_reference.html#Test_Plan">Test Plan</a> and the <a href="../usermanual/component_reference.html#User_Defined_Variables">User Defined Variables</a> configuration element are made available to the whole test plan at startup. If the same variable is defined by multiple UDV elements, then the last one takes effect. Once a thread has started, the initial set of variables is copied to each thread. Other elements such as the - -<a href="../usermanual/component_reference.html#User_Parameters">User Parameters</a> - Pre-Processor or -<a href="../usermanual/component_reference.html#Regular_Expression_Extractor">Regular Expression Extractor</a> - Post-Processor +<a href="../usermanual/component_reference.html#User_Parameters">User Parameters</a> Pre-Processor or <a href="../usermanual/component_reference.html#Regular_Expression_Extractor">Regular Expression Extractor</a> Post-Processor may be used to redefine the same variables (or create new ones). These redefinitions only apply to the current thread. - </p> <p> - -The -<a href="functions.html#__setProperty"> -setProperty -</a> - function can be used to define a JMeter property. +The <a href="functions.html#__setProperty">setProperty</a> function can be used to define a JMeter property. These are global to the test plan, so can be used to pass information between threads - should that be needed. - </p> -<p> -<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2"> -<tr><td>Both variables and properties are case-sensitive. -</td></tr> -</table> -</p> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr><td bgcolor="#828DA6"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="using_variables"><strong>4.12 Using Variables to parameterise tests</strong></a> -<a class="sectionlink" href="#using_variables" title="Link to here">¶</a></font> -</td></tr> -<tr><td> -<blockquote> -<p> +<div class="clear"></div><div class="note">Both variables and properties are case-sensitive.</div><div class="clear"></div> +</div> +<div class="subsection"><h2>4.12 Using Variables to parameterise tests<a class="sectionlink" href="#using_variables" title="Link to here">¶</a></h2> +<p> Variables don't have to vary - they can be defined once, and if left alone, will not change value. So you can use them as short-hand for expressions that appear frequently in a test plan. Or for items which are constant during a run, but which may vary between runs. For example, the name of a host, or the number of threads in a thread group. - </p> <p> - When deciding how to structure a Test Plan, make a note of which items are constant for the run, but which may change between runs. Decide on some variable names for these - @@ -1183,120 +473,37 @@ to distinguish them from variables that Also consider which items need to be local to a thread - for example counters or values extracted with the Regular Expression Post-Processor. You may wish to use a different naming convention for these. - </p> <p> - For example, you might define the following on the Test Plan: - <pre> - HOST www.example.com THREADS 10 LOOPS 20 - </pre> - You can refer to these in the test plan as ${HOST} ${THREADS} etc. If you later want to change the host, just change the value of the HOST variable. This works fine for small numbers of tests, but becomes tedious when testing lots of different combinations. One solution is to use a property to define the value of the variables, for example: - <pre> - HOST ${__P(host,www.example.com)} THREADS ${__P(threads,10)} LOOPS ${__P(loops,20)} - </pre> - You can then change some or all of the values on the command-line as follows: - <pre> - jmeter ... -Jhost=www3.example.org -Jloops=13 - </pre> - - </p> -</blockquote> -</td></tr> -<tr><td><br></td></tr> -</table> -</blockquote> -</p> -</td></tr> -<tr><td><br></td></tr> -</table> -<br> -<table> -<tr> -<td bgcolor="#525D76"> -<div align="right"><a href="index.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Index</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-web-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div> -</td> -<td bgcolor="#525D76"> -<div align="right"><a href="build-test-plan.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div> -</td> -</tr> -</table> -</td> -</tr> -<tr><td colspan="2"> -<hr noshade size="1"/> -</td></tr> -<tr><td colspan="2"> -<div align="center"><font color="#525D76" size="-1"><em> -Copyright © 1999-2015, Apache Software Foundation -</em></font></div> -</td></tr> -<tr><td colspan="2"> -<div align="center"><font color="#525D76" size="-1"> -Apache, Apache JMeter, JMeter, the Apache feather, and the Apache JMeter logo are -trademarks of the Apache Software Foundation. -</font> </div> -</td></tr> -</table> -</body> -</html> -<!-- end the processing --> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +</div><ul class="pagelinks"><li><a href="build-test-plan.html">< Prev</a></li><li><a href="../index.html">Index</a></li><li><a href="build-web-test-plan.html">Next ></a></li></ul></div><div class="footer"><div class="copyright"> + Copyright © + 1999 – + 2015 + , Apache Software Foundation + </div><div class="trademarks">Apache, Apache JMeter, JMeter, the Apache + feather, and the Apache JMeter logo are + trademarks of the + Apache Software Foundation. + </div></div></body></html> \ No newline at end of file
