General > Script Recording Options

Enables you to set the script generation preferences by setting the scripting language and options.

To access
Record > Recording Options > General > Script
Important information

This node is available for specific protocols only. In addition, the list of options differs between protocols.

For a complete list of protocols and their associated nodes, see the Protocol Compatibility Table.

User interface elements are described below:

UI Element Description
Scripting Language

Select the language in which to generate the Vuser script, C or JavaScript. The default is C.

Note: This option is available for Web - HTTP/HTML Vuser scripts only.

Add a comment for each action
Insert informative logging messages before each message invocation (non-C only).
Default value: enabled.
Close all AUT processes when recording stops
Automatically closes all of the AUT's (Application Under Test) processes when VuGen stops recording.
Default value: disabled.
Correlate arrays
Tracks and correlates arrays of all data types, such as string, structures, numbers, and so on.
Default value: enabled.
Correlate large numbers
Correlates long data types such as integers, long integers, 64-bit characters, float, and double.
Default value: disabled.
Correlate simple strings
Correlates simple, non-array strings and phrases.
Default value: disabled.
Correlate small numbers
Correlates short data types such as bytes, characters, and short integers.
Default value: disabled.
Correlate structures
Tracks and correlates complex structures.
Default value: enabled.
Declare primitives as locals
Declares primitive value variables as local variables rather than class variables (C, C#, and .NET only).
Default value: enabled.
Explicit variant declaration
Declares variant types explicitly in order to handle ByRef variants (Visual Basic for Applications only).
Default value: enabled.
Generate fixed think time after end transaction
Adds a fixed think time, in seconds, after the end of each transaction. When you enable this option, you can specify a value for the think time.
Default value: disabled, 3 seconds when enabled.
Generate recorded events log
Generates a log of all events that took place during recording.
Default value: disabled.
Generate think time greater than threshold
Uses a threshold value for think time. If the recorded think time is less than the threshold, VuGen does not generate a think time statement. You also specify the threshold value. The default values is 3—if the think time is less than 3 seconds, VuGen does not generate think time statements. If you disable this option, VuGen will not generate any think times.
Default value: enabled, 3 seconds.
Insert output parameters values
Inserts output parameter values after each call (C, C#, and .NET only).
Default value: disabled.
Insert post-invocation info
Insert informative logging messages after each message invocation (non-C only).
Default value: enabled.
Maximum number of lines in action file
Create a new file if the number of lines in the action exceeds the specified threshold. The default threshold is 60000 lines (C, C#, and .NET only).
Default value: disabled.
Replace long strings with parameter
Save strings exceeding the maximum length to a parameter. This option has an initial maximum length of 100 characters. The parameters and the complete strings are stored in the lr_strings.h file in the script's folder in the following format:
const char <paramName_uniqueID> ="string".
This option allows you to have a more readable script. It does not effect the performance of the script.
Default value: enabled.
Reuse variables for primitive return values
Reuse the same variables for primitives received from method calls. This overrides the Declare primitives as locals setting.
Default value: enabled.
Track processes created as COM local servers
Track the activity of the recorded application if one of its sub-processes was created as a COM local server (C and COM only).
Default value: enabled.
Use full type names
Use the full type name when declaring a new variable (C# and .NET only).
Default value: disabled.
Use helpers for arrays
Use helper functions to extract components in variant arrays (Java and VB Scripting only).
Default value: disabled.
Use helpers for objects
Use helper functions to extract object references from variants when passed as function arguments (Java and VB Scripting only).
Default value: disabled.
Use protected application recording

Use this option if VuGen is unable to record your application. Your application may block access to VuGen, and recording with this option selected may enable access.
Default value: disabled.

Warn me if the application being recorded encounters an error

Selecting this option enables VuGen to prompt you to cancel the recording if the recorded application crashes or if no events are recorded for 3 minutes. If you choose to cancel the recording, no script is generated. In proxy mode, if the recorded application crashes, there is no error message. Instead, a no-events error is displayed after 3 minutes.


Default value: enabled.

Note: This option is available for Web - HTTP/HTML Vuser scripts only.

Back to top