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.
- 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.
Search the runtime settings
Use the Search feature to search for a runtime setting by its name.
To search for a runtime setting:
- In the Runtime Settings pane, click the Search button.
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.
- Click the up and down arrows to browse through the results.
- Click to clear the search.
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.
|.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.
|Citrix Configuration||Enables you to set the Citrix configuration runtime settings.|
|Citrix Synchronization||Enables you to set the Citrix synchronization runtime settings.|
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.|
Enables you to check websites for content during runtime. You can set Content Check runtime settings for Web - HTTP/HTML and other Internet protocols.
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.|
Enables you to set miscellaneous runtime settings.
Automatic transactions are not relevant for Application Performance Management.
|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.|
Enables you to set various Internet-related runtime settings.
For information about the Internet Preferences runtime settings, see Preferences view - Internet protocol.
Enables you to set the proxy server connection settings.
If you select the option to use the default HTTP proxy settings:
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.
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.|
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.
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.
|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.|
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.
Revert runtime settings to the default settings
In the Solution Explorer pane, select the runtime settings node of the script to be changed and navigate to the required setting.
Click the Use Defaults button.
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.