Author: milamber
Date: Wed Mar 18 08:07:02 2015
New Revision: 1667464
URL: http://svn.apache.org/r1667464
Log:
Backport the commit r1667461 (Fix some issue with numbering since the realtime
results section have been added.) and update the website docs
Modified:
jmeter/branches/docs-2.13/docs/usermanual/best-practices.html
jmeter/branches/docs-2.13/docs/usermanual/boss.html
jmeter/branches/docs-2.13/docs/usermanual/component_reference.html
jmeter/branches/docs-2.13/docs/usermanual/functions.html
jmeter/branches/docs-2.13/docs/usermanual/glossary.html
jmeter/branches/docs-2.13/docs/usermanual/hints_and_tips.html
jmeter/branches/docs-2.13/docs/usermanual/index.html
jmeter/branches/docs-2.13/docs/usermanual/realtime-results.html
jmeter/branches/docs-2.13/docs/usermanual/regular_expressions.html
jmeter/branches/docs-2.13/docs/usermanual/remote-test.html
jmeter/branches/docs-2.13/xdocs/usermanual/best-practices.xml
jmeter/branches/docs-2.13/xdocs/usermanual/boss.xml
jmeter/branches/docs-2.13/xdocs/usermanual/component_reference.xml
jmeter/branches/docs-2.13/xdocs/usermanual/functions.xml
jmeter/branches/docs-2.13/xdocs/usermanual/glossary.xml
jmeter/branches/docs-2.13/xdocs/usermanual/hints_and_tips.xml
jmeter/branches/docs-2.13/xdocs/usermanual/index.xml
jmeter/branches/docs-2.13/xdocs/usermanual/realtime-results.xml
jmeter/branches/docs-2.13/xdocs/usermanual/regular_expressions.xml
jmeter/branches/docs-2.13/xdocs/usermanual/remote-test.xml
Modified: jmeter/branches/docs-2.13/docs/usermanual/best-practices.html
URL:
http://svn.apache.org/viewvc/jmeter/branches/docs-2.13/docs/usermanual/best-practices.html?rev=1667464&r1=1667463&r2=1667464&view=diff
==============================================================================
--- jmeter/branches/docs-2.13/docs/usermanual/best-practices.html (original)
+++ jmeter/branches/docs-2.13/docs/usermanual/best-practices.html Wed Mar 18
08:07:02 2015
@@ -28,13 +28,13 @@
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
onClick="return true"><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 onClick="return true"><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 onClick="return true"><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 onClick="return true"><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="../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></li></ul><ul class="menu"><li onClick="return true"><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 onClick="return
true"><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="pa
gelinks"><li><a href="remote-test.html">< Prev</a></li><li><a
href="../index.html">Index</a></li><li><a href="boss.html">Next
></a></li></ul><div class="section"><h1 id="best_practices">16. Best
Practices<a class="sectionlink" href="#best_practices" title="Link to
here">¶</a></h1>
-</div><div class="section"><h1 id="use_latest_version">16.1 Always use latest
version of JMeter<a class="sectionlink" href="#use_latest_version" title="Link
to here">¶</a></h1>
+ </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
onClick="return true"><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 onClick="return true"><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 onClick="return true"><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 onClick="return true"><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="../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></li></ul><ul class="menu"><li onClick="return true"><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 onClick="return
true"><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="pa
gelinks"><li><a href="realtime-results.html">< Prev</a></li><li><a
href="../index.html">Index</a></li><li><a href="boss.html">Next
></a></li></ul><div class="section"><h1 id="best_practices">17. Best
Practices<a class="sectionlink" href="#best_practices" title="Link to
here">¶</a></h1>
+</div><div class="section"><h1 id="use_latest_version">17.1 Always use latest
version of JMeter<a class="sectionlink" href="#use_latest_version" title="Link
to here">¶</a></h1>
<p>The performance of JMeter is being constantly improved, so users are highly
encouraged to use the most up to date version. <br>
Ensure you always read <a href="../changes.html">changes list</a> to be aware
of new improvements and components.
You should absolutely avoid using versions that are older than 3 versions
before the last one.
</p>
-</div><div class="section"><h1 id="sizing_threads">16.2 Use the correct Number
of Threads<a class="sectionlink" href="#sizing_threads" title="Link to
here">¶</a></h1>
+</div><div class="section"><h1 id="sizing_threads">17.2 Use the correct Number
of Threads<a class="sectionlink" href="#sizing_threads" title="Link to
here">¶</a></h1>
<p>Your hardware capabilities as well as the Test Plan design will both impact
the number of threads you can effectively
run with JMeter. The number will also depend on how fast your server is (a
faster server
makes JMeter work harder since it returns a response quicker). As with any
Load Testing tool, if you don't correctly size
@@ -50,13 +50,13 @@ JMeter versions since 2.8 have an option
starts sampling, i.e. after any thread group delay and the ramp-up time for
the thread itself.
This allows for a very large total number of threads, provided that not too
many are active concurrently.
</p>
-</div><div class="section"><h1 id="put_cookie_manager">16.3 Where to Put the
Cookie Manager<a class="sectionlink" href="#put_cookie_manager" title="Link to
here">¶</a></h1>
+</div><div class="section"><h1 id="put_cookie_manager">17.3 Where to Put the
Cookie Manager<a class="sectionlink" href="#put_cookie_manager" title="Link to
here">¶</a></h1>
<p>See <a href="build-web-test-plan.html#adding_cookie_support">Building a Web
Test</a>
for information.</p>
-</div><div class="section"><h1 id="put_auth_manager">16.4 Where to Put the
Authorization Manager<a class="sectionlink" href="#put_auth_manager"
title="Link to here">¶</a></h1>
+</div><div class="section"><h1 id="put_auth_manager">17.4 Where to Put the
Authorization Manager<a class="sectionlink" href="#put_auth_manager"
title="Link to here">¶</a></h1>
<p>See <a href="build-adv-web-test-plan.html#header_manager">Building an
Advanced
Web Test</a> for information.</p>
-</div><div class="section"><h1 id="proxy_server">16.5 Using the HTTP(S) Test
Script Recorder<a class="sectionlink" href="#proxy_server" title="Link to
here">¶</a></h1>
+</div><div class="section"><h1 id="proxy_server">17.5 Using the HTTP(S) Test
Script Recorder<a class="sectionlink" href="#proxy_server" title="Link to
here">¶</a></h1>
<p>Refer to <a
href="../usermanual/component_reference.html#HTTP(S)_Test_Script_Recorder">HTTP(S)
Test Script Recorder</a> for details on setting up the
recorder. The most important thing to do is filter out all requests you aren't
interested in. For instance, there's no point in recording image requests
(JMeter can
@@ -101,7 +101,7 @@ JMeter Proxy server certificate.
</p>
-</div><div class="section"><h1 id="user_variables">16.6 User variables<a
class="sectionlink" href="#user_variables" title="Link to here">¶</a></h1>
+</div><div class="section"><h1 id="user_variables">17.6 User variables<a
class="sectionlink" href="#user_variables" title="Link to here">¶</a></h1>
<p>
Some test plans need to use different values for different users/threads.
For example, you might want to test a sequence that requires a unique login
for each user.
@@ -123,7 +123,7 @@ samplers
</ul>
<p>The CSV Data Set element will read a new line for each thread.
</p>
-</div><div class="section"><h1 id="lean_mean">16.7 Reducing resource
requirements<a class="sectionlink" href="#lean_mean" title="Link to
here">¶</a></h1>
+</div><div class="section"><h1 id="lean_mean">17.7 Reducing resource
requirements<a class="sectionlink" href="#lean_mean" title="Link to
here">¶</a></h1>
<p>
Some suggestions on reducing resource usage.
</p>
@@ -145,7 +145,7 @@ use the same sampler in a loop, and use
If your test needs large amounts of data - particularly if it needs to be
randomised - create the test data in a file
that can be read with CSV Dataset. This avoids wasting resources at run-time.
</p>
-</div><div class="section"><h1 id="beanshell_server">16.8 BeanShell server<a
class="sectionlink" href="#beanshell_server" title="Link to
here">¶</a></h1>
+</div><div class="section"><h1 id="beanshell_server">17.8 BeanShell server<a
class="sectionlink" href="#beanshell_server" title="Link to
here">¶</a></h1>
<p>
The BeanShell interpreter has a very useful feature - it can act as a server,
which is accessible by telnet or http.
@@ -233,8 +233,8 @@ For example:
<pre>
java -jar ../lib/bshclient.jar localhost 9000 throughput.bsh 70 5 100 60
</pre>
-</div><div class="section"><h1 id="bsh_scripting">16.9 BeanShell scripting<a
class="sectionlink" href="#bsh_scripting" title="Link to here">¶</a></h1>
-<div class="subsection"><h2>16.9.1 Overview<a class="sectionlink"
href="#bsh_overview" title="Link to here">¶</a></h2>
+</div><div class="section"><h1 id="bsh_scripting">17.9 BeanShell scripting<a
class="sectionlink" href="#bsh_scripting" title="Link to here">¶</a></h1>
+<div class="subsection"><h2>17.9.1 Overview<a class="sectionlink"
href="#bsh_overview" title="Link to here">¶</a></h2>
<p>
Each BeanShell test element has its own copy of the interpreter (for each
thread).
If the test element is repeatedly called, e.g. within a loop, then the
interpreter is retained
@@ -256,7 +256,7 @@ bsh% exit(); // or use EOF key (e.g. ^Z
</pre>
</p>
</div>
-<div class="subsection"><h2>16.9.2 Sharing Variables<a class="sectionlink"
href="#bsh_variables" title="Link to here">¶</a></h2>
+<div class="subsection"><h2>17.9.2 Sharing Variables<a class="sectionlink"
href="#bsh_variables" title="Link to here">¶</a></h2>
<p>
Variables can be defined in startup (initialisation) scripts.
These will be retained across invocations of the test element, unless the
reset option is used.\
@@ -291,7 +291,7 @@ Rather than creating the object in the t
defined by the JMeter property "beanshell.init.file". This is only processed
once.
</p>
</div>
-</div><div class="section"><h1 id="developing_scripts">16.10 Developing script
functions in BeanShell, Javascript or Jexl etc.<a class="sectionlink"
href="#developing_scripts" title="Link to here">¶</a></h1>
+</div><div class="section"><h1 id="developing_scripts">17.10 Developing script
functions in BeanShell, Javascript or Jexl etc.<a class="sectionlink"
href="#developing_scripts" title="Link to here">¶</a></h1>
<p>
It's quite hard to write and test scripts as functions.
However, JMeter has the JSR223, BSF (and BeanShell) samplers which can be used
instead.
@@ -310,7 +310,7 @@ The function call can then be coded as <
There is no need to escape any commas in the script,
because the function call is parsed before the variable's value is
interpolated.
</p>
-</div><div class="section"><h1 id="parameterising_tests">16.11 Parameterising
tests<a class="sectionlink" href="#parameterising_tests" title="Link to
here">¶</a></h1>
+</div><div class="section"><h1 id="parameterising_tests">17.11 Parameterising
tests<a class="sectionlink" href="#parameterising_tests" title="Link to
here">¶</a></h1>
<p>
Often it is useful to be able to re-run the same test with different settings.
For example, changing the number of threads or loops, or changing a hostname.
@@ -331,7 +331,7 @@ If there are a lot of properties that ne
then one way to achieve this is to use a set of property files.
The appropriate property file can be passed in to JMeter using the -q
command-line option.
</p>
-</div><div class="section"><h1 id="jsr223">16.12 JSR223 Elements<a
class="sectionlink" href="#jsr223" title="Link to here">¶</a></h1>
+</div><div class="section"><h1 id="jsr223">17.12 JSR223 Elements<a
class="sectionlink" href="#jsr223" title="Link to here">¶</a></h1>
<p>
For intensive load testing, the recommended scripting language is one whose
ScriptingEngine implements the Compilable interface.
Groovy scripting engine implements Compilable. However neither Beanshell nor
Javascript do so as of release date of JMeter 2.13, so it is
@@ -348,7 +348,7 @@ vars.get("varName")
<p>
You can also pass them as Parameters to the script and use them this way.
</p>
-</div><div class="section"><h1 id="sharing_variables">16.13 Sharing variables
between threads and thread groups<a class="sectionlink"
href="#sharing_variables" title="Link to here">¶</a></h1>
+</div><div class="section"><h1 id="sharing_variables">17.13 Sharing variables
between threads and thread groups<a class="sectionlink"
href="#sharing_variables" title="Link to here">¶</a></h1>
<p>
Variables are local to a thread; a variable set in one thread cannot be read
in another.
This is by design. For variables that can be determined before a test starts,
see
@@ -361,12 +361,12 @@ If the value is not known until the test
<li>Write your own Java classes</li>
</ul>
</p>
-</div><div class="section"><h1 id="properties">16.14 Managing properties<a
class="sectionlink" href="#properties" title="Link to here">¶</a></h1>
+</div><div class="section"><h1 id="properties">17.14 Managing properties<a
class="sectionlink" href="#properties" title="Link to here">¶</a></h1>
<p>When you need to modify jmeter properties, ensure you don't modify
jmeter.properties file, <b>instead copy the property from jmeter.properties and
modify its value in user.properties file</b>.<br>
Doing so will ease you migration to the next version of JMeter. <br>
Note that in the documentation jmeter.properties is frequently mentioned but
this should be understood as "Copy from jmeter.properties to user.properties
the property you want to modify and do so in the latter file".</p>
<div class="clear"></div><div class="note">user.properties file superseeds the
properties defined in jmeter.properties</div><div class="clear"></div>
-</div><ul class="pagelinks"><li><a href="remote-test.html"><
Prev</a></li><li><a href="../index.html">Index</a></li><li><a
href="boss.html">Next ></a></li></ul></div><div class="footer"><div
class="copyright">
+</div><ul class="pagelinks"><li><a href="realtime-results.html"><
Prev</a></li><li><a href="../index.html">Index</a></li><li><a
href="boss.html">Next ></a></li></ul></div><div class="footer"><div
class="copyright">
Copyright ©
1999 –
2015
Modified: jmeter/branches/docs-2.13/docs/usermanual/boss.html
URL:
http://svn.apache.org/viewvc/jmeter/branches/docs-2.13/docs/usermanual/boss.html?rev=1667464&r1=1667463&r2=1667464&view=diff
==============================================================================
--- jmeter/branches/docs-2.13/docs/usermanual/boss.html (original)
+++ jmeter/branches/docs-2.13/docs/usermanual/boss.html Wed Mar 18 08:07:02 2015
@@ -28,14 +28,14 @@
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
onClick="return true"><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 onClick="return true"><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 onClick="return true"><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 onClick="return true"><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="../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></li></ul><ul class="menu"><li onClick="return true"><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 onClick="return
true"><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="pa
gelinks"><li><a href="best-practices.html">< Prev</a></li><li><a
href="../index.html">Index</a></li><li><a href="component_reference.html">Next
></a></li></ul><div class="section"><h1 id="boss">17. Help! My boss wants me
to load test our application!<a class="sectionlink" href="#boss" title="Link to
here">¶</a></h1>
+ </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
onClick="return true"><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 onClick="return true"><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 onClick="return true"><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 onClick="return true"><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="../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></li></ul><ul class="menu"><li onClick="return true"><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 onClick="return
true"><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="pa
gelinks"><li><a href="best-practices.html">< Prev</a></li><li><a
href="../index.html">Index</a></li><li><a href="component_reference.html">Next
></a></li></ul><div class="section"><h1 id="boss">18. Help! My boss wants me
to load test our application!<a class="sectionlink" href="#boss" title="Link to
here">¶</a></h1>
<p>This is a fairly open-ended proposition. There are a number of questions to
be asked first, and additionally a number of resources that will be needed. You
will need some hardware to run the benchmarks/load-tests from. A number of
tools will prove useful. There are a number of products to consider. And
finally,
why is Java a good choice to implement a load-testing/Benchmarking product.
</p>
-<div class="subsection"><h2>17.1 Questions to ask<a class="sectionlink"
href="#questions" title="Link to here">¶</a></h2>
+<div class="subsection"><h2>18.1 Questions to ask<a class="sectionlink"
href="#questions" title="Link to here">¶</a></h2>
<p>What is our anticipated average number of users (normal load) ?
</p>
<p>What is our anticipated peak number of users ?
@@ -48,13 +48,13 @@ bearing in mind that this may very well
</p>
<p>What is the testing intended to achieve?</p>
</div>
-<div class="subsection"><h2>17.2 Resources<a class="sectionlink"
href="#resources" title="Link to here">¶</a></h2>
+<div class="subsection"><h2>18.2 Resources<a class="sectionlink"
href="#resources" title="Link to here">¶</a></h2>
<p>The following resources will prove very helpful. Bear in mind that if you
cannot locate these resources, <b>you</b> will become these resources. As you
already have your work cut out for you, it is worth knowing who the following
people are, so that you can ask them for help if you need it.
</p>
- <div class="subsection"><h2>17.2.1 Network<a class="sectionlink"
href="#network" title="Link to here">¶</a></h2>
+ <div class="subsection"><h2>18.2.1 Network<a class="sectionlink"
href="#network" title="Link to here">¶</a></h2>
<p>Who knows our network topology ? If you run into any firewall or
proxy issues, this will become very important. As well, a private
testing network (which will therefore have very low network latency)
@@ -64,7 +64,7 @@ people are, so that you can ask them for
hardware ?
</p>
</div>
- <div class="subsection"><h2>17.2.2 Application<a class="sectionlink"
href="#application" title="Link to here">¶</a></h2>
+ <div class="subsection"><h2>18.2.2 Application<a class="sectionlink"
href="#application" title="Link to here">¶</a></h2>
<p>Who knows how our application functions ? The normal sequence is
<ul>
<li>test (low-volume - can we benchmark our application?)</li>
@@ -80,7 +80,7 @@ people are, so that you can ask them for
during this process, so be prepared to defend your work.</p>
</div>
</div>
-<div class="subsection"><h2>17.3 What platform should I use to run the
benchmarks/load-tests ?<a class="sectionlink" href="#platform" title="Link to
here">¶</a></h2>
+<div class="subsection"><h2>18.3 What platform should I use to run the
benchmarks/load-tests ?<a class="sectionlink" href="#platform" title="Link to
here">¶</a></h2>
<p>This should be a widely-used piece of hardware, with a standard
(i.e. vanilla) software installation. Remember, if you publish your results,
the first thing your clients will do is hire a graduate student to verify them.
@@ -118,20 +118,20 @@ The batch log file can then be loaded in
use CSV output and import the data into a spreadsheet.</p>
<div class="clear"></div><div class="note">Remember GUI mode is for Script
creation and debugging, not for load testing</div><div class="clear"></div>
</div>
-<div class="subsection"><h2>17.4 Tools<a class="sectionlink" href="#tools"
title="Link to here">¶</a></h2>
+<div class="subsection"><h2>18.4 Tools<a class="sectionlink" href="#tools"
title="Link to here">¶</a></h2>
<p>The following tools will all prove useful. It is definitely worthwhile to
become familiar with them. This should include trying them out, and reading the
appropriate documentation (man-pages, info-files, application --help messages,
and any supplied documentation).
</p>
- <div class="subsection"><h2>17.4.1 ping<a class="sectionlink" href="#ping"
title="Link to here">¶</a></h2>
+ <div class="subsection"><h2>18.4.1 ping<a class="sectionlink" href="#ping"
title="Link to here">¶</a></h2>
<p>
This can be used to establish whether or not you can reach your
target site. Options can be specified so that 'ping' provides the
same type of route reporting as 'traceroute'.
</p>
</div>
- <div class="subsection"><h2>17.4.2 nslookup/dig<a class="sectionlink"
href="#dig" title="Link to here">¶</a></h2>
+ <div class="subsection"><h2>18.4.2 nslookup/dig<a class="sectionlink"
href="#dig" title="Link to here">¶</a></h2>
<p>
While the <u>user</u> will normally use a human-readable internet
address, <u>you</u> may wish to avoid the overhead of DNS lookups when
@@ -139,7 +139,7 @@ and any supplied documentation).
the unique address (dotted quad) of your target site.
</p>
</div>
- <div class="subsection"><h2>17.4.3 traceroute<a class="sectionlink"
href="#traceroute" title="Link to here">¶</a></h2>
+ <div class="subsection"><h2>18.4.3 traceroute<a class="sectionlink"
href="#traceroute" title="Link to here">¶</a></h2>
<p>
If you cannot "ping" your target site, this may be used to determine
the problem (possibly a firewall or a proxy). It can also be used
@@ -150,10 +150,10 @@ and any supplied documentation).
</p>
</div>
</div>
-<div class="subsection"><h2>17.5 How can I enhance JMeter ?<a
class="sectionlink" href="#plugins" title="Link to here">¶</a></h2>
+<div class="subsection"><h2>18.5 How can I enhance JMeter ?<a
class="sectionlink" href="#plugins" title="Link to here">¶</a></h2>
<p>There a lot of open-source and commercial plugins that can enhance JMeter,
let's mention here the main open-source ones:
</p>
- <div class="subsection"><h2>17.5.1 JMeter-Plugins<a class="sectionlink"
href="#jmeter-plugins" title="Link to here">¶</a></h2>
+ <div class="subsection"><h2>18.5.1 JMeter-Plugins<a class="sectionlink"
href="#jmeter-plugins" title="Link to here">¶</a></h2>
<p>This <a href="http://jmeter-plugins.org/" target="_blank">non official
project</a> is THE companion to core JMeter.<br>
It provides many useful extensions, among which:
<ul>
@@ -166,20 +166,20 @@ and any supplied documentation).
</ul>
</p>
</div>
- <div class="subsection"><h2>17.5.2 JMeter Plugin for Maven<a
class="sectionlink" href="#jmeter-maven-plugin" title="Link to
here">¶</a></h2>
+ <div class="subsection"><h2>18.5.2 JMeter Plugin for Maven<a
class="sectionlink" href="#jmeter-maven-plugin" title="Link to
here">¶</a></h2>
<p>This <a href="http://jmeter.lazerycode.com/" target="_blank">non
official plugin</a> allows you to run your automated JMeter tests through
Maven.</p>
</div>
- <div class="subsection"><h2>17.5.3 JMeter Performance Plugin<a
class="sectionlink" href="#jmeter-performance-plugin" title="Link to
here">¶</a></h2>
+ <div class="subsection"><h2>18.5.3 JMeter Performance Plugin<a
class="sectionlink" href="#jmeter-performance-plugin" title="Link to
here">¶</a></h2>
<p>This <a
href="https://wiki.jenkins-ci.org/display/JENKINS/Performance+Plugin"
target="_blank">non official plugin</a> allows you to capture reports from
JMeter and JUnit.<br>
Jenkins will generate graphic charts with the trend report of
performance and robustness.
It includes the feature of setting the final build status as good,
unstable or failed, based on the reported error percentage.
</p>
</div>
- <div class="subsection"><h2>17.5.4 JMeter plugin for AWS<a
class="sectionlink" href="#jmeter-ec2" title="Link to here">¶</a></h2>
+ <div class="subsection"><h2>18.5.4 JMeter plugin for AWS<a
class="sectionlink" href="#jmeter-ec2" title="Link to here">¶</a></h2>
<p>This <a href="https://github.com/oliverlloyd/jmeter-ec2"
target="_blank">non official plugin</a> automates running Apache JMeter on
Amazon EC2</p>
</div>
</div>
-<div class="subsection"><h2>17.6 Why Java ?<a class="sectionlink" href="#java"
title="Link to here">¶</a></h2>
+<div class="subsection"><h2>18.6 Why Java ?<a class="sectionlink" href="#java"
title="Link to here">¶</a></h2>
<p>Why not Perl or C ?
</p>
<p>Well, Perl might be a very good choice except that the Benchmark package
Modified: jmeter/branches/docs-2.13/docs/usermanual/component_reference.html
URL:
http://svn.apache.org/viewvc/jmeter/branches/docs-2.13/docs/usermanual/component_reference.html?rev=1667464&r1=1667463&r2=1667464&view=diff
==============================================================================
--- jmeter/branches/docs-2.13/docs/usermanual/component_reference.html
(original)
+++ jmeter/branches/docs-2.13/docs/usermanual/component_reference.html Wed Mar
18 08:07:02 2015
@@ -28,11 +28,11 @@
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
onClick="return true"><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 onClick="return true"><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 onClick="return true"><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 onClick="return true"><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="../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></li></ul><ul class="menu"><li onClick="return true"><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 onClick="return
true"><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="pa
gelinks"><li><a href="boss.html">< Prev</a></li><li><a
href="../index.html">Index</a></li><li><a href="functions.html">Next
></a></li></ul><ul class="section-index"><li><a href="#introduction">18.0
Introduction</a><ul></ul></li><li><a href="#samplers">18.1
Samplers</a><ul><li><a href="#FTP_Request">FTP Request</a></li><li><a
href="#HTTP_Request">HTTP Request</a></li><li><a href="#JDBC_Request">JDBC
Request</a></li><li><a href="#Java_Request">Java Request</a></li><li><a
href="#SOAP/XML-RPC_Request">SOAP/XML-RPC Request</a></li><li><a
href="#WebService(SOAP)_Request_(DEPRECATED)">WebService(SOAP) Request
(DEPRECATED)</a></li><li><a href="#LDAP_Request">LDAP Request</a></li><li><a
href="#LDAP_Extended_Request">LDAP Extended Request</a></li><li><a
href="#Access_Log_Sampler">Access Log Sampler</a></li><li><a
href="#BeanShell_Sampler">BeanShell Sampler</a></li><li><a
href="#BSF_Sampler">BSF Sampler</a></li><li><a href="#JSR223_Sampler">JSR223
Sampler</a></li><li><a href="#TCP_Sample
r">TCP Sampler</a></li><li><a href="#JMS_Publisher">JMS
Publisher</a></li><li><a href="#JMS_Subscriber">JMS Subscriber</a></li><li><a
href="#JMS_Point-to-Point">JMS Point-to-Point</a></li><li><a
href="#JUnit_Request">JUnit Request</a></li><li><a
href="#Mail_Reader_Sampler">Mail Reader Sampler</a></li><li><a
href="#Test_Action">Test Action</a></li><li><a href="#SMTP_Sampler">SMTP
Sampler</a></li><li><a href="#OS_Process_Sampler">OS Process
Sampler</a></li><li><a href="#MongoDB_Script">MongoDB
Script</a></li></ul></li><li><a href="#logic_controllers">18.2 Logic
Controllers</a><ul><li><a href="#Simple_Controller">Simple
Controller</a></li><li><a href="#Loop_Controller">Loop
Controller</a></li><li><a href="#Once_Only_Controller">Once Only
Controller</a></li><li><a href="#Interleave_Controller">Interleave
Controller</a></li><li><a href="#Random_Controller">Random
Controller</a></li><li><a href="#Random_Order_Controller">Random Order
Controller</a></li><li><a href="#Throughput_Controller"
>Throughput Controller</a></li><li><a href="#Runtime_Controller">Runtime
>Controller</a></li><li><a href="#If_Controller">If Controller</a></li><li><a
>href="#While_Controller">While Controller</a></li><li><a
>href="#Switch_Controller">Switch Controller</a></li><li><a
>href="#ForEach_Controller">ForEach Controller</a></li><li><a
>href="#Module_Controller">Module Controller</a></li><li><a
>href="#Include_Controller">Include Controller</a></li><li><a
>href="#Transaction_Controller">Transaction Controller</a></li><li><a
>href="#Recording_Controller">Recording Controller</a></li><li><a
>href="#Critical_Section_Controller">Critical Section
>Controller</a></li></ul></li><li><a href="#listeners">18.3
>Listeners</a><ul><li><a href="#Sample_Result_Save_Configuration">Sample
>Result Save Configuration</a></li><li><a href="#Graph_Results">Graph
>Results</a></li><li><a href="#Spline_Visualizer">Spline
>Visualizer</a></li><li><a href="#Assertion_Results">Assertion
>Results</a></li><li><a href="#View_Results_Tr
ee">View Results Tree</a></li><li><a href="#Aggregate_Report">Aggregate
Report</a></li><li><a href="#View_Results_in_Table">View Results in
Table</a></li><li><a href="#Simple_Data_Writer">Simple Data
Writer</a></li><li><a href="#Monitor_Results">Monitor Results</a></li><li><a
href="#Distribution_Graph_(alpha)">Distribution Graph (alpha)</a></li><li><a
href="#Aggregate_Graph">Aggregate Graph</a></li><li><a
href="#Response_Time_Graph">Response Time Graph</a></li><li><a
href="#Mailer_Visualizer">Mailer Visualizer</a></li><li><a
href="#BeanShell_Listener">BeanShell Listener</a></li><li><a
href="#Summary_Report">Summary Report</a></li><li><a
href="#Save_Responses_to_a_file">Save Responses to a file</a></li><li><a
href="#BSF_Listener">BSF Listener</a></li><li><a href="#JSR223_Listener">JSR223
Listener</a></li><li><a href="#Generate_Summary_Results">Generate Summary
Results</a></li><li><a href="#Comparison_Assertion_Visualizer">Comparison
Assertion Visualizer</a></li><li><a href="#Backend_
Listener">Backend Listener</a></li></ul></li><li><a
href="#config_elements">18.4 Configuration Elements</a><ul><li><a
href="#CSV_Data_Set_Config">CSV Data Set Config</a></li><li><a
href="#FTP_Request_Defaults">FTP Request Defaults</a></li><li><a
href="#DNS_Cache_Manager">DNS Cache Manager</a></li><li><a
href="#HTTP_Authorization_Manager">HTTP Authorization Manager</a></li><li><a
href="#HTTP_Cache_Manager">HTTP Cache Manager</a></li><li><a
href="#HTTP_Cookie_Manager">HTTP Cookie Manager</a></li><li><a
href="#HTTP_Request_Defaults">HTTP Request Defaults</a></li><li><a
href="#HTTP_Header_Manager">HTTP Header Manager</a></li><li><a
href="#Java_Request_Defaults">Java Request Defaults</a></li><li><a
href="#JDBC_Connection_Configuration">JDBC Connection
Configuration</a></li><li><a href="#Keystore_Configuration">Keystore
Configuration</a></li><li><a href="#Login_Config_Element">Login Config
Element</a></li><li><a href="#LDAP_Request_Defaults">LDAP Request
Defaults</a></li><li><a href="#LDA
P_Extended_Request_Defaults">LDAP Extended Request Defaults</a></li><li><a
href="#TCP_Sampler_Config">TCP Sampler Config</a></li><li><a
href="#User_Defined_Variables">User Defined Variables</a></li><li><a
href="#Random_Variable">Random Variable</a></li><li><a
href="#Counter">Counter</a></li><li><a href="#Simple_Config_Element">Simple
Config Element</a></li><li><a href="#MongoDB_Source_Config">MongoDB Source
Config</a></li></ul></li><li><a href="#assertions">18.5
Assertions</a><ul><li><a href="#Response_Assertion">Response
Assertion</a></li><li><a href="#Duration_Assertion">Duration
Assertion</a></li><li><a href="#Size_Assertion">Size Assertion</a></li><li><a
href="#XML_Assertion">XML Assertion</a></li><li><a
href="#BeanShell_Assertion">BeanShell Assertion</a></li><li><a
href="#MD5Hex_Assertion">MD5Hex Assertion</a></li><li><a
href="#HTML_Assertion">HTML Assertion</a></li><li><a
href="#XPath_Assertion">XPath Assertion</a></li><li><a
href="#XML_Schema_Assertion">XML Schema Assertion</
a></li><li><a href="#BSF_Assertion">BSF Assertion</a></li><li><a
href="#JSR223_Assertion">JSR223 Assertion</a></li><li><a
href="#Compare_Assertion">Compare Assertion</a></li><li><a
href="#SMIME_Assertion">SMIME Assertion</a></li></ul></li><li><a
href="#timers">18.6 Timers</a><ul><li><a href="#Constant_Timer">Constant
Timer</a></li><li><a href="#Gaussian_Random_Timer">Gaussian Random
Timer</a></li><li><a href="#Uniform_Random_Timer">Uniform Random
Timer</a></li><li><a href="#Constant_Throughput_Timer">Constant Throughput
Timer</a></li><li><a href="#Synchronizing_Timer">Synchronizing
Timer</a></li><li><a href="#BeanShell_Timer">BeanShell Timer</a></li><li><a
href="#BSF_Timer">BSF Timer</a></li><li><a href="#JSR223_Timer">JSR223
Timer</a></li><li><a href="#Poisson_Random_Timer">Poisson Random
Timer</a></li></ul></li><li><a href="#preprocessors">18.7 Pre
Processors</a><ul><li><a href="#HTML_Link_Parser">HTML Link
Parser</a></li><li><a href="#HTTP_URL_Re-writing_Modifier">HTTP URL Re-wri
ting Modifier</a></li><li><a href="#HTML_Parameter_Mask_(DEPRECATED)">HTML
Parameter Mask (DEPRECATED)</a></li><li><a href="#User_Parameters">User
Parameters</a></li><li><a href="#BeanShell_PreProcessor">BeanShell
PreProcessor</a></li><li><a href="#BSF_PreProcessor">BSF
PreProcessor</a></li><li><a href="#JSR223_PreProcessor">JSR223
PreProcessor</a></li><li><a href="#JDBC_PreProcessor">JDBC
PreProcessor</a></li><li><a href="#RegEx_User_Parameters">RegEx User
Parameters</a></li></ul></li><li><a href="#postprocessors">18.8
Post-Processors</a><ul><li><a href="#Regular_Expression_Extractor">Regular
Expression Extractor</a></li><li><a href="#CSS/JQuery_Extractor">CSS/JQuery
Extractor</a></li><li><a href="#XPath_Extractor">XPath Extractor</a></li><li><a
href="#Result_Status_Action_Handler">Result Status Action
Handler</a></li><li><a href="#BeanShell_PostProcessor">BeanShell
PostProcessor</a></li><li><a href="#BSF_PostProcessor">BSF
PostProcessor</a></li><li><a href="#JSR223_PostProcessor">
JSR223 PostProcessor</a></li><li><a href="#JDBC_PostProcessor">JDBC
PostProcessor</a></li></ul></li><li><a href="#Miscellaneous_Features">18.9
Miscellaneous Features</a><ul><li><a href="#Test_Plan">Test Plan</a></li><li><a
href="#Thread_Group">Thread Group</a></li><li><a
href="#WorkBench">WorkBench</a></li><li><a href="#SSL_Manager">SSL
Manager</a></li><li><a href="#HTTP(S)_Test_Script_Recorder">HTTP(S) Test Script
Recorder
+ </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
onClick="return true"><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 onClick="return true"><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 onClick="return true"><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 onClick="return true"><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="../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></li></ul><ul class="menu"><li onClick="return true"><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 onClick="return
true"><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="pa
gelinks"><li><a href="boss.html">< Prev</a></li><li><a
href="../index.html">Index</a></li><li><a href="functions.html">Next
></a></li></ul><ul class="section-index"><li><a href="#introduction">19.0
Introduction</a><ul></ul></li><li><a href="#samplers">19.1
Samplers</a><ul><li><a href="#FTP_Request">FTP Request</a></li><li><a
href="#HTTP_Request">HTTP Request</a></li><li><a href="#JDBC_Request">JDBC
Request</a></li><li><a href="#Java_Request">Java Request</a></li><li><a
href="#SOAP/XML-RPC_Request">SOAP/XML-RPC Request</a></li><li><a
href="#WebService(SOAP)_Request_(DEPRECATED)">WebService(SOAP) Request
(DEPRECATED)</a></li><li><a href="#LDAP_Request">LDAP Request</a></li><li><a
href="#LDAP_Extended_Request">LDAP Extended Request</a></li><li><a
href="#Access_Log_Sampler">Access Log Sampler</a></li><li><a
href="#BeanShell_Sampler">BeanShell Sampler</a></li><li><a
href="#BSF_Sampler">BSF Sampler</a></li><li><a href="#JSR223_Sampler">JSR223
Sampler</a></li><li><a href="#TCP_Sample
r">TCP Sampler</a></li><li><a href="#JMS_Publisher">JMS
Publisher</a></li><li><a href="#JMS_Subscriber">JMS Subscriber</a></li><li><a
href="#JMS_Point-to-Point">JMS Point-to-Point</a></li><li><a
href="#JUnit_Request">JUnit Request</a></li><li><a
href="#Mail_Reader_Sampler">Mail Reader Sampler</a></li><li><a
href="#Test_Action">Test Action</a></li><li><a href="#SMTP_Sampler">SMTP
Sampler</a></li><li><a href="#OS_Process_Sampler">OS Process
Sampler</a></li><li><a href="#MongoDB_Script">MongoDB
Script</a></li></ul></li><li><a href="#logic_controllers">19.2 Logic
Controllers</a><ul><li><a href="#Simple_Controller">Simple
Controller</a></li><li><a href="#Loop_Controller">Loop
Controller</a></li><li><a href="#Once_Only_Controller">Once Only
Controller</a></li><li><a href="#Interleave_Controller">Interleave
Controller</a></li><li><a href="#Random_Controller">Random
Controller</a></li><li><a href="#Random_Order_Controller">Random Order
Controller</a></li><li><a href="#Throughput_Controller"
>Throughput Controller</a></li><li><a href="#Runtime_Controller">Runtime
>Controller</a></li><li><a href="#If_Controller">If Controller</a></li><li><a
>href="#While_Controller">While Controller</a></li><li><a
>href="#Switch_Controller">Switch Controller</a></li><li><a
>href="#ForEach_Controller">ForEach Controller</a></li><li><a
>href="#Module_Controller">Module Controller</a></li><li><a
>href="#Include_Controller">Include Controller</a></li><li><a
>href="#Transaction_Controller">Transaction Controller</a></li><li><a
>href="#Recording_Controller">Recording Controller</a></li><li><a
>href="#Critical_Section_Controller">Critical Section
>Controller</a></li></ul></li><li><a href="#listeners">19.3
>Listeners</a><ul><li><a href="#Sample_Result_Save_Configuration">Sample
>Result Save Configuration</a></li><li><a href="#Graph_Results">Graph
>Results</a></li><li><a href="#Spline_Visualizer">Spline
>Visualizer</a></li><li><a href="#Assertion_Results">Assertion
>Results</a></li><li><a href="#View_Results_Tr
ee">View Results Tree</a></li><li><a href="#Aggregate_Report">Aggregate
Report</a></li><li><a href="#View_Results_in_Table">View Results in
Table</a></li><li><a href="#Simple_Data_Writer">Simple Data
Writer</a></li><li><a href="#Monitor_Results">Monitor Results</a></li><li><a
href="#Distribution_Graph_(alpha)">Distribution Graph (alpha)</a></li><li><a
href="#Aggregate_Graph">Aggregate Graph</a></li><li><a
href="#Response_Time_Graph">Response Time Graph</a></li><li><a
href="#Mailer_Visualizer">Mailer Visualizer</a></li><li><a
href="#BeanShell_Listener">BeanShell Listener</a></li><li><a
href="#Summary_Report">Summary Report</a></li><li><a
href="#Save_Responses_to_a_file">Save Responses to a file</a></li><li><a
href="#BSF_Listener">BSF Listener</a></li><li><a href="#JSR223_Listener">JSR223
Listener</a></li><li><a href="#Generate_Summary_Results">Generate Summary
Results</a></li><li><a href="#Comparison_Assertion_Visualizer">Comparison
Assertion Visualizer</a></li><li><a href="#Backend_
Listener">Backend Listener</a></li></ul></li><li><a
href="#config_elements">19.4 Configuration Elements</a><ul><li><a
href="#CSV_Data_Set_Config">CSV Data Set Config</a></li><li><a
href="#FTP_Request_Defaults">FTP Request Defaults</a></li><li><a
href="#DNS_Cache_Manager">DNS Cache Manager</a></li><li><a
href="#HTTP_Authorization_Manager">HTTP Authorization Manager</a></li><li><a
href="#HTTP_Cache_Manager">HTTP Cache Manager</a></li><li><a
href="#HTTP_Cookie_Manager">HTTP Cookie Manager</a></li><li><a
href="#HTTP_Request_Defaults">HTTP Request Defaults</a></li><li><a
href="#HTTP_Header_Manager">HTTP Header Manager</a></li><li><a
href="#Java_Request_Defaults">Java Request Defaults</a></li><li><a
href="#JDBC_Connection_Configuration">JDBC Connection
Configuration</a></li><li><a href="#Keystore_Configuration">Keystore
Configuration</a></li><li><a href="#Login_Config_Element">Login Config
Element</a></li><li><a href="#LDAP_Request_Defaults">LDAP Request
Defaults</a></li><li><a href="#LDA
P_Extended_Request_Defaults">LDAP Extended Request Defaults</a></li><li><a
href="#TCP_Sampler_Config">TCP Sampler Config</a></li><li><a
href="#User_Defined_Variables">User Defined Variables</a></li><li><a
href="#Random_Variable">Random Variable</a></li><li><a
href="#Counter">Counter</a></li><li><a href="#Simple_Config_Element">Simple
Config Element</a></li><li><a href="#MongoDB_Source_Config">MongoDB Source
Config</a></li></ul></li><li><a href="#assertions">19.5
Assertions</a><ul><li><a href="#Response_Assertion">Response
Assertion</a></li><li><a href="#Duration_Assertion">Duration
Assertion</a></li><li><a href="#Size_Assertion">Size Assertion</a></li><li><a
href="#XML_Assertion">XML Assertion</a></li><li><a
href="#BeanShell_Assertion">BeanShell Assertion</a></li><li><a
href="#MD5Hex_Assertion">MD5Hex Assertion</a></li><li><a
href="#HTML_Assertion">HTML Assertion</a></li><li><a
href="#XPath_Assertion">XPath Assertion</a></li><li><a
href="#XML_Schema_Assertion">XML Schema Assertion</
a></li><li><a href="#BSF_Assertion">BSF Assertion</a></li><li><a
href="#JSR223_Assertion">JSR223 Assertion</a></li><li><a
href="#Compare_Assertion">Compare Assertion</a></li><li><a
href="#SMIME_Assertion">SMIME Assertion</a></li></ul></li><li><a
href="#timers">19.6 Timers</a><ul><li><a href="#Constant_Timer">Constant
Timer</a></li><li><a href="#Gaussian_Random_Timer">Gaussian Random
Timer</a></li><li><a href="#Uniform_Random_Timer">Uniform Random
Timer</a></li><li><a href="#Constant_Throughput_Timer">Constant Throughput
Timer</a></li><li><a href="#Synchronizing_Timer">Synchronizing
Timer</a></li><li><a href="#BeanShell_Timer">BeanShell Timer</a></li><li><a
href="#BSF_Timer">BSF Timer</a></li><li><a href="#JSR223_Timer">JSR223
Timer</a></li><li><a href="#Poisson_Random_Timer">Poisson Random
Timer</a></li></ul></li><li><a href="#preprocessors">19.7 Pre
Processors</a><ul><li><a href="#HTML_Link_Parser">HTML Link
Parser</a></li><li><a href="#HTTP_URL_Re-writing_Modifier">HTTP URL Re-wri
ting Modifier</a></li><li><a href="#HTML_Parameter_Mask_(DEPRECATED)">HTML
Parameter Mask (DEPRECATED)</a></li><li><a href="#User_Parameters">User
Parameters</a></li><li><a href="#BeanShell_PreProcessor">BeanShell
PreProcessor</a></li><li><a href="#BSF_PreProcessor">BSF
PreProcessor</a></li><li><a href="#JSR223_PreProcessor">JSR223
PreProcessor</a></li><li><a href="#JDBC_PreProcessor">JDBC
PreProcessor</a></li><li><a href="#RegEx_User_Parameters">RegEx User
Parameters</a></li></ul></li><li><a href="#postprocessors">19.8
Post-Processors</a><ul><li><a href="#Regular_Expression_Extractor">Regular
Expression Extractor</a></li><li><a href="#CSS/JQuery_Extractor">CSS/JQuery
Extractor</a></li><li><a href="#XPath_Extractor">XPath Extractor</a></li><li><a
href="#Result_Status_Action_Handler">Result Status Action
Handler</a></li><li><a href="#BeanShell_PostProcessor">BeanShell
PostProcessor</a></li><li><a href="#BSF_PostProcessor">BSF
PostProcessor</a></li><li><a href="#JSR223_PostProcessor">
JSR223 PostProcessor</a></li><li><a href="#JDBC_PostProcessor">JDBC
PostProcessor</a></li></ul></li><li><a href="#Miscellaneous_Features">19.9
Miscellaneous Features</a><ul><li><a href="#Test_Plan">Test Plan</a></li><li><a
href="#Thread_Group">Thread Group</a></li><li><a
href="#WorkBench">WorkBench</a></li><li><a href="#SSL_Manager">SSL
Manager</a></li><li><a href="#HTTP(S)_Test_Script_Recorder">HTTP(S) Test Script
Recorder
(was:
HTTP Proxy Server
)
- </a></li><li><a href="#HTTP_Mirror_Server">HTTP Mirror
Server</a></li><li><a href="#Property_Display">Property Display</a></li><li><a
href="#Debug_Sampler">Debug Sampler</a></li><li><a
href="#Debug_PostProcessor">Debug PostProcessor</a></li><li><a
href="#Test_Fragment">Test Fragment</a></li><li><a
href="#setUp_Thread_Group">setUp Thread Group</a></li><li><a
href="#tearDown_Thread_Group">tearDown Thread Group</a></li></ul></li></ul><div
class="section"><h1 id="introduction">18.0 Introduction<a class="sectionlink"
href="#introduction" title="Link to here">¶</a></h1>
+ </a></li><li><a href="#HTTP_Mirror_Server">HTTP Mirror
Server</a></li><li><a href="#Property_Display">Property Display</a></li><li><a
href="#Debug_Sampler">Debug Sampler</a></li><li><a
href="#Debug_PostProcessor">Debug PostProcessor</a></li><li><a
href="#Test_Fragment">Test Fragment</a></li><li><a
href="#setUp_Thread_Group">setUp Thread Group</a></li><li><a
href="#tearDown_Thread_Group">tearDown Thread Group</a></li></ul></li></ul><div
class="section"><h1 id="introduction">19.0 Introduction<a class="sectionlink"
href="#introduction" title="Link to here">¶</a></h1>
<div class="description">
<p>
@@ -45,7 +45,7 @@
<p>
</p>
</div>
-</div><div class="section"><h1 id="samplers">18.1 Samplers<a
class="sectionlink" href="#samplers" title="Link to here">¶</a></h1>
+</div><div class="section"><h1 id="samplers">19.1 Samplers<a
class="sectionlink" href="#samplers" title="Link to here">¶</a></h1>
<div class="description">
<p>
Samplers perform the actual work of JMeter.
@@ -2021,7 +2021,7 @@ MongoDB Script is more suitable for func
<a href="#">^</a>
-</div><div class="section"><h1 id="logic_controllers">18.2 Logic Controllers<a
class="sectionlink" href="#logic_controllers" title="Link to
here">¶</a></h1>
+</div><div class="section"><h1 id="logic_controllers">19.2 Logic Controllers<a
class="sectionlink" href="#logic_controllers" title="Link to
here">¶</a></h1>
<div class="description">
<br>Logic Controllers determine the order in which Samplers are processed.
</div>
@@ -2652,7 +2652,7 @@ Critical Section Controller takes locks
<a href="#">^</a>
-</div><div class="section"><h1 id="listeners">18.3 Listeners<a
class="sectionlink" href="#listeners" title="Link to here">¶</a></h1>
+</div><div class="section"><h1 id="listeners">19.3 Listeners<a
class="sectionlink" href="#listeners" title="Link to here">¶</a></h1>
<div class="description">
<br>
Most of the listeners perform several roles in addition to "listening"
@@ -3513,7 +3513,7 @@ By default, a Graphite implementation is
<a href="#">^</a>
-</div><div class="section"><h1 id="config_elements">18.4 Configuration
Elements<a class="sectionlink" href="#config_elements" title="Link to
here">¶</a></h1>
+</div><div class="section"><h1 id="config_elements">19.4 Configuration
Elements<a class="sectionlink" href="#config_elements" title="Link to
here">¶</a></h1>
<div class="description">
<br>
Configuration elements can be used to set up defaults and variables for
later use by samplers.
@@ -4395,7 +4395,7 @@ DB db = MongoDBHolder.getDBFromSource("v
<a href="#">^</a>
-</div><div class="section"><h1 id="assertions">18.5 Assertions<a
class="sectionlink" href="#assertions" title="Link to here">¶</a></h1>
+</div><div class="section"><h1 id="assertions">19.5 Assertions<a
class="sectionlink" href="#assertions" title="Link to here">¶</a></h1>
<div class="description">
<p>
Assertions are used to perform additional checks on samplers, and are
processed after <b>every sampler</b>
@@ -4868,7 +4868,7 @@ please ensure that you select "Store the
<a href="#">^</a>
-</div><div class="section"><h1 id="timers">18.6 Timers<a class="sectionlink"
href="#timers" title="Link to here">¶</a></h1>
+</div><div class="section"><h1 id="timers">19.6 Timers<a class="sectionlink"
href="#timers" title="Link to here">¶</a></h1>
<div class="description">
<br>
<p>
@@ -5131,7 +5131,7 @@ to the random delay.</div><div class="re
<a href="#">^</a>
-</div><div class="section"><h1 id="preprocessors">18.7 Pre Processors<a
class="sectionlink" href="#preprocessors" title="Link to here">¶</a></h1>
+</div><div class="section"><h1 id="preprocessors">19.7 Pre Processors<a
class="sectionlink" href="#preprocessors" title="Link to here">¶</a></h1>
<div class="description">
<br>
Preprocessors are used to modify the Samplers in their scope.
@@ -5454,7 +5454,7 @@ this one will be used by "Calculate Pric
<a href="#">^</a>
-</div><div class="section"><h1 id="postprocessors">18.8 Post-Processors<a
class="sectionlink" href="#postprocessors" title="Link to here">¶</a></h1>
+</div><div class="section"><h1 id="postprocessors">19.8 Post-Processors<a
class="sectionlink" href="#postprocessors" title="Link to here">¶</a></h1>
<div class="description">
<p>
As the name suggests, Post-Processors are applied after samplers. Note
that they are
@@ -5902,7 +5902,7 @@ This can be useful if your JDBC Sample c
In the linked test plan,"JDBC PostProcessor" JDBC PostProcessor calls a stored
procedure to delete from Database the Price Cut-Off that was created by
PreProcessor.
<figure><a href="../images/screenshots/jdbc-post-processor.png"><img
src="../images/screenshots/jdbc-post-processor.png" width="818" height="399"
alt="JDBC PostProcessor"></a><figcaption>JDBC
PostProcessor</figcaption></figure>
</p>
-</div><div class="section"><h1 id="Miscellaneous_Features">18.9 Miscellaneous
Features<a class="sectionlink" href="#Miscellaneous_Features" title="Link to
here">¶</a></h1>
+</div><div class="section"><h1 id="Miscellaneous_Features">19.9 Miscellaneous
Features<a class="sectionlink" href="#Miscellaneous_Features" title="Link to
here">¶</a></h1>
<div class="description">
<br>
</div>
Modified: jmeter/branches/docs-2.13/docs/usermanual/functions.html
URL:
http://svn.apache.org/viewvc/jmeter/branches/docs-2.13/docs/usermanual/functions.html?rev=1667464&r1=1667463&r2=1667464&view=diff
==============================================================================
--- jmeter/branches/docs-2.13/docs/usermanual/functions.html (original)
+++ jmeter/branches/docs-2.13/docs/usermanual/functions.html Wed Mar 18
08:07:02 2015
@@ -28,7 +28,7 @@
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
onClick="return true"><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 onClick="return true"><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 onClick="return true"><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 onClick="return true"><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="../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></li></ul><ul class="menu"><li onClick="return true"><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 onClick="return
true"><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="pa
gelinks"><li><a href="component_reference.html">< Prev</a></li><li><a
href="../index.html">Index</a></li><li><a href="regular_expressions.html">Next
></a></li></ul><div class="section"><h1 id="functions">19. Functions and
Variables<a class="sectionlink" href="#functions" title="Link to
here">¶</a></h1>
+ </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
onClick="return true"><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 onClick="return true"><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 onClick="return true"><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 onClick="return true"><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="../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></li></ul><ul class="menu"><li onClick="return true"><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 onClick="return
true"><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="pa
gelinks"><li><a href="component_reference.html">< Prev</a></li><li><a
href="../index.html">Index</a></li><li><a href="regular_expressions.html">Next
></a></li></ul><div class="section"><h1 id="functions">20. Functions and
Variables<a class="sectionlink" href="#functions" title="Link to
here">¶</a></h1>
<p>
JMeter functions are special values that can populate fields of any Sampler or
other
element in a test tree. A function call looks like this:</p>
@@ -128,7 +128,7 @@ Alternatively, just use / instead for th
<tr><td>String</td><td> <a
href="#__TestPlanName">TestPlanName</a></td><td>Return name of current test
plan</td><td>2.6</td></tr>
</table>
<p></p>
-<div class="subsection"><h2>19.1 What can functions do<a class="sectionlink"
href="#what_can_do" title="Link to here">¶</a></h2>
+<div class="subsection"><h2>20.1 What can functions do<a class="sectionlink"
href="#what_can_do" title="Link to here">¶</a></h2>
<p>There are two kinds of functions: user-defined static values (or
variables), and built-in functions.<br>
User-defined static values allow the user to define variables to be replaced
with their static value when
a test tree is compiled and submitted to be run. This replacement happens
once at the beginning of the test
@@ -151,7 +151,7 @@ request throughout the course of the tes
Each occurrence of a function call in a test plan is handled by a separate
function instance.</div><div class="clear"></div>
</div>
-<div class="subsection"><h2>19.2 Where can functions and variables be used?<a
class="sectionlink" href="#where" title="Link to here">¶</a></h2>
+<div class="subsection"><h2>20.2 Where can functions and variables be used?<a
class="sectionlink" href="#where" title="Link to here">¶</a></h2>
<p>
Functions and variables can be written into any field of any test component
(apart from the TestPlan - see below).
Some fields do not allow random strings
@@ -194,7 +194,7 @@ SELECT item from table where name=${VAR}
</div><div class="clear"></div>
</div>
-<div class="subsection"><h2>19.3 How to reference variables and functions<a
class="sectionlink" href="#how" title="Link to here">¶</a></h2>
+<div class="subsection"><h2>20.3 How to reference variables and functions<a
class="sectionlink" href="#how" title="Link to here">¶</a></h2>
<p>Referencing a variable in a test element is done by bracketing the variable
name with '${' and '}'.</p>
<p>Functions are referenced in the same manner, but by convention, the names of
functions begin with "__" to avoid conflict with user value names<sup>*</sup>.
Some functions take arguments to
@@ -246,7 +246,7 @@ that can be used to display the values o
variable will override the built-in function.</div><div class="clear"></div>
</div>
-<div class="subsection"><h2>19.4 The Function Helper Dialog<a
class="sectionlink" href="#function_helper" title="Link to here">¶</a></h2>
+<div class="subsection"><h2>20.4 The Function Helper Dialog<a
class="sectionlink" href="#function_helper" title="Link to here">¶</a></h2>
<p>The Function Helper dialog is available from JMeter's Tools menu.</p>
<figure><a href="../images/screenshots/function_helper_dialog.png"><img
src="../images/screenshots/function_helper_dialog.png" width="831" height="305"
alt="Function Helper Dialog"></a><figcaption>Function Helper
Dialog</figcaption></figure>
<p>Using the Function Helper, you can select a function from the pull down,
and assign
@@ -257,7 +257,7 @@ functions take different arguments.</p>
for you to copy-paste into your test plan wherever you like.</p>
</div>
-<div class="subsection"><h2>19.5 Functions<a class="sectionlink"
href="#functions" title="Link to here">¶</a></h2>
+<div class="subsection"><h2>20.5 Functions<a class="sectionlink"
href="#functions" title="Link to here">¶</a></h2>
<div class="component"><h2 id="__regexFunction">__regexFunction<a
class="sectionlink" href="#__regexFunction" title="Link to here">¶</a></h2>
<div class="description"><p>The Regex Function is used to parse the previous
response (or the value of a variable) using any regular
@@ -1345,7 +1345,7 @@ A reference name - refName - for reusing
</div>
-<div class="subsection"><h2>19.6 Pre-defined Variables<a class="sectionlink"
href="#predefinedvars" title="Link to here">¶</a></h2>
+<div class="subsection"><h2>20.6 Pre-defined Variables<a class="sectionlink"
href="#predefinedvars" title="Link to here">¶</a></h2>
<p>
Most variables are set by calling functions or by test elements such as User
Defined Variables;
in which case the user has full control over the variable name that is used.
@@ -1359,7 +1359,7 @@ Note: this is updated after PostProcesso
<li>START variables (see next section)</li>
</ul>
</div>
-<div class="subsection"><h2>19.6 Pre-defined Properties<a class="sectionlink"
href="#predefinedprops" title="Link to here">¶</a></h2>
+<div class="subsection"><h2>20.6 Pre-defined Properties<a class="sectionlink"
href="#predefinedprops" title="Link to here">¶</a></h2>
<p>
The set of JMeter properties is initialised from the system properties defined
when JMeter starts;
additional JMeter properties are defined in jmeter.properties, user.properties
or on the command line.
Modified: jmeter/branches/docs-2.13/docs/usermanual/glossary.html
URL:
http://svn.apache.org/viewvc/jmeter/branches/docs-2.13/docs/usermanual/glossary.html?rev=1667464&r1=1667463&r2=1667464&view=diff
==============================================================================
--- jmeter/branches/docs-2.13/docs/usermanual/glossary.html (original)
+++ jmeter/branches/docs-2.13/docs/usermanual/glossary.html Wed Mar 18 08:07:02
2015
@@ -28,7 +28,7 @@
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
onClick="return true"><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 onClick="return true"><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 onClick="return true"><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 onClick="return true"><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="../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></li></ul><ul class="menu"><li onClick="return true"><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 onClick="return
true"><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="pa
gelinks"><li><a href="hints_and_tips.html">< Prev</a></li><li><a
href="../index.html">Index</a></li></ul><div class="section"><h1
id="glossary">22. Glossary<a class="sectionlink" href="#glossary" title="Link
to here">¶</a></h1>
+ </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
onClick="return true"><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 onClick="return true"><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 onClick="return true"><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 onClick="return true"><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="../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></li></ul><ul class="menu"><li onClick="return true"><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 onClick="return
true"><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="pa
gelinks"><li><a href="hints_and_tips.html">< Prev</a></li><li><a
href="../index.html">Index</a></li></ul><div class="section"><h1
id="glossary">23. Glossary<a class="sectionlink" href="#glossary" title="Link
to here">¶</a></h1>
<p>
<a name="Elapsed"><b>Elapsed time</b></a>. JMeter measures the elapsed time
from just before sending the request to