Configure runtime settings

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

Access runtime settings

To open the runtime settings do one of the following:

  • In the Solution Explorer, double-click Runtime Settings
  • Select the menu item Replay > Runtime Settings
  • Press the shortcut key, F4.

Note:  

  • Internet Explorer 11 (or later versions) must be installed to display the runtime settings.
  • 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, by hovering the mouse over a runtime setting field name.

Back to top

Search the runtime settings

Use the Search feature to search for a runtime setting by its name.

To search for a runtime setting:

  1. In the Runtime Settings pane, click the Search button.
  2. In the search bar that opens, enter a search string.

    The search string is highlighted in each instance it was found.

    Note: Search results display only views containing settings with names that match the search criteria. Other views are filtered out.

  3. Click the up and down arrows to browse through the results.
  4. Click to clear the search.

Back to top

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 Enables you to set the runtime settings for .NET Vuser scripts.
Additional Attributes Enables you to provide 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 Enables you to configure the browser related runtime settings.
Browser (TruClient - Web)

Enables you to configure settings for the TruClient browsers, 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 the TruClient Help Center (select the relevant version).
  • 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 Enables you to set the Citrix configuration runtime settings.
Citrix Synchronization Enables you to set the Citrix synchronization runtime settings.
Classpath

Enables you to specify 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: From version 2021 R1, you can specify a complete folder using an asterisk (*) as a wildcard.

Client Emulation Enables you to set the Oracle NCA runtime settings.
Content Check

Enables you to check websites for content 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 Enables you to configure 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.
Download Filters Enables you to set the download filters for a script.
Java VM Enables you to set the Java VM runtime settings.
JMS Advanced Enables you to set the JMS advanced runtime settings.
Log Enables you to configure the amount and types of information that are recorded in the log.
Log (TruClient) Enables you to configure the amount and types of information that are reported to a log for TruClient scripts.
Miscellaneous

Enables you to set miscellaneous runtime settings.

Automatic transactions are not relevant for Application Performance Management.

Tips: 

  • 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 Enables you to select mobile device properties when recording a TruClient - Mobile Web script.
MQTT Configuration Enables you to configure various MQTT runtime settings, some of which are used as the default values for arguments in the script.
Other Settings (TruClient) Enables you to configure snapshot generation and action on error for TruClient.
Pacing Enables you to control the time between iterations. The pace tells the Vuser how long to wait between iterations of your actions.
Preferences

Enables you to set various Internet-related runtime settings.

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

Proxy

Enables you to set the proxy server connection settings.

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

  • When running on Windows, the Internet Explorer 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, the 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.

RDP Advanced

Enables you to set the 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

Enables you to set the 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 Enables you to set the RDP configuration runtime settings.
RDP Synchronization Enables you to set the RDP synchronization runtime settings.
Replay (TruClient) Enables you to set the runtime settings for replay of TruClient scripts.
RTE

Enables you to set the 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

Enables you to set the run logic runtime settings.

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, Block0 and Block1 will run with a probability of 20% and 80% respectively, and not exactly 2 and 8 times.

SAP GUI > General

Enables you to set the 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) Enables you to specify the server from which you want to collect data and the credentials.
Shared DLLs Enables you to 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 will access the DLL in its shared location – the DLL will not be 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 Enables you to view the WSDL files associated with your script and modify their settings for the replay phase.
Speed Simulation Enables you to configure bandwidth runtime settings.
Speed Simulation(TruClient) Enables you to configure bandwidth for the TruClient Web and Mobile Web protocols.
Think Time Enables you to configure the 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

Runtime setting value validation

The Solution Explorer indicates that one or more runtime settings have illegal values, with a warning icon in place of the standard Runtime Setting node icon .

If you enter a value above the maximum allowed value, VuGen automatically substitutes it with the maximum allowed value. If you enter a value below the minimum allowed value, VuGen automatically substitutes it with the minimum allowed value.

A red highlighted value indicates that one of the values in the view is invalid. The following example is invalid because the added filters are identical.

Back to top

Revert runtime settings to the default settings

  1. In the Solution Explorer pane, select the runtime settings node of the script to be changed and navigate to the required setting.

  2. Click the Use Defaults button.

  3. Save the script. Only the defaults for the displayed node are changed. If you want to revert to the default settings for all the runtime settings, you must repeat the above steps for each runtime setting node.

Back to top