Share this page

# Runtime settings

The elements of the run status XML and JSON are listed below.

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 Examples:.
JMeter | Available in versions: 2021 and later Optional. Use when defining runtime settings for a group with a JMeter script when using a custom JRE installation. JREPath:Path to the JRE folder. AdditionalParameters: Any additional parameters to be passed to Java when the test starts. Available in versions: 2020-2020 SP3 only 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 Examples:.
Log | Optional: The Log `Type` attribute is one of: Type="ignore" Type="standard" Type="extended" Restrictions by type: ignore. No contained elements: `<Logtype="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: immediately. No contained elements: `<StartNewIteration type="immediately" />` fixed delay. DelayOfSeconds is mandatory. Do not pass other fields. random delay. DelayAtRangeOfSeconds and DelayAtRangeToSeconds are mandatory. fixed interval. DelayOfSeconds is mandatory. random interval. DelayAtRangeOfSeconds and DelayAtRangeToSeconds are mandatory.
Pacing/StartNewIteration/DelayOfSeconds | Non-negative real number for fixed delay or interval, that represents the minimum pause between iterations, or since the start of the last iteration.
Pacing/StartNewIteration/DelayAtRangeOfSeconds | Non-negative real number less than DelayAtRangeToSeconds. For random delay or interval, represents the minimum pause time between iterations, or since the last iteration started.
Pacing/StartNewIteration/DelayAtRangeToSeconds | Non-negative real number, in seconds, that represents the maximum pause between iterations, or since the start of the last iteration.
Selenium | Optional. Use when defining runtime settings for a group with a Selenium script. JREPath: Optional field (string). Use the specified JDK during replay. ClassPath: Optional field (string). Enables you to specify the location of additional classes that were not included in the Classpath variable, which may be needed to run Java applications and ensure proper replay. TestNgFiles: Optional field (string). Enables you to specify the location of TestNG related XML or JSON files that describe the structure of the test. Only the entry point XMLs or JSONs are needed to be specified, separated by a semicolon (";"). The referenced XMLs or JSONs will be picked up automatically. See Examples:.
ThinkTime | Optional: The ThinkTime `Type` attribute is one of: Type="ignore" Type="replay" Type="modify" Type="random" Restrictions by type: 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. Note: When creating a new test with a DevWeb script using a REST API and you provide Runtime Setting values, the script's Runtime Settings for this group are used instead of those provided in the body of the REST API request.

Note: Runtime settings data provided in the request overrides the data in the system. For group RTS, only a few values (Pacing, Log, and ThinkTime) are displayed via the REST request. All remaining runtime settings are reset to the script's default settings.

Examples:

Copy code
XML example runtime settings:

    <RTS>
        <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>

Copy code
JSON example runtime settings:

    {
        "Pacing": {
            "NumberOfIterations": 2,
            "StartNewIteration": {
                "Type": "fixed interval",
                "DelayOfSeconds": 20.0
            }
        },
        "ThinkTime": {
            "Type": "random",
            "MinPercentage": 50,
            "MaxPercentage": 150,
            "LimitThinkTimeSeconds": 10
        },
        "Log": {
            "Type": "extended",
            "ParametersSubstituion": true,
            "DataReturnedByServer": true,
            "AdvanceTrace": true,
            "LogOptions": {
                "Type": "on error",
                "CacheSize": 4
            }
        },
        "Name": null,
        "JavaVM": null,
        "JMeter": null,
        "Selenium": null
    }

Copy code
XML example runtime settings for a JMeter script for versions 2021 and later:

    <RTS>
         <Pacing>...</Pacing>
         <ThinkTime Type="random">...</ThinkTime>
         <JMeter>
              <JREPath>c:\abc</JREPath>
              <AdditionalParameters>zxc</AdditionalParameters>
         </JMeter>
    </RTS>

Copy code
JSON example runtime settings for a JMeter script for versions 2021 and later:

    {
        "Pacing": null,
        "ThinkTime": null,
        "Log": null,
        "Name": null,
        "JavaVM": null,
        "JMeter": {
            "JREPath": "c:\\abc",
            "AdditionalParameters": "zxc"
        },
        "Selenium": null
    }

Copy code
XML example runtime settings for a JMeter script for 2020-2020 SP3 only:

    <RTS>
        <JMeter>
            <StartMeasurements>true</StartMeasurements>
            <JMeterHomePath>Some Path</JMeterHomePath>
            <JMeterUseDefaultPort>false</JMeterUseDefaultPort>
            <JMeterMinPort>2000</JMeterMinPort>
            <JMeterMaxPort>3000</JMeterMaxPort>
         </JMeter>
    </RTS>

Copy code
JSON example runtime settings for a JMeter script for 2020-2020 SP3 only:

    {
        "JMeter": {
          "StartMeasurements": true,
          "JMeterHomePath": "Some Path",
          "JMeterUseDefaultPort": false,
          "JMeterMinPort": 2000,
          "JMeterMaxPort": 3000
        }
    }

Copy code
XML example runtime settings for a Java protocol:

    <RTS>
         <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>

Copy code
JSON example runtime settings for a Java protocol:

    {
        "Pacing": {
            "NumberOfIterations": 1,
            "StartNewIteration": {
                "Type": "immediately"
            }
        },
        "ThinkTime": {
            "Type": "random",
            "MinPercentage": 50,
            "MaxPercentage": 150
        },
        "Log": {
            "Type": "extended",
            "ParametersSubstituion": false,
            "DataReturnedByServer": false,
            "AdvanceTrace": false,
            "LogOptions": {
                "Type": "always"
            }
        },
        "Name": null,
        "JavaVM": {
            "JavaEnvClassPaths": [
                ".\\java-aut-1.0.jar"
            ],
            "UserSpecifiedJdk": true,
            "JdkHome": "v:\\environ\\32\\jdk1.8",
            "JavaVmParameters": "some_parameters_here",
            "UseXboot": true,
            "EnableClassLoaderPerVuser": false
        },
        "JMeter": null,
        "Selenium": null
    }

Copy code
XML example runtime settings for a Selenium script:

    <RTS>
        <Pacing>...</Pacing>
        <ThinkTime Type="random">...</ThinkTime>
        <Selenium>
            <JREPath>C:\java\jdk</JREPath>
            <ClassPath>myclasspath.jar</ClassPath>
            <TestNgFiles>testng.xml</TestNgFiles>
        </Selenium>
    </RTS>

Copy code
JSON example runtime settings for a Selenium script:

    {
        "Pacing": null,
        "ThinkTime": null,
        "Log": null,
        "Name": null,
        "JavaVM": null,
        "JMeter": null,
        "Selenium": {
            "JREPath": "C:\\java\\jdk",
            "ClassPath": "myclasspath.jar",
            "TestNgFiles": "testng.xml"
        }
    }

See also:

- Group runtime settings
- Create a test

Tips to improve your search results... OpenText™ Enterprise Performance Engineering API Reference OpenText™ Enterprise Performance Engineering All View Local Help Center View Online Help Center(Undefined variable: _rscC_Basic_Variables.VersionLabel)