svn commit: r768844 - /jakarta/jmeter/trunk/xdocs/usermanual/component_reference.xml

[se...@apache.org]

Author: sebb
Date: Mon Apr 27 00:55:32 2009
New Revision: 768844

URL: http://svn.apache.org/viewvc?rev=768844&view=rev
Log:
UDV clarifications

Modified:
    jakarta/jmeter/trunk/xdocs/usermanual/component_reference.xml

Modified: jakarta/jmeter/trunk/xdocs/usermanual/component_reference.xml
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/xdocs/usermanual/component_reference.xml?rev=768844&r1=768843&r2=768844&view=diff
==============================================================================
--- jakarta/jmeter/trunk/xdocs/usermanual/component_reference.xml (original)
+++ jakarta/jmeter/trunk/xdocs/usermanual/component_reference.xml Mon Apr 27 00:55:32 2009
@@ -2883,11 +2883,24 @@
 </component>
 
 <component name="User Defined Variables" index="&sect-num;.4.13"  width="690" height="394" screenshot="user_defined_variables.png">
-<description><p>The User Defined Variables lets you define an initial set of variables, just as in the <complink name="Test Plan" />.
+<description><p>The User Defined Variables element lets you define an <b>initial set of variables</b>, just as in the <complink name="Test Plan" />.
 <b>
 Note that all the UDV elements in a test plan - no matter where they are - are processed at the start.
+</b>
 So you cannot reference variables which are defined as part of a test run, e.g. in a Post-Processor.
+</p>
+<p>
+<b>
+UDVs should not be used with functions that generate different results each time they are called.
+Only the result of the first function call will be saved in the variable. 
 </b>
+However, UDVs can be used with functions such as __P(), for example:
+<pre>
+HOST      ${__P(host,localhost)} 
+</pre>
+which would define the variable "HOST" to have the value of the JMeter property "host", defaulting to "localhost" if not defined.
+</p>
+<p>
 For defining variables during a test run, see <complink name="User Parameters"/>.
 UDVs are processed in the order they appear in the Plan, from top to bottom.
 </p>
@@ -2908,7 +2921,7 @@
 <note>
 If you have more than one Thread Group, make sure you use different names for different values, as UDVs are shared between Thread Groups.
 Also, the variables are not available for use until after the element has been processed, 
-so you cannot re-use variables that are defined in the same element.
+so you cannot reference variables that are defined in the same element.
 You can reference variables defined in earlier UDVs or on the Test Plan. 
 </note>
 <properties>



---------------------------------------------------------------------
To unsubscribe, e-mail: jmeter-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: jmeter-dev-help@jakarta.apache.org