Microsoft .NET > Recording - Recording options

This screen enables you to set the recording options for .NET Vuser scripts.

To access
Record > Recording Options > Microsoft .NET > Recording
Important information
This node is available only for specific protocols. For a complete list of protocols and their associated nodes, see Protocol compatibility table.

User interface elements are described below:

UI Element
Description
Code Generation
Allow you to indicate whether to show warnings, a stack trace, or all event subscriptions during code generation.
  • Show Warnings. Shows warning messages that are issued during the code generation process.

  • Show Stack Trace. Shows the recorded stack trace if it is available.

  • Show All Event Subscriptions. Generates code for all event subscriptions that were recorded. If this option is disabled, VuGen generates code only for events in which both the publisher (the object which invokes the event) and the subscriber (the object informed of the event) are included in the filter.

  • Default value: disabled.
Debug Options
Enables you to trace the stack and specify its size.
  • Stack Trace. Traces the contents of the stack for each invocation within the script. It allows you to determine which classes and methods were used by your application. This can be useful in determining which references, namespaces, classes, or methods to include in your filter. Enabling the trace may affect your application's performance during recording.

    Default value: disabled

  • Stack Trace Limit. The maximum number of calls to be stored in the stack. If the number of calls exceeds the limit, VuGen truncates it.

    Default value: 20 calls.

Filters
  • Ignore all assemblies by default. Ignores all assemblies that are not explicitly included by the selected filter. If you disable this option, VuGen looks for a matching filter rule for all assemblies loaded during the recording.

Logging
The Logging options let you set the level of detail that is recorded in the recording log file.
  • Log severity. Sets the level of logging to Errors Only (default), or Debug. The severity setting applies for all the logs that you enable below. You should always use the Errors Only log unless specifically instructed to do otherwise by Software Support, since detailed logging may significantly increase the recording time.

  • Instrumentation Log. Logs messages related to the instrumentation process.

    Default value: enabled.

  • Recording Log. Logs messages issued during recording.

    Default value: enabled.

  • Code Generation Log. Logs messages issued during the code generation stage.

    Default value: enabled.

Remote Objects
For information about this property, see Remote Objects Property.
Serialization
  • Serialization format. The format of the serialization file that VuGen creates while recording a class that supports serialization: Binary, XML, or Both. The advantage of the binary format is that it is more compressed. The advantage of the XML format is that you can manipulate the data.

  • Serialize long arrays. For long arrays containing serializable objects (for example, an array of primitives), use VuGen's serialization mechanism. Enabling this option generates LrReplayUtils.GetSerializedObject calls if the array size is equal to or larger than the Threshold value for long array size.

  • Threshold value for long array size. The minimum size for an array to be serialized if Serialize long arrays is set.

Tip: For XML serialization, you can view the content of the XML file. To view the file, select View XML from the right-click menu.

Back to top

Remote Objects Property

User interface elements are described below:

UI Element
Description
Record in-process objects

Records activity between the client and server when the server is hosted in the same process as the client. Since the actions are not true client/server traffic, it is usually not of interest. When in-process methods are relevant, for example, in certain Enterprise Service applications, you can enable this option to capture them.

Default value: disabled.

Asynchronous calls
Specifies how VuGen should handle asynchronous calls on remote objects and their callback methods
  • Call original callbacks by default. Uses the recorded application's original callback when generating and replaying the script. If the callback method is explicitly excluded by a filter, the callback will be excluded even if you enable this option.

  • Generate asynchronous callbacks. This option defines how VuGen handles callbacks when the original callbacks are not recorded.

For more information, see Asynchronous calls.
WCF duplex binding
  • Generate dummy callback handler. Replaces the original callback in duplex communication with a dummy callback, performing the following actions:

    • Store arguments. When the server calls the handler during replay, it saves the method arguments to a key-value in memory map.

    • Synchronize replay. It stops the script execution until the next response arrives. VuGen places the synchronization at the point that the callback occurred during recording. This is represented in the script by a warning:

  • Generate unique client base address. If your application employs dual HTTP Binding, since HTTP is inherently not a duplex protocol, the framework uses a standard port to receive response data being passed to the callback. When you attempt to run multiple instances of your application, you may be unable to do so using the same port number. This option replaces the original client base address's port number with a unique port.

For background information about WCF duplex binding, see Record WCF duplex communication.

Back to top