Share this page

# Configure runtime settings manually

To configure Vuser runtime settings manually, you modify the default.cfg and default.usp files created with the script.

In this topic:

## Overview

The default.cfg and default.usp files are located in the script folder. The settings detailed below appear in either the default.cfg file or the default.usp file, as follows:

default.cfg | default.usr
--- | ---
General Think Time Log Web (for relevant protocols) | Run Logic Pacing

These runtime settings correspond to VuGen's runtime settings (see Configure runtime settings).

Back to top

## General settings

There is one General setting for Linux Vuser scripts:

ContinueOnError instructs the Vuser to continue when an error occurs. To activate the option, specify 1. To disable the option, specify 0.

In the following example, the Vuser will continue on an error.

    [General]
    ContinueOnError=1

Back to top

## Think Time settings

You can set the Think Time settings to control how the Vuser uses think time when running the script. You set the parameters Options, Factor, LimitFlag, and Limit parameters according to the following chart.

Option | Options | Factor | LimitFlag | Limit
--- | --- | --- | --- | ---
Ignore think time | NOTHINK | N/A | N/A | N/A
Use recorded think time | RECORDED | 1.000 | N/A | N/A
Multiply the recorded think time by... | MULTIPLY | number | N/A | N/A
Use random percentage of recorded think time | RANDOM | range | lowest percentage | upper percentage
Limit the recorded think time to... | RECORDED/ MULTIPLY | number (for MULTIPLY) | 1 | value in seconds

To limit the think time used, set the `LimitFlag` variable to 1 and specify the think time `Limit`, in seconds.

In the following example, the settings tell the Vuser to multiply the recorded think time by a random percentage, ranging from 50 to 150.

    [ThinkTime]
    Options=RANDOM
    Factor=1
    LimitFlag=0
    Limit=0
    ThinkTimeRandomLow=50
    ThinkTimeRandomHigh=150

Back to top

## Log settings

You can set the Log settings to create a brief or detailed log file for the script run.

    [Log]
    LogOptions=LogBrief
    MsgClassData=0
    MsgClassParameters=0
    MsgClassFull=0

You set the parameters LogOptions, MsGClassData, MsgClassParameters, and MsgClassFull variables according to the following chart:

Logging Type | LogOptions | MsgClassData | MsgClassParameters | MsgClassFull
--- | --- | --- | --- | ---
Disable Logging | LogDisabled | N/A | N/A | N/A
Standard Log | LogBrief | N/A | N/A | N/A
Parameter Substitution (only) | LogExtended | 0 | 1 | 0
Data Returned by Server (only) | LogExtended | 1 | 0 | 0
Advanced Trace (only) | LogExtended | 0 | 0 | 1
All | LogExtended | 1 | 1 | 1

In the following example, the settings tell the Vuser to log all data returned by the server and the parameters used for substitution.

    [Log]
    LogOptions=LogExtended
    MsgClassData=1
    MsgClassParameters=1
    MsgClassFull=0

Back to top

## Web settings

In the Web settings, you can specify the following settings.

Bypass HTTP codes

You can set certain HTTP codes to be bypassed if they are received when running the script. If a specified HTTP code is received when the script is run, the HTTP code is bypassed and is not treated as an error.

To specify the HTTP codes you want to bypass, you add ByPassHTTPCode="<HTTP codes>" to the Web section of the default.cfg file. For example, if you want to bypass HTTP codes 403 and 404, add the following line:

ByPassHTTPCode="403,404"

Back to top

## Iterations and run logic

You can set the Iteration settings to perform multiple iterations and control the pacing between the iterations. You can also manually set the order of the actions and their weight. To modify the run logic and iteration properties of a script, you edit the default.usp file.

To instruct the Vuser to perform multiple iterations of the Actions section, set RunLogicNumOfIterations to the appropriate value.

To control the pacing between the iterations, set the RunLogicPaceType variable and its related values, according to the following chart:

Pacing | RunLogicPaceType | Related Variables
--- | --- | ---
As soon as possible | ASAP | N/A
Wait between Iterations for a set time | Const | RunLogicPaceConstTime
Wait between iterations a random time | Random | RunLogicRandomPaceMin, RunLogicRandomPaceMax
Wait after each iteration a set time | ConstAfter | RunLogicPaceConstAfterTime
Wait after each iteration a random time | After | RunLogicAfterPaceMin, RunLogicAfterPaceMax

In the following example, the settings tell the Vuser to perform four iterations, while waiting a random number of seconds between iterations. The range of the random number is from 60 to 90 seconds.

    [RunLogicRunRoot]
    MercIniTreeFather=""
    MercIniTreeSectionName="RunLogicRunRoot"
    RunLogicRunMode="Random"
    RunLogicActionOrder="Action,Action2,Action3"
    RunLogicPaceType="Random"
    RunLogicRandomPaceMax="90.000"
    RunLogicPaceConstTime="40.000"
    RunLogicObjectKind="Group"
    RunLogicAfterPaceMin="50.000"
    Name="Run"
    RunLogicNumOfIterations="4"
    RunLogicActionType="VuserRun"
    RunLogicAfterPaceMax="70.000"
    RunLogicRandomPaceMin="60.000"
    MercIniTreeSons="Action,Action2,Action3"
    RunLogicPaceConstAfterTime="30.000"

Back to top

## Store runtime settings in external files

Since VuGen creates the Vuser script and the Vuser behavior (runtime settings) as two independent sources, you can configure user behavior without directly referencing the Vuser script. This feature lets you make configuration changes to a Vuser and store several profiles for the same Vuser script.

VuGen stores the behavior settings in the default .cfg file. You can save several versions of this file for different user behavior and then run the Vuser script referencing the relevant file.

By default, you cannot control the behavior file from VuGen. VuGen automatically uses the .cfg file with the same name as the script.

To call a specific configuration file, run the Vuser from the command line and add the following string:

    -cfg c:\tmp\<MyCustomConfigFile>.cfg

For information on command line parameters, see Run a Vuser script from a command prompt.

Note: The Linux utility, run_db_vuser, does not support this option.

https://admhelp.microfocus.com VuGen,Professional Performance Engineering,Performance Engineering for Developers 8942
Tips to improve your search results... OpenText™ Virtual User Generator Help Center OpenText™ VuGen Help 25.1-25.3 All View Local Help Center View Online Help Center Version: