Configure runtime settings

This topic describes how to access and configure the available runtime settings.

Note: Runtime settings for a script can also be modified in Controller, after adding the script to a scenario. The changes apply for the scenario run only, and do not affect the runtime settings of the original script file. For details, see View/Modify scripts in the scenario in the LoadRunner Professional help center (select the relevant version).

Navigate and configure the runtime settings

To open the runtime settings, select Replay > Runtime Settings in the VuGen toolbar, or press the F4 shortcut key.

For an overview of the runtime settings views (pages), see Runtime setting view descriptions below. Descriptions of the individual runtime settings are available within the runtime settings views, in the Hint box. To view a hint, hover the mouse over a runtime setting field name.

Tip: If the Hint box is not displayed, click the Hint button located on the bottom-right of the pane.

Value validation

If you enter an illegal value into one of the runtime settings, an error message appears in red below the setting. In addition, an error icon appears beside the name of the relevant node.

Revert to default settings

To revert to the default runtime settings, navigate to the relevant runtime settings node and click the Use Defaults button. Only the defaults for the displayed node are changed. If you want to revert to the default settings for all runtime settings, you must repeat this process for each runtime settings node.

Runtime setting view descriptions

The runtime setting views (pages) that you see depend on the specific protocol that you are currently working with. The following list provides an overview of the possible pages.

View (page) Description
.NET Environment Runtime settings for .NET Vuser scripts.
Additional Attributes Additional arguments for a Vuser script. The Additional Attributes settings apply to all Vuser script types. You specify command line arguments that you can retrieve at a later point during the test run, using Command Line Parsing functions. Using this view, you can pass external parameters to prepared scripts.
Browser Emulation Browser-related runtime settings.
Browser (TruClient - Web)

TruClient browser settings, for scripts that you run in load mode.

Additional information:

  • Settings that you modify in this view only affect TruClient Vusers in load mode.
  • These settings correspond to those in the Browser Settings tab in the TruClient General Settings dialog box. However, the settings that you modify in the TruClient General Settings dialog box affect interactive mode only. For more details, see Configure TruClient General Settings.
  • When you save your script in interactive mode, the settings that you modified in the Browser Settings tab are applied to these Load runtime settings.
Citrix Configuration Citrix configuration runtime settings.
Citrix Synchronization Citrix synchronization runtime settings.

The location of additional classes that were not included in the system's classpath environment variable. You may need these classes to run Java applications and ensure proper replay.

Tip: you can specify a complete folder using an asterisk (*) as a wildcard.

Client Emulation Oracle NCA runtime settings.
Content Check

Content check for websites during runtime. You can set Content Check runtime settings for Web - HTTP/HTML and other Internet protocols.

Additional information:

You use the Content Check settings to check the contents of a page for a specific string. This is useful for detecting non-standard errors. In normal operations, when your application server fails, the browser displays a generic HTTP error page indicating the nature of the error. The standard error pages are recognized by VuGen and treated as errors, causing the script to fail. Some application servers, however, issue their own error pages that are not detected by VuGen as error pages. The page is sent by the server and it contains a formatted text string, stating that an error occurred.

For example, suppose that your application issues a custom page when an error occurs, containing the text ASP Error. You instruct VuGen to look for this text on all returned pages. When VuGen detects this string, it fails the replay.

Note: VuGen searches the body of the pages—not the headers.

DevWeb Settings Runtime settings for DevWeb scripts. For details, see DevWeb runtime settings.
DFE Chain Configuration Enables Data Format Extensions during replay.
DFE Advanced For Vuser scripts using DFE with GWT-DFE or Java to XML, this option lets you define the JRE properties. You can indicate whether to use internal logic to locate the machine's JDK or JRE, or to use a specific external JRE.
Dotnet Settings Setting to work with .NET for a .NET+ Vuser script.
Download Filters Download filters for a script.
Java VM

Java VM runtime settings.

Additional information:

When the Performance > Skip automatic parameter evaluation option is enabled, the script does not evaluate strings containing the format "<text>". Enable this option to improve performance of scripts that contain XML tags.

JMS Advanced JMS advanced runtime settings.
Local References List of local DLL packages for .NET.
Log Configure the amount and types of information that are recorded in the log.
Log (TruClient) Configure the amount and types of information that are reported to a log for TruClient scripts.

Miscellaneous runtime settings.

Automatic transactions are not relevant for Application Performance Management.


  • It is not recommended to enable both the Continue on Error and Generate Snapshot on Error options in a load test environment. This configuration may adversely affect Vuser performance.

  • For considerations on whether to run a Vuser as a process or thread, see Run a Vuser as a process or thread.

Mobile Device Mobile device properties when recording a TruClient - Mobile Web script.
MQTT Configuration Various MQTT runtime settings, some of which are used as the default values for arguments in the script.
Other Settings (TruClient) Snapshot generation and action on error for TruClient.
Package References

List of .NET NuGet packages for referenced DLLs.

Pacing Control the time between iterations. The pace tells the Vuser how long to wait between iterations of your actions.

Various Internet-related runtime settings.

For information about the Internet Preferences runtime settings, see Preferences view - Internet protocol.


Proxy server connection settings.

If you select the option to use the default HTTP proxy settings:

  • When running on Windows, the default browser proxy settings are used.

    To use this option, your default browser cannot be Firefox.  If it is, uninstall Firefox and then select another default browser.

  • When running on Linux, these proxy values in the HTTP_PROXY or HTTPS_PROXY environment variables are used.

    You must manually create these environment variables on the Linux computer where your script runs.


The password entered here is encrypted using a shared key included in the VuGen installation. If you change the shared key using the Network and Security manager (lr_agent_settings command line tool), you must re-enter the password here. For details, see Network and Security Manager in the LoadRunner Professional help center.

RDP Advanced

RDP advanced runtime settings.

Tip: To conserve system resources on the remote desktop server. disable the options that are not essential for your test.

RDP Agent

RDP Agent runtime settings.

Tip: For the RDP agent log folder option—if no folder is specified and the agent log destination was set to File, the log is saved in the temp folder of the user on the server.

RDP Configuration RDP configuration runtime settings.
RDP Synchronization RDP synchronization runtime settings.
Replay (TruClient) Runtime settings for replay of TruClient scripts.

RTE runtime settings.

You can use the TE_typing_style function to override the Delay settings for a portion of a Vuser script.

Tip: In the Delay before typing option, the delay settings determine how Vusers execute TE_type functions.

  • First key. Specifies the time (in milliseconds) that a Vuser waits before entering the first character of a string.
  • Subsequent keys. Specifies the time (in milliseconds) that a Vuser waits between submitting successive characters.
Run Logic

Run logic runtime settings. In this section, you set the number of iterations for your actions and create blocks of actions.

Use the Insert dropdown to add blocks and sections (initialization, action or finalization) to the run logic. For details, see Vuser script sections.

  • Select a run and indicate whether to run its blocks in sequential or random order.

  • Select a block and indicate whether to run its sections in sequential or random order.

By default, when applying random mode, VuGen gives an equal weight to each block. To edit the weight, click on the number and type in your new value. Make sure that the total sum of the weights equals 100 %.

Note: When defining random run logic, the blocks or actions in a blocks are run with a probability of the percentages defined and not exactly as defined.

In the following example, during the 10 iterations, Block1 and Block2 will run with a probability of 70% and 30% respectively, but not necessarily 7 and 3 times.


SAP GUI > General

SAP GUI runtime settings.

Performance settings:

  • Show SAP Client during replay. This option shows an animation of the actions in the SAP client during replay. The benefit of this, is that you can closely follow the actions of the Vuser and see how the forms are filled out. This option, however, requires additional resources and may affect the performance of your load test.
  • Create snapshots during replay. Captures both ActiveScreen snapshots and regular snapshots while a script runs.

    ActiveScreen snapshots contain control ID information for all active objects. ActiveScreen snapshots differ from regular snapshots in that ActiveScreen snapshots allow you to see which objects were recognized by VuGen in the SAP GUI client. As you move your mouse across an ActiveScreen snapshot, VuGen highlights the detected objects. You can then add new steps to the script directly from within the snapshot. ActiveScreen snapshots also enable you to add steps interactively from within the snapshot for a specific object. For more information, see Enhance SAP GUI scripts.

    Note: Disabling replay snapshots may improve the script replay speed and save storage space.

Server (TruClient Native Mobile) The server from which you want to collect data and credentials.
Shared DLLs

Modify the list of shared DLLs after you record a Vuser script.

If a DLL is included in the list of shared DLLs, when the Vuser script is run and requires a particular DLL, the Vuser accesses the DLL in its shared location – the DLL is not copied to the load generator. Adding a DLL to the list of shared DLLs therefore saves hard-drive space on the load generator when a Vuser runs.

Silverlight Services View the WSDL files associated with your script and modify their settings for the replay phase.
Speed Simulation Bandwidth runtime settings.
Speed Simulation(TruClient) Bandwidth for the TruClient Web and Mobile Web protocols.
Think Time Think time settings, controlling the time that a Vuser waits between actions. These settings are designed to help you emulate a real user.

Back to top