Run-time Settings XML

The elements of the run status XML are:

Element Description
JMeter

Optional. Use when defining run time 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 Run time settings for a JMeter script.

Log

Optional: The Log Type attribute is one of:

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

Restrictions by type:

Type Restrictions
ignore No contained elements: <Log type="ignore" />
standard Pass the LogOptions element. Do not pass other elements.
extended Pass the LogOptions element.
Optional: Pass any combination of ParametersSubstitution, DataReturnedByServer, and AdvanceTrace.
Log/AdvanceTrace true or false
Log/DataReturnedByServer true 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/CacheSize Integer 1-100.
Log/ParametersSubstituion true or false
Pacing Optional: Number or iterations the script will run and required delay between iterations.
Pacing/NumberOfIterations Integer
Pacing/StartNewIteration The 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/DelayAtRangeOfSeconds Non-negative real number less than DelayAtRangeToSeconds.
Pacing/StartNewIteration/DelayAtRangeToSeconds Non-negative real number
ThinkTime

Optional: The ThinkTime Type attribute is one of:

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

Restrictions by type:

Type Restrictions
ignore No contained elements: <ThinkTime type="ignore" />
replay LimitThinkTimeSeconds is allowed. Do not pass other fields.
modify LimitThinkTimeSeconds and MultiplyFactor are allowed. Do not pass other fields.
random LimitThinkTimeSeconds MinPercentage and MaxPercentage are allowed. Do not pass other fields.
ThinkTime/LimitThinkTimeSeconds Optional. Positive integer. Invalid if ThinkTime Type is ignored.
ThinkTime/MaxPercentage Positive integer.
ThinkTime/MinPercentage Positive integer.
ThinkTime/MultiplyFactor The recorded think time is multiplied by this factor at run time.

See Also

Start a Test Run