Open topic with navigation

# Runtime Settings XML

The elements of the run status XML are:

Element | Description
--- | ---
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:
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:
Type | Restrictions
--- | ---
immediately | No contained elements: `<StartNewIteration type="immediately" />`
fixed delay | DelayAtRangeOfSeconds is mandatory. Do not pass other fields.
random delay | DelayAtRangeOfSeconds is mandatory. Do not pass other fields.
fixed interval | DelayAtRangeOfSeconds and DelayAtRangeToSeconds are mandatory.
random interval | DelayAtRangeOfSeconds 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 runtime.

Example

    <RTS xmlns="http://www.hp.com/PC/REST/API">
        <Pacing>
            <NumberOfIterations>2</NumberOfIterations>
            <StartNewIteration Type="random interval">
                <DelayAtRangeOfSeconds>10</DelayAtRangeOfSeconds>
                <DelayAtRangeToSeconds>20</DelayAtRangeToSeconds>
            </StartNewIteration>
        </Pacing>
        <Log Type="extended">
            <ParametersSubstituion>true</ParametersSubstituion>
            <DataReturnedByServer>true</DataReturnedByServer>
            <AdvanceTrace>true</AdvanceTrace>
            <LogOptions Type="on error">
                <CacheSize>4</CacheSize>
            </LogOptions>
        </Log>
        <ThinkTime Type="random">
            <MinPercentage>50</MinPercentage>
            <MaxPercentage>150</MaxPercentage>
            <LimitThinkTimeSeconds>10</LimitThinkTimeSeconds>
        </ThinkTime>
    </RTS>

Example runtime settings for a JMeter script

    <RTS xmlns="http://www.hp.com/PC/REST/API">
        <JMeter>
            <StartMeasurements>true</StartMeasurements>
            <JMeterHomePath>Some Path</JMeterHomePath>
    	 <JMeterUseDefaultPort>false</JMeterUseDefaultPort>
    	 <JMeterMinPort>2000</JMeterMinPort>
    	<JMeterMaxPort>3000</JMeterMaxPort>
        </JMeter>
    </RTS>

Example runtime settings for a Java protocol

    <RTS xmlns="http://www.hp.com/PC/REST/API">
         <Pacing>...</Pacing>
         <ThinkTime Type="random">...</ThinkTime>
         <Log TypeType="extended">...</Log>

         <JavaVM>
            <JavaEnvClassPaths>
                <JavaEnvClassPath>user_binaries\C__Users_my_user_Desktop_VugenScriptConverterCustomerIssue\junit-1.0-SNAPSHOT.jar</JavaEnvClassPath>
            </JavaEnvClassPaths>
            <UserSpecifiedJdk>true</UserSpecifiedJdk>
            <JdkHome>my_jdk_path</JdkHome>
            <JavaVmParameters>some_parameters_here</JavaVmParameters>
            <UseXboot>true</UseXboot>
            <EnableClassLoaderPerVuser>false</EnableClassLoaderPerVuser>
         </JavaVM>
    </RTS>

## See Also

Start a Test Run