Runtime Settings XML

The elements of the run status XML are:

ElementDescription
JavaVM

Optional. Use when defining Java environment runtime settings (for instance, for JUnit scripts).

  • JavaEnvClassPaths: (string) - A list of classpath entries.

  • UserSpecifiedJdk (boolean) - false = "Use internal logic to locate JDK". true = "Use specified JDK". If this field is 'true', then 'JdkHome' must contain a value.

  • JdkHome (string) - The JDK installation path.

  • JavaVmParameters (string) - List the Java command line parameters here. These parameters may be any Java VM argument. The common arguments are the debug flag (-verbose) or memory settings (-ms, -mx). In additional, you may also pass properties to Java applications in the form of a -D flag.

  • UseXboot (boolean) - Instructs VuGen to add the Classpath before the Xbootclasspath (prepend the string).

  • EnableClassLoaderPerVuser (boolean) - Loads each Vuser using a dedicated class loader (runs Vusers as threads).

See Example runtime settings for a Java protocol.

JMeter

Optional. Use when defining runtime settings for a group with a JMeter script.

  • StartMeasurements: Mandatory field (true/false)

  • JMeterHomePath: Optional field (string)

  • JMeterUseDefaultPort: Mandatory field (true/false)

  • JMeterMinPort: Mandatory field if JMeterUseDefaultPort=true (integer)

  • JMeterMaxPort: Mandatory field if JMeterUseDefaultPort=true (integer)

See Example runtime settings for a JMeter script.

Log

Optional: The Log Type attribute is one of:

  • Type="ignore"
  • Type="standard"
  • Type="extended"

Restrictions by type:

TypeRestrictions
ignoreNo contained elements: <Log type="ignore" />
standard Pass the LogOptions element. Do not pass other elements.
extendedPass the LogOptions element.
Optional: Pass any combination of ParametersSubstitution, DataReturnedByServer, and AdvanceTrace.
Log/AdvanceTracetrue or false
Log/DataReturnedByServertrue or false
Log/LogOptions

The LogOptions Type attribute is one of:

  • Type="on error"
  • Type="always"

If Type="on error", CacheSize is required.

Log/LogOptions/CacheSizeInteger 1-100.
Log/ParametersSubstituiontrue or false
PacingOptional: Number or iterations the script will run and required delay between iterations.
Pacing/NumberOfIterationsInteger
Pacing/StartNewIterationThe StartNewIteration Type attribute is one of:
  • Type="immediately"
  • Type="fixed delay"
  • Type="random delay"
  • Type="fixed interval"
  • Type="random interval"

Restrictions by type:

TypeRestrictions
immediatelyNo contained elements: <StartNewIteration type="immediately" />
fixed delay DelayAtRangeOfSeconds is mandatory. Do not pass other fields.
random delayDelayAtRangeOfSeconds is mandatory. Do not pass other fields.
fixed intervalDelayAtRangeOfSeconds and DelayAtRangeToSeconds are mandatory.
random intervalDelayAtRangeOfSeconds and DelayAtRangeToSeconds are mandatory.
Pacing/StartNewIteration/DelayAtRangeOfSecondsNon-negative real number less than DelayAtRangeToSeconds.
Pacing/StartNewIteration/DelayAtRangeToSecondsNon-negative real number
ThinkTime

Optional: The ThinkTime Type attribute is one of:

  • Type="ignore"
  • Type="replay"
  • Type="modify"
  • Type="random"

Restrictions by type:

TypeRestrictions
ignoreNo contained elements: <ThinkTime type="ignore" />
replayLimitThinkTimeSeconds is allowed. Do not pass other fields.
modifyLimitThinkTimeSeconds and MultiplyFactor are allowed. Do not pass other fields.
randomLimitThinkTimeSeconds MinPercentage and MaxPercentage are allowed. Do not pass other fields.
ThinkTime/LimitThinkTimeSecondsOptional. Positive integer. Invalid if ThinkTime Type is ignored.
ThinkTime/MaxPercentagePositive integer.
ThinkTime/MinPercentagePositive integer.
ThinkTime/MultiplyFactor The recorded think time is multiplied by this factor at runtime.

See Also

Start a Test Run