You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@jakarta.apache.org by se...@apache.org on 2010/07/08 12:39:20 UTC
svn commit: r961701 [3/3] - in /jakarta/jmeter/trunk/docs: ./ localising/
usermanual/
Modified: jakarta/jmeter/trunk/docs/usermanual/functions.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/functions.html?rev=961701&r1=961700&r2=961701&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/functions.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/functions.html Thu Jul 8 10:39:18 2010
@@ -114,6 +114,15 @@ style="border-width:0; float: left" fram
<li><a href="http://jakarta.apache.org/site/cvsindex.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/sponsorship.html">Sponsorship</a>
+</li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
</td>
<td width="80%" align="left" valign="top">
<table>
@@ -345,6 +354,23 @@ Input
</td>
<td bgcolor="#a0ddf0" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ <a href="#__FileToString">FileToString</a>
+</font>
+</td>
+<td bgcolor="#a0ddf0" valign="top" align="left">
+<font color="#000000" size="-1" face="arial,helvetica,sanserif">
+read an entire file
+</font>
+</td>
+</tr>
+<tr>
+<td bgcolor="#a0ddf0" valign="top" align="left">
+<font color="#000000" size="-1" face="arial,helvetica,sanserif">
+Input
+</font>
+</td>
+<td bgcolor="#a0ddf0" valign="top" align="left">
+<font color="#000000" size="-1" face="arial,helvetica,sanserif">
<a href="#__CSVRead">CSVRead</a>
</font>
</td>
@@ -1080,8 +1106,6 @@ ${refName_matchNr} to refer to the numbe
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -1222,8 +1246,6 @@ The global counter - "FALSE" - is separa
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -1276,8 +1298,6 @@ There are no arguments for this function
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
<tr><td>
@@ -1318,8 +1338,6 @@ The reference name is now optional, but
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -1376,8 +1394,6 @@ No
The longSum function can be used to compute the sum of two or more long values.
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -1474,8 +1490,6 @@ If an error occurs opening or reading th
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -1646,8 +1660,6 @@ not
<p>
The machineName function returns the local host name
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -1777,8 +1789,6 @@ JMeter is not a browser, and does not in
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -1862,8 +1872,6 @@ the comma after 7 is escaped.
<p>
The random function returns a random number that lies between the given min and max values.
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -1980,8 +1988,6 @@ All subsequent references to the same fi
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -2110,8 +2116,6 @@ ${__property(abcd,,atod)} - return value
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -2210,8 +2214,6 @@ the second would return 1 and the last w
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -2255,8 +2257,6 @@ No
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -2329,8 +2329,6 @@ For example:
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -2484,8 +2482,6 @@ Other variables vary from invocation to
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -2612,8 +2608,6 @@ Remember to include any necessary quotes
</code>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -2721,8 +2715,6 @@ No
</code>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -2776,8 +2768,6 @@ Properties are global to JMeter,
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -2826,8 +2816,6 @@ The time function returns the current ti
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -2938,8 +2926,6 @@ JEXL examples
</ul>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -3098,8 +3084,6 @@ ${__V(A${N})} - works OK. A${N} becomes
</ul>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -3145,8 +3129,6 @@ The eval function returns the result of
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -3225,8 +3207,6 @@ SQL=select ${column} from ${table} where
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -3271,8 +3251,6 @@ Yes
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -3330,8 +3308,6 @@ ${__char(165)} = � (yen)
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -3423,8 +3399,6 @@ e.g.
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -3486,8 +3460,6 @@ becomes:
</p>
-<p><b>Control Panel</b></p>
-<div align="center"><img width='$width' height='$height' src="../images/screenshots/$screenshot"></div>
<p>
<b>Parameters</b>
<table border="1" cellspacing="0" cellpadding="2">
@@ -3508,6 +3480,71 @@ Yes
<tr><td><br></td></tr>
</table>
<hr>
+<table border="0" cellspacing="0" cellpadding="2">
+<tr><td>
+<font face="arial,helvetica,sanserif">
+<h3><a name="__FileToString">19.5.26 __FileToString</h3></a>
+</font>
+</td></tr>
+<tr><td>
+
+
+<p>
+
+ The FileToString function can be used to read an entire file.
+ Each time it is called it reads the entire file.
+
+</p>
+
+
+<p>
+If an error occurs opening or reading the file, then the function returns the string "**ERR**"
+</p>
+
+
+<p>
+<b>Parameters</b>
+<table border="1" cellspacing="0" cellpadding="2">
+<tr><th>Attribute</th><th>Description</th><th>Required</th></tr>
+<tr>
+<td>File Name</td>
+<td>Path to the file name.
+ (The path can be relative to the JMeter launch directory)
+
+</td>
+<td>
+Yes
+</td>
+</tr>
+<tr>
+<td>File encoding if not the platform default</td>
+<td>
+ The encoding to be used to read the file. If not specified, the platform default is used.
+
+</td>
+<td>
+No
+</td>
+</tr>
+<tr>
+<td>Variable Name</td>
+<td>
+A reference name - refName - for reusing the value created by this function. Stored values are of the form ${refName}.
+
+</td>
+<td>
+No
+</td>
+</tr>
+</table>
+</p>
+<p>
+The file name, encoding and reference name parameters are resolved every time the function is executed.
+</p>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<hr>
</blockquote>
</td></tr>
<tr><td><br></td></tr>
@@ -3630,7 +3667,7 @@ They are mainly intended for use in file
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
-Copyright © 1999-2009, Apache Software Foundation
+Copyright © 1999-2010, Apache Software Foundation
</em></font></div>
</td></tr>
<tr><td colspan="2">
Modified: jakarta/jmeter/trunk/docs/usermanual/get-started.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/get-started.html?rev=961701&r1=961700&r2=961701&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/get-started.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/get-started.html Thu Jul 8 10:39:18 2010
@@ -114,6 +114,15 @@ style="border-width:0; float: left" fram
<li><a href="http://jakarta.apache.org/site/cvsindex.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/sponsorship.html">Sponsorship</a>
+</li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
</td>
<td width="80%" align="left" valign="top">
<table>
@@ -154,45 +163,8 @@ any JDBC drivers.
</p>
<p>
-Other software that you may need to download:
-
-<ul>
-
-
-<li>
-<a href="http://www.beanshell.org/">
-BeanShell
-</a>
- - needed for the BeanShell function and test elements
-</li>
-
-
-<li>
-<a href="http://java.sun.com/products/javabeans/glasgow/jaf.html">
-Java Activation Framework
-</a>
- - needed for JavaMail
-</li>
-
-
-<li>
-<a href="http://java.sun.com/products/javamail/index.jsp">
-Java Mail
-</a>
- - needed for Mail Visualiser, Mail Reader and WebService(SOAP) sampler
-</li>
-
-
-<li>
-<a href="http://java.sun.com/products/jms/docs.html">
-JMS
-</a>
- - for JMS samplers
-</li>
-
-
-</ul>
-
+JMeter includes the JMS API jar, but does not include a JMS client implementation.
+If you want to run JMS tests, you will need to download the appropriate jars from the JMS provider.
</p>
<p>
@@ -284,10 +256,6 @@ WebServices (SOAP)
</li>
-<li>
-</li>
-
-
</ul>
@@ -322,12 +290,7 @@ JMeter requires your computing environme
<blockquote>
<p>
<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
-<tr><td>JMeter requires a fully compliant JVM 1.4 or higher.
-
-<br>
-</br>
-
-Version 2.2 and later no longer support Java 1.3.
+<tr><td>JMeter requires a fully compliant JVM 1.5 or higher.
</td></tr>
</table>
@@ -404,7 +367,7 @@ If you plan on doing JMeter development,
<tr><td>
<blockquote>
<p>
-If you want to build the JMeter source or develop JMeter plugins, then you will need a fully compliant JDK 1.4 or higher.
+If you want to build the JMeter source or develop JMeter plugins, then you will need a fully compliant JDK 1.5 or higher.
</p>
</blockquote>
</td></tr>
@@ -449,13 +412,10 @@ implementation.
<tr><td>
<blockquote>
<p>
-JMeter has limited Email capabilities. It can send email based on test results, and has a POP3(S)/IMAP(S) sampler.
-It does not currently support SMTP sampling.
-To enable Email support, add Sun's JavaMail packages and the activation packages to JMeter's
-<a href="#classpath">
-classpath
-</a>
-.
+JMeter has extensive Email capabilities.
+It can send email based on test results, and has a POP3(S)/IMAP(S) sampler.
+It also has an SMTP sampler.
+
</p>
</blockquote>
</td></tr>
@@ -508,7 +468,7 @@ There is also the
</p>
<p>
<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
-<tr><td>The JMeter proxy server (see below) does not support recording SSL (https).
+<tr><td>The JMeter proxy server (see below) supports recording HTTPS (SSL) in versions after 2.3.4
</td></tr>
</table>
</p>
@@ -540,17 +500,21 @@ Make sure the file is a jar file, not a
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="opt_soap"><strong>2.2.6 Apache SOAP</strong></a>
+<a name="opt_jms"><strong>2.2.6 JMS client</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
-Apache SOAP requires mail.jar and activation.jar. You need to download and copy these two jar files to your
-<b>
-jmeter/lib
-</b>
- directory. Once the files are in there, JMeter will automatically pick them up.
+
+JMeter now includes the JMS API from Apache Geronimo, so you just need to add the appropriate JMS Client implementation
+jar(s) from the JMS provider. Please refer to their documentation for details.
+There may also be some information on the
+<a href="http://wiki.apache.org/jakarta-jmeter/">
+JMeter Wiki
+</a>
+.
+
</p>
</blockquote>
</td></tr>
@@ -559,12 +523,27 @@ jmeter/lib
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="libraries_activemq"><strong>2.2.7 Libraries for ActiveMQ 3.0</strong></a>
+<a name="libraries_activemq"><strong>2.2.7 Libraries for ActiveMQ JMS</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
+
+At the time of writing, the current version of ActiveMQ is 5.3.2.
+You will need to add the jar activemq-all-5.3.2.jar to your classpath, e.g. by storing it in the lib/ directory.
+
+</p>
+<p>
+
+Alternatively, add the jar activemq-core-5.3.2.jar to the classpath;
+this requires the javax/management/j2ee classes which can be found in the
+Apache Geronimo jar geronimo-j2ee-management_1.0_spec-1.0.jar.
+The other required jars (such as commons-logging) are already included with JMeter.
+
+</p>
+<p>
+
See
<a href="http://activemq.apache.org/initial-configuration.html">
http://activemq.apache.org/initial-configuration.html
@@ -691,6 +670,21 @@ jmeter-server.bat - start JMeter in serv
</li>
+<li>
+mirror-server.cmd - runs the JMeter Mirror Server in non-GUI mode
+</li>
+
+
+<li>
+shutdown.cmd - Run the Shutdown client to stop a non-GUI instance gracefully
+</li>
+
+
+<li>
+stoptest.cmd - Run the Shutdown client to stop a non-GUI instance abruptly
+</li>
+
+
</ul>
Note: the special name LAST can be used with jmeter-n.cmd, jmeter-t.cmd and jmeter-n-r.cmd
@@ -733,13 +727,29 @@ jmeter.sh - very basic JMeter script wit
</li>
+<li>
+mirror-server.sh - runs the JMeter Mirror Server in non-GUI mode
+</li>
+
+
+<li>
+shutdown.sh - Run the Shutdown client to stop a non-GUI instance gracefully
+</li>
+
+
+<li>
+stoptest.sh - Run the Shutdown client to stop a non-GUI instance abruptly
+</li>
+
+
</ul>
</p>
<p>
-It may be necessary to edit the jmeter shell script if some of the JVM options are not supported.
+It may be necessary to edit the jmeter shell script if some of the JVM options are not supported
+by the JVM you are using.
The JVM_ARGS environment variable can be used to override or set additional JVM options, for example:
<pre>
@@ -809,7 +819,7 @@ Do not use lib/ext for utility jars; it
</p>
<p>
-Other jars (such as JDBC, JavaMail and any other support libaries needed by the JMeter code)
+Other jars (such as JDBC, JMS implementations and any other support libaries needed by the JMeter code)
should be placed in the
<b>
lib
@@ -891,7 +901,7 @@ Alternatively, you can use --proxyHost,
<tr><td>JMeter also has its own in-built
<a href="../usermanual/component_reference.html#HTTP_Proxy_Server">HTTP Proxy Server</a>
,
-which can be used for recording HTTP (but not HTTPS) browser sessions.
+which can be used for recording HTTP or HTTPS browser sessions.
This is not to be confused with the proxy settings described above, which are used when JMeter makes HTTP or HTTPS requests itself.
</td></tr>
</table>
@@ -922,6 +932,9 @@ the following command options
-l [name of JTL file to log sample results to].
</p>
<p>
+-j [name of JMeter run log file].
+</p>
+<p>
-r Run the test in the servers specified by the JMeter property "remote_hosts"
</p>
<p>
@@ -989,7 +1002,7 @@ To run the test from the client in non-G
</p>
<pre>
-jmeter -n -t testplan.jmx -r [-Gprop=val] [-Z]
+jmeter -n -t testplan.jmx -r [-Gprop=val] [-Gglobal.properties] [-Z]
where:
-G is used to define JMeter properties to be set in the servers
-X means exit the servers at the end of the test
@@ -1023,6 +1036,9 @@ To do so, use the following options:
-G[prop name]=[value] - defines a JMeter property to be sent to all remote servers.
</p>
<p>
+-G[propertyfile] - defines a file containing JMeter properties to be sent to all remote servers.
+</p>
+<p>
-L[category]=[priority] - overrides a logging setting, setting a particular category to the given priority level.
</p>
<p>
@@ -1436,7 +1452,7 @@ See also the comments in the jmeter.prop
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
-Copyright © 1999-2009, Apache Software Foundation
+Copyright © 1999-2010, Apache Software Foundation
</em></font></div>
</td></tr>
<tr><td colspan="2">
Modified: jakarta/jmeter/trunk/docs/usermanual/glossary.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/glossary.html?rev=961701&r1=961700&r2=961701&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/glossary.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/glossary.html Thu Jul 8 10:39:18 2010
@@ -114,6 +114,15 @@ style="border-width:0; float: left" fram
<li><a href="http://jakarta.apache.org/site/cvsindex.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/sponsorship.html">Sponsorship</a>
+</li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
</td>
<td width="80%" align="left" valign="top">
<table>
@@ -122,10 +131,7 @@ style="border-width:0; float: left" fram
<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="$next"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
-</td>
-<td bgcolor="#525D76">
-<div align="right"><a href="regular_expressions.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
+<div align="right"><a href="hints_and_tips.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
</td>
</tr>
</table>
@@ -133,7 +139,7 @@ style="border-width:0; float: left" fram
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="glossary"><strong>21. Glossary</strong></a></font>
+<a name="glossary"><strong>22. Glossary</strong></a></font>
</td></tr>
<tr><td>
<blockquote>
@@ -315,10 +321,7 @@ The formula is: Throughput = (number of
<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="$next"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
-</td>
-<td bgcolor="#525D76">
-<div align="right"><a href="regular_expressions.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
+<div align="right"><a href="hints_and_tips.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
</td>
</tr>
</table>
@@ -330,7 +333,7 @@ The formula is: Throughput = (number of
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
-Copyright © 1999-2009, Apache Software Foundation
+Copyright © 1999-2010, Apache Software Foundation
</em></font></div>
</td></tr>
<tr><td colspan="2">
Added: jakarta/jmeter/trunk/docs/usermanual/hints_and_tips.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/hints_and_tips.html?rev=961701&view=auto
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/hints_and_tips.html (added)
+++ jakarta/jmeter/trunk/docs/usermanual/hints_and_tips.html Thu Jul 8 10:39:18 2010
@@ -0,0 +1,299 @@
+<!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 -->
+<!-- ====================================================================== -->
+<!-- Main Page Section -->
+<!-- ====================================================================== -->
+<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>JMeter - User's Manual: Hints and Tips</title>
+</head>
+
+<body bgcolor="#ffffff" text="#000000" link="#525D76">
+<table border="0" cellspacing="0">
+<!-- TOP IMAGE -->
+<tr>
+<td>
+<!-- Need to specify height otherwise iframe seems to grab extra -->
+<iframe src="http://www.apache.org/ads/halfbanner.html" height="102"
+style="border-width:0; float: left" frameborder="0" scrolling="no"></iframe>
+</td>
+<td align="left">
+<a href="http://jakarta.apache.org"><img width="505" height="48" src="../images/jakarta-logo.gif" alt="Jakarta" title="Jakarta" border="0"/></a>
+</td>
+<td align="right">
+<a href="http://jakarta.apache.org/jmeter/"><img width="221" height="102" src="../images/logo.jpg" alt="JMeter" title="JMeter" border="0"/></a>
+</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">
+<p><strong>About</strong></p>
+<ul>
+<li><a href="../index.html">Overview</a>
+</li>
+<li><a href="../changes.html">Changes</a>
+</li>
+<li><a href="../known_bugs.html">Known Bugs</a>
+</li>
+<li><a href="../license.html">License</a>
+</li>
+<li><a href="http://wiki.apache.org/jakarta-jmeter/JMeterCommitters">Contributors</a>
+</li>
+</ul>
+<p><strong>Download</strong></p>
+<ul>
+<li><a href="http://jakarta.apache.org/site/downloads/downloads_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="../usermanual/index.html">User Manual</a>
+</li>
+<li><a href="../api/index.html">Javadocs</a>
+</li>
+<li><a href="../localising/index.html">Localisation (Translator's Guide)</a>
+</li>
+<li><a href="../building.html">Building JMeter and Add-Ons</a>
+</li>
+<li><a href="http://wiki.apache.org/jakarta-jmeter">JMeter Wiki</a>
+</li>
+<li><a href="http://wiki.apache.org/jakarta-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://jakarta.apache.org/site/getinvolved.html">Get Involved</a>
+</li>
+<li><a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
+</li>
+<li><a href="http://jakarta.apache.org/site/cvsindex.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/sponsorship.html">Sponsorship</a>
+</li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
+</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="glossary.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
+</td>
+<td bgcolor="#525D76">
+<div align="right"><a href="regular_expressions.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">
+<a name="hints"><strong>21. Hints and Tips</strong></a></font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+
+This section is a collection of various hints and tips that have been suggested by various questions on the JMeter User list.
+If you don't find what you are looking for here, please check the
+<a href="http://wiki.apache.org/jakarta-jmeter">
+JMeter Wiki
+</a>
+.
+Also, try search the JMeter User list; someone may well have already provided a solution.
+
+</p>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#828DA6">
+<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="variable_and_threads"><strong>21.1 Passing variables between threads</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+
+JMeter variables have thread scope. This is deliberate, so that threads can act indepently.
+However sometimes there is a need to pass variables between different threads, in the same or different Thread Groups.
+
+</p>
+<p>
+
+One way to do this is to use a property instead.
+Properties are shared between all JMeter threads, so if one thread
+<a href="functions.html#__setProperty">
+sets a property
+</a>
+,
+another thread can
+<a href="functions.html#__P">
+read
+</a>
+ the updated value.
+
+</p>
+<p>
+
+If there is a lot of information that needs to be passed between threads, then consider using a file.
+For example you could use the
+<a href="component_reference.html#Save_Responses_to_a_file">
+Save Responses to a file
+</a>
+
+listener or perhaps a BeanShell PostProcessor in one thread, and read the file using the HTTP Sampler "file:" protocol,
+and extract the information using a PostProcessor or BeanShell element.
+
+</p>
+<p>
+
+If you can derive the data before starting the test, then it may well be better to store it in a file,
+read it using CSV Dataset.
+
+</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="debug_logging"><strong>21.2 Enabling Debug logging</strong></a>
+</font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+
+Most test elements include debug logging. If running a test plan from the GUI,
+select the test element and use the Help Menu to enable or disable logging.
+The Help Menu also has an option to display the GUI and test element class names.
+You can use these to determine the correct property setting to change the logging level.
+
+</p>
+</blockquote>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+</blockquote>
+</p>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<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="glossary.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
+</td>
+<td bgcolor="#525D76">
+<div align="right"><a href="regular_expressions.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
+</td>
+</tr>
+</table>
+<br>
+</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-2010, Apache Software Foundation
+</em></font></div>
+</td></tr>
+<tr><td colspan="2">
+<div align="center"><font color="#525D76" size="-1">
+"Apache", the Apache feather, and the Apache JMeter logo are
+trademarks of the Apache Software Foundation for our open source software.
+</font>
+</div>
+</td></tr>
+</table>
+</body>
+</html>
+<!-- end the processing -->
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Propchange: jakarta/jmeter/trunk/docs/usermanual/hints_and_tips.html
------------------------------------------------------------------------------
svn:eol-style = native
Modified: jakarta/jmeter/trunk/docs/usermanual/index.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/index.html?rev=961701&r1=961700&r2=961701&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/index.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/index.html Thu Jul 8 10:39:18 2010
@@ -114,6 +114,15 @@ style="border-width:0; float: left" fram
<li><a href="http://jakarta.apache.org/site/cvsindex.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/sponsorship.html">Sponsorship</a>
+</li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
</td>
<td width="80%" align="left" valign="top">
<table>
@@ -124,9 +133,6 @@ style="border-width:0; float: left" fram
<td bgcolor="#525D76">
<div align="right"><a href="intro.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
</td>
-<td bgcolor="#525D76">
-<div align="right"><a href="$prev"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
-</td>
</tr>
</table>
<br>
@@ -392,12 +398,23 @@ Changes
<li>
+<a href="#hints">
++
+</a>
+...
+<a href="hints_and_tips.html">
+21. Hints and Tips
+</a>
+</li>
+
+
+<li>
<a href="#glossary">
+
</a>
...
<a href="glossary.html">
-21. Glossary
+22. Glossary
</a>
</li>
@@ -1258,17 +1275,26 @@ Changes
<li>
<a name="regex">
</a>
-<a href="regukar_expressions.html">
+<a href="regular_expressions.html">
20. Regular Expressions
</a>
</li>
<li>
+<a name="hints">
+</a>
+<a href="hints_and_tips.html">
+21. Hints and Tips
+</a>
+</li>
+
+
+<li>
<a name="glossary">
</a>
<a href="glossary.html">
-21. Glossary
+22. Glossary
</a>
</li>
@@ -1291,9 +1317,6 @@ Changes
<td bgcolor="#525D76">
<div align="right"><a href="intro.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
</td>
-<td bgcolor="#525D76">
-<div align="right"><a href="$prev"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
-</td>
</tr>
</table>
<br>
@@ -1304,7 +1327,7 @@ Changes
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
-Copyright © 1999-2009, Apache Software Foundation
+Copyright © 1999-2010, Apache Software Foundation
</em></font></div>
</td></tr>
<tr><td colspan="2">
Modified: jakarta/jmeter/trunk/docs/usermanual/intro.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/intro.html?rev=961701&r1=961700&r2=961701&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/intro.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/intro.html Thu Jul 8 10:39:18 2010
@@ -114,6 +114,15 @@ style="border-width:0; float: left" fram
<li><a href="http://jakarta.apache.org/site/cvsindex.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/sponsorship.html">Sponsorship</a>
+</li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
</td>
<td width="80%" align="left" valign="top">
<table>
@@ -124,9 +133,6 @@ style="border-width:0; float: left" fram
<td bgcolor="#525D76">
<div align="right"><a href="get-started.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
</td>
-<td bgcolor="#525D76">
-<div align="right"><a href="$prev"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
-</td>
</tr>
</table>
<br>
@@ -228,9 +234,6 @@ capabilities.
<td bgcolor="#525D76">
<div align="right"><a href="get-started.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
</td>
-<td bgcolor="#525D76">
-<div align="right"><a href="$prev"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
-</td>
</tr>
</table>
<br>
@@ -241,7 +244,7 @@ capabilities.
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
-Copyright © 1999-2009, Apache Software Foundation
+Copyright © 1999-2010, Apache Software Foundation
</em></font></div>
</td></tr>
<tr><td colspan="2">
Modified: jakarta/jmeter/trunk/docs/usermanual/ldapanswer_xml.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/ldapanswer_xml.html?rev=961701&r1=961700&r2=961701&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/ldapanswer_xml.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/ldapanswer_xml.html Thu Jul 8 10:39:18 2010
@@ -116,21 +116,17 @@ style="border-width:0; float: left" fram
<li><a href="http://jakarta.apache.org/site/cvsindex.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/sponsorship.html">Sponsorship</a>
+</li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
</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="$next"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
-</td>
-<td bgcolor="#525D76">
-<div align="right"><a href="$prev"><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">
@@ -396,19 +392,6 @@ This contains the attribute value as ret
</td></tr>
<tr><td><br></td></tr>
</table>
-<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="$next"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
-</td>
-<td bgcolor="#525D76">
-<div align="right"><a href="$prev"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
-</td>
-</tr>
-</table>
<br>
</td>
</tr>
@@ -417,7 +400,7 @@ This contains the attribute value as ret
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
-Copyright © 1999-2009, Apache Software Foundation
+Copyright © 1999-2010, Apache Software Foundation
</em></font></div>
</td></tr>
<tr><td colspan="2">
Modified: jakarta/jmeter/trunk/docs/usermanual/ldapops_tutor.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/ldapops_tutor.html?rev=961701&r1=961700&r2=961701&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/ldapops_tutor.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/ldapops_tutor.html Thu Jul 8 10:39:18 2010
@@ -116,21 +116,17 @@ style="border-width:0; float: left" fram
<li><a href="http://jakarta.apache.org/site/cvsindex.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/sponsorship.html">Sponsorship</a>
+</li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
</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="$next"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
-</td>
-<td bgcolor="#525D76">
-<div align="right"><a href="$prev"><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">
@@ -401,19 +397,6 @@ style="border-width:0; float: left" fram
</td></tr>
<tr><td><br></td></tr>
</table>
-<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="$next"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
-</td>
-<td bgcolor="#525D76">
-<div align="right"><a href="$prev"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
-</td>
-</tr>
-</table>
<br>
</td>
</tr>
@@ -422,7 +405,7 @@ style="border-width:0; float: left" fram
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
-Copyright © 1999-2009, Apache Software Foundation
+Copyright © 1999-2010, Apache Software Foundation
</em></font></div>
</td></tr>
<tr><td colspan="2">
Modified: jakarta/jmeter/trunk/docs/usermanual/listeners.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/listeners.html?rev=961701&r1=961700&r2=961701&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/listeners.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/listeners.html Thu Jul 8 10:39:18 2010
@@ -114,6 +114,15 @@ style="border-width:0; float: left" fram
<li><a href="http://jakarta.apache.org/site/cvsindex.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/sponsorship.html">Sponsorship</a>
+</li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
</td>
<td width="80%" align="left" valign="top">
<table>
@@ -311,6 +320,7 @@ The full set of properties that affect r
#jmeter.save.saveservice.hostname=false
#jmeter.save.saveservice.thread_counts=false
#jmeter.save.saveservice.sample_count=false
+#jmeter.save.saveservice.idle_time=false
# Timestamp format
# legitimate values: none, ms, or a format suitable for SimpleDateFormat
@@ -352,7 +362,7 @@ sampleresult.timestamp.start=true
<p>
The date format to be used for the timestamp_format is described in
-<a HREF="http://java.sun.com/j2se/1.4/docs/api/java/text/SimpleDateFormat.html">
+<a HREF="http://java.sun.com/j2se/1.5/docs/api/java/text/SimpleDateFormat.html">
<b>
@@ -408,7 +418,7 @@ Items with (CSV) after the name only app
CSV format cannot currently be used to save any items that include line-breaks.
</p>
-<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img width='$width' height='$height' src="../images/screenshots/sample_result_config.png"><br>
+<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/sample_result_config.png"><br>
<font size="-1"><br>
</br>
<b>
@@ -509,27 +519,48 @@ Simple Data Writer
<li>
-BeanShell Listener
+BeanShell/BSF Listener
</li>
<li>
-Assertion Results
+Mailer Visualizer
</li>
<li>
-Mailer Visualizer
+Monitor Results
</li>
<li>
-Monitor Results
+Summary Report
</li>
+</ul>
+<p>
+
+The following Listeners no longer need to keep copies of every single sample.
+Instead, samples with the same elapsed time are aggregated.
+Less memory is now needed, especially if most samples only take a second or two at most.
+
+</p>
+<ul>
+
+
<li>
-Summary Report
+Aggregate Report
+</li>
+
+
+<li>
+Aggregate Graph
+</li>
+
+
+<li>
+Distribution Graph
</li>
@@ -655,56 +686,16 @@ Hostname where the sample was generated
<li>
-Variables, if specified
+IdleTime - number of milliseconds of 'Idle' time (normally 0)
</li>
-</ul>
-</blockquote>
-</p>
-</td></tr>
-<tr><td><br></td></tr>
-</table>
-<table border="0" cellspacing="0" cellpadding="2" width="100%">
-<tr><td bgcolor="#525D76">
-<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="xmlformat2.0"><strong>14.5 XML Log format 2.0</strong></a></font>
-</td></tr>
-<tr><td>
-<blockquote>
-<p>
-
-The format of the original XML (2.0) is as follows (line breaks will be different):
+<li>
+Variables, if specified
+</li>
-</p>
-<pre>
-<?xml version="1.0" encoding="UTF-8"?>
-<testResults version="1.2">
-<sampleResult timeStamp="1144365463297" dataType="text" threadName="Listen 1-1"
- label="HTTP Request" time="1502"
- responseMessage="OK" responseCode="200" success="true">
- <sampleResult timeStamp="1144365464238" dataType="text" threadName="Listen 1-1"
- label="http://www.apache.org/style/style.css" time="171"
- responseMessage="OK" responseCode="200" success="true">
- <property xml:space="preserve" name="samplerData">
- GET http://www.apache.org/style/style.css
- </property>
- <binary>
- body, td, th {
- font-size: 95%;
- font-family: Arial, Geneva, Helvetica, sans-serif;
- color: black;
- background-color: white;
- }
- ...
- </binary>
- </sampleResult>
-</sampleResult>
-...
-</testResults>
-
-</pre>
+</ul>
</blockquote>
</p>
</td></tr>
@@ -713,7 +704,7 @@ The format of the original XML (2.0) is
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
-<a name="xmlformat2.1"><strong>14.6 XML Log format 2.1</strong></a></font>
+<a name="xmlformat2.1"><strong>14.5 XML Log format 2.1</strong></a></font>
</td></tr>
<tr><td>
<blockquote>
@@ -821,6 +812,23 @@ Note that the sample node name may be ei
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
+<a name="xmlformat2.2"><strong>14.6 XML Log format 2.2</strong></a></font>
+</td></tr>
+<tr><td>
+<blockquote>
+<p>
+
+The format of the JTL files is identical for 2.2 and 2.1. Format 2.2 only affects JMX files.
+
+</p>
+</blockquote>
+</p>
+</td></tr>
+<tr><td><br></td></tr>
+</table>
+<table border="0" cellspacing="0" cellpadding="2" width="100%">
+<tr><td bgcolor="#525D76">
+<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="attributes"><strong>14.7 Sample Attributes</strong></a></font>
</td></tr>
<tr><td>
@@ -906,6 +914,18 @@ Hostname where the sample was generated
<tr>
<td bgcolor="#a0ddf0" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
+it
+</font>
+</td>
+<td bgcolor="#a0ddf0" valign="top" align="left">
+<font color="#000000" size="-1" face="arial,helvetica,sanserif">
+Idle Time = time not spent sampling (milliseconds) (generally 0)
+</font>
+</td>
+</tr>
+<tr>
+<td bgcolor="#a0ddf0" valign="top" align="left">
+<font color="#000000" size="-1" face="arial,helvetica,sanserif">
lb
</font>
</td>
@@ -1162,7 +1182,7 @@ The data will be saved to the clipboard,
e.g. a spreadsheet or text editor.
</p>
-<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img width='$width' height='$height' src="../images/screenshots/save_image.png"><br>
+<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img src="../images/screenshots/save_image.png"><br>
<font size="-1">Figure 1 - Edit -> Save As Image
</font></td></tr></table></p>
</blockquote>
@@ -1191,7 +1211,7 @@ e.g. a spreadsheet or text editor.
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
-Copyright © 1999-2009, Apache Software Foundation
+Copyright © 1999-2010, Apache Software Foundation
</em></font></div>
</td></tr>
<tr><td colspan="2">
Modified: jakarta/jmeter/trunk/docs/usermanual/regular_expressions.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/regular_expressions.html?rev=961701&r1=961700&r2=961701&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/regular_expressions.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/regular_expressions.html Thu Jul 8 10:39:18 2010
@@ -114,6 +114,15 @@ style="border-width:0; float: left" fram
<li><a href="http://jakarta.apache.org/site/cvsindex.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/sponsorship.html">Sponsorship</a>
+</li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
</td>
<td width="80%" align="left" valign="top">
<table>
@@ -122,7 +131,7 @@ style="border-width:0; float: left" fram
<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="glossary.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
+<div align="right"><a href="hints_and_tips.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
</td>
<td bgcolor="#525D76">
<div align="right"><a href="functions.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
@@ -251,29 +260,44 @@ Placement of modifiers
</td></tr>
<tr><td>
<blockquote>
+<h3>
+Extract single string
+</h3>
<p>
-Extract single string
+Suppose you want to match the following portion of a web-page:
<br>
</br>
-Suppose you want to match the following portion of a web-page:
+
+<code>
+name="file" value="readme.txt">
+</code>
+
<br>
</br>
-name="file" value="readme.txt" and you want to extract readme.txt.
+and you want to extract
+<code>
+readme.txt
+</code>
+.
<br>
</br>
-A suitable reqular expression would be:
+A suitable regular expression would be:
<br>
</br>
-name="file" value="(.+?)"
+
+<code>
+name="file" value="(.+?)">
+</code>
+
<p>
@@ -291,7 +315,16 @@ The special characters above are:
<li>
-. - match any character. + - one or more times.
+. - match any character
+</li>
+
+
+<li>
++ - one or more times
+</li>
+
+
+<li>
? - don't be greedy, i.e. stop when first match succeeds
</li>
@@ -301,17 +334,83 @@ The special characters above are:
<p>
-Note: without the ?, the .+ would continue past the first " until it found the last possible " - probably not what was intended.
+Note: without the ?, the .+ would continue past the first
+<code>
+">
+</code>
+
+until it found the last possible
+<code>
+">
+</code>
+ - which is probably not what was intended.
</p>
<p>
-Extract multiple strings
+
+Note: although the above expression works, it's more efficient to use the following expression:
+
+<br>
+</br>
+
+
+<code>
+name="file" value="([^"]+)">
+</code>
+
+where
+<br>
+</br>
+
+[^"] - means match anything except "
+<br>
+</br>
+
+In this case, the matching engine can stop looking as soon as it sees the first
+<code>
+"
+</code>
+,
+whereas in the previous case the engine has to check that it has found
+<code>
+">
+</code>
+ rather than say
+<code>
+" >
+</code>
+.
+
</p>
-Suppose you want to match the following portion of a web-page: name="file.name" value="readme.txt" and you want to extract file.name and readme.txt.
+<h3>
+Extract multiple strings
+</h3>
+
+
+<p>
+
+Suppose you want to match the following portion of a web-page:
+<br>
+</br>
+
+
+<code>
+name="file.name" value="readme.txt"
+</code>
+
+and you want to extract both
+<code>
+file.name
+</code>
+ and
+<code>
+readme.txt
+</code>
+.
<br>
</br>
@@ -321,13 +420,20 @@ A suitable reqular expression would be:
<br>
</br>
-name="(.+?)" value="(.+?)"
+
+<code>
+name="([^"]+)" value="([^"]+)"
+</code>
+
<br>
</br>
This would create 2 groups, which could be used in the JMeter Regular Expression Extractor template as $1$ and $2$.
+</p>
+
+
<p>
The JMeter Regex Extractor saves the values of the groups in additional variables.
@@ -601,7 +707,7 @@ without needing to access any external s
<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="glossary.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
+<div align="right"><a href="hints_and_tips.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Next</font></a></div>
</td>
<td bgcolor="#525D76">
<div align="right"><a href="functions.html"><font size=-1 color="#ffffff" face="arial,helvetica,sanserif">Prev</font></a></div>
@@ -616,7 +722,7 @@ without needing to access any external s
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
-Copyright © 1999-2009, Apache Software Foundation
+Copyright © 1999-2010, Apache Software Foundation
</em></font></div>
</td></tr>
<tr><td colspan="2">
Modified: jakarta/jmeter/trunk/docs/usermanual/remote-test.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/remote-test.html?rev=961701&r1=961700&r2=961701&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/remote-test.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/remote-test.html Thu Jul 8 10:39:18 2010
@@ -114,6 +114,15 @@ style="border-width:0; float: left" fram
<li><a href="http://jakarta.apache.org/site/cvsindex.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/sponsorship.html">Sponsorship</a>
+</li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
</td>
<td width="80%" align="left" valign="top">
<table>
@@ -151,7 +160,7 @@ all the data from them. This offers the
<li>
-Saving of test samples to a local machine
+Saving of test samples to the local machine
</li>
@@ -160,11 +169,25 @@ Managment of multiple JMeterEngines from
</li>
+<li>
+No need to copy the test plan to each server - the client sends it to all the servers
+</li>
+
+
</ul>
</p>
<p>
+<table border="1" bgcolor="#bbbb00" width="50%" cellspacing="0" cellpadding="2">
+<tr><td>
+Note: The same test plan is run by all the servers.
+JMeter does not distribute the load between servers, each runs the full test plan.
+
+</td></tr>
+</table>
+</p>
+<p>
However, remote mode does use more resources than running the same number of non-GUI tests independently.
If many server instances are used, the client JMeter can become overloaded, as can the client network connection.
@@ -183,6 +206,29 @@ itself.
</p>
<p>
<b>
+Step 0: Configure the nodes
+</b>
+</p>
+<p>
+
+Make sure that all the nodes (client and servers) are running exactly the same version of JMeter.
+As far as possible, also use the same version of Java on all systems.
+Using different versions of Java may work - but is best avoided.
+
+</p>
+<p>
+
+If the test uses any data files, note that these are not sent across by the client so
+make sure that these are available in the appropriate directory on each server.
+If necessary you can define different values for properties by editting the user.properties or system.properties
+files on each server. These properties will be picked up when the server is started and may be
+used in the test plan to affect its behaviour (e.g. connecting to a different remote server).
+Alternatively use different content in any datafiles used by the test
+(e.g. if each server must use unique ids, divide these between the data files)
+
+</p>
+<p>
+<b>
Step 1: Start the servers
</b>
</p>
@@ -572,6 +618,24 @@ error count
</li>
+<li>
+Stripped - remove responseData from succesful samples
+</li>
+
+
+<li>
+StrippedBatch - remove responseData from succesful samples, and send as batches
+</li>
+
+
+<li>
+Custom implementation : set the mode parameter to your custom sample sender class name.
+ This must implement the interface SampleSender and have a constructor which takes a single
+ parameter of type RemoteSampleListener.
+
+</li>
+
+
</ul>
@@ -623,7 +687,7 @@ time_threshold - number of milliseconds
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
-Copyright © 1999-2009, Apache Software Foundation
+Copyright © 1999-2010, Apache Software Foundation
</em></font></div>
</td></tr>
<tr><td colspan="2">
Modified: jakarta/jmeter/trunk/docs/usermanual/test_plan.html
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/docs/usermanual/test_plan.html?rev=961701&r1=961700&r2=961701&view=diff
==============================================================================
--- jakarta/jmeter/trunk/docs/usermanual/test_plan.html (original)
+++ jakarta/jmeter/trunk/docs/usermanual/test_plan.html Thu Jul 8 10:39:18 2010
@@ -114,6 +114,15 @@ style="border-width:0; float: left" fram
<li><a href="http://jakarta.apache.org/site/cvsindex.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/sponsorship.html">Sponsorship</a>
+</li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</li>
+</ul>
</td>
<td width="80%" align="left" valign="top">
<table>
@@ -612,7 +621,11 @@ The timer will cause JMeter to delay a c
before
</b>
each
-request that a thread makes.
+sampler which is in its
+<a href="#scoping_rules">
+scope
+</a>
+.
</p>
<p>
@@ -658,6 +671,16 @@ will then check that the text is present
text, then it will mark this as a failed request.
</p>
<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.
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.
@@ -693,7 +716,7 @@ branch. For example, we defined two HTT
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 width='$width' height='$height' src="../images/screenshots/http-config/http-config-example.png"><br>
+<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>
@@ -919,7 +942,7 @@ Assertion 1
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 width='$width' height='$height' src="../images/screenshots/scoping1.png"><br>
+<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>
<p>
@@ -938,7 +961,7 @@ If its parent is a request, then it is a
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 width='$width' height='$height' src="../images/screenshots/scoping2.png"><br>
+<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>
@@ -947,7 +970,7 @@ Assertion #1 is applied only to Request
<p>
Another example, this time using Timers:
</p>
-<p><table border="0" cellspacing="0" cellpadding="0"><tr><td><img width='$width' height='$height' src="../images/screenshots/scoping3.png"><br>
+<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>
@@ -1164,7 +1187,7 @@ jmeter ... -Jhost=www3.example.org -Jloo
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
-Copyright © 1999-2009, Apache Software Foundation
+Copyright © 1999-2010, Apache Software Foundation
</em></font></div>
</td></tr>
<tr><td colspan="2">
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@jakarta.apache.org
For additional commands, e-mail: notifications-help@jakarta.apache.org