Share this page

# Start Recording dialog box

This dialog box enables you to record your business process.

Item | Description
--- | ---
To access | Record button Note: For some scripts, this button is the Design Script button. See the relevant protocol reference pages for information on using the design script options.
Important information | This dialog box is dynamic and changes according to the options you select and the protocol you are using. To see all the available options, click the More Options button in the top right of the dialog box. To see only the basic options, click Fewer Options.

User interface elements are described below:

### Options for recording most protocols

For most protocols, the Start Recording dialog box contains some or all of the options below.

- For options specific to the Java Record Replay protocol, see Java Record Replay protocol.

- For options specific to the Kafka protocol, see Kafka protocol.

- For options specific to the DevWeb protocol, see Recording DevWeb protocol scripts.

UI Element | Description
--- | ---
Record into action | The section of the script into which you want to record. You can choose one of the built-in action sections: vuser_init (for initialization steps), Action (for repeatable steps), or vuser_end (for sign off steps). If you want to record into an existing action, select it in the dropdown list. Note: For some protocols, for example, Java protocols, this field displays the only available option, for example, Actions. For some protocols, for example Web - HTTP/HTML, you can add an action to the script from here. Type the action name in the Record into action field and click the Add button . The new action is added to the script.
Record | Select the mode to use to record your business process. Possible options include: Web Browser. For example, Web and Oracle NCA protocols record web applications. Note: Recording intranet sites may not work with Microsoft Edge. For information on the workaround for this, see the troubleshooting entry for Recording on Microsoft Edge. Windows Application. For example, the Windows Socket protocol records Windows applications. Remote Application via Proxy. (For Internet protocols only) Enables the recording of traffic when VuGen cannot run on the client machine, for example, Linux machines, Mac OS machines, and mobile devices. For details on additional options for this mode, see Remote Application via Proxy mode. Captured Traffic File Analysis. Enables the generation of an executable Vuser script from a captured traffic file. For details on additional options for this mode, see Captured Traffic File Analysis mode.
Application | Web Browser recording mode: In the Application field, select one of the browsers detected on the machine, or browse to the required browser. Use private mode: This option is selected by default. Clear the check box if you do not want to open the browser window in private mode. Note: The Use private mode option is not supported when using Microsoft Internet Explorer browser. Windows Application recording mode: Specify the path of an executable file, or browse to the application. Note: To run a batch file (a file with a .bat extension), specify `cmd.exe` with its path as the Application, and the batch file as the Program arguments.
Program arguments | The command line arguments for the executable file specified in Recorded application. For example, if you specify `plus32.exe` (recorded application) with the command line options `peter@neptune`, it connects the user `Peter` to the server `Neptune` when starting `plus32.exe`.
URL address | The starting URL address.
Listening IP | Select the IP for the required listening connection, if you do not want to use Default. This may be required if the default network interface is blocked in your environment, for example, due to security policies. Note: The Listening IP option is supported for hook-based recording only.
Start Recording setting (For Internet protocols only) | You can record your business process either: Immediately Recording begins as soon as you click the Start Recording button. In delayed mode Recording does not begin until you start it in the recording toolbar. In the following instances, you may not want to record immediately: You are recording multiple actions, in which case you only need to perform the startup in one action. You want to navigate to a specific point in the application before starting to record. You are recording into an existing script.
Working directory | For applications that require you to specify a working directory. A working directory is necessary only if your application must know the location of the working directory (for example, reading property files or writing log files). For some protocols, the default is the local <installdir>\bin directory.
Recording Options | Opens the Recording Options dialog box. For user interface details, see Recording options.
Start Recording button | Begins immediate recording of your business process actions. When creating a script using a captured traffic file, the button starts the analyzing of your captured file.
Delayed Start button | Opens the target browser or application and the recording toolbar, but does not record your actions until you initiate recording.

### Remote Application via Proxy mode

When the Record mode is set to Remote Application via Proxy, the following additional options are displayed in the Start Recording dialog box.

For more information, see Record using a proxy.

UI Element | Description
--- | ---
Proxy listens on port | The port on which the proxy will listen.
Proxy IP | Enables you to select a specific IP for the proxy to use. Default: All
OpenText Professional Performance Engineering uses network interface | For Network Virtualization, enables you to select a network interface if there is more than one interface defined on the VuGen machine.
Display recording toolbar on client machine | Enables you to interact with the recording toolbar on the client machine.

### Captured Traffic File Analysis mode

When the Record mode is set to Captured Traffic File Analysis, the following additional options are displayed in the Start Recording dialog box.

For more information, see Create a script from a captured traffic file.

UI Element | Description
--- | ---
Captured file | Locate your capture file. The file can be in format .har, .pcap, .cap, or .saz (Fiddler). For details about creating a capture file in a Windows, Linux, or mobile environment, using an external tool such as Wireshark, see Create a PCAP file.
Client side filter | The IP address of the client whose traffic you want to examine. VuGen typically detects the client side filter by analyzing the capture file. Tip: Use the recording options to set a server side filter (Recording > Recording Options > Network > Mapping and Filtering).
SSL Attributes | This option is visible only after you select a .pcap or .saz capture file that contains SSL data and requires a certificate. Provides a list of the SSL attributes for the servers being analyzed. Use the Add, Edit, and Remove buttons to manage the entries. The Add button opens the Add SSL Attribute dialog box, allowing you to add a server and specify its IP address, port, certificate file, and password if required. This list is not available for .har files—instead, configure the SSL through Fiddler.

### Recording DevWeb protocol scripts

The following describes options in the Start Recording dialog box that are specific to recording a DevWeb protocol script. The actual options displayed depend on your selections.

For more information, see Record and replay DevWeb scripts in VuGen.

UI Element | Description
--- | ---
Record into action | Displays the only available option, Main.
Record | Select the mode to use to record your business process: Web Browser via DevWeb Proxy. Enables you to records events on the local machine into a HAR file, using the DevWeb Proxy Recorder. An executable DevWeb script is then automatically generated from the HAR file. Remote Application via DevWeb Proxy. Enables you to records events on a remote machine into a HAR file, using the DevWeb Proxy Recorder. An executable DevWeb script is then automatically generated from the HAR file. Captured Traffic File Analysis. Enables the generation of a DevWeb Vuser script from an existing HAR file.
DevWeb Proxy listens on port | Displays the default port. Change as relevant.
DevWeb Proxy IP | Leave blank to use the default value, or select an option from the dropdown list.
Captured file | Browse to the HAR file location, or enter the path to the file.
Level | Select the required script level, to generate a URL-based script, or pages with a resource-based script.

### Java Record Replay protocol

The following describes options in the Start Recording dialog box that are specific to recording a Java Record Replay protocol script. The actual options displayed depend on your selections.

For more information, see Java Record Replay protocol.

UI Element | Description
--- | ---
Record | Java applet to record a Java applet through the applet viewer. Java application to record a Java application. Internet Explorer to record an applet within a browser. Executable/Batch to record an applet or application that is launched from within a batch file or the name of an executable file. Listener to instruct VuGen to wait for the batch file that initializes the configuration and runs an application before recording. This mode requires you to define the system variable _JAVA_OPTIONS as -agentlib:jdhook.
URL address | The URL to start recording (for Internet Explorer recordings).
Parameters | Any additional parameters that your application requires.
Main Class | The complete path of the Java class with the main method. Note: This option is only present for Java Application type applications.
Applet path | This option is only present for Java applets.
Internet Explorer path | This option is only present for Internet Explorer type applications.
Executable\Batch | This option is only present for Executable\Batch type applications. Note: The executable's jar file must be unzipped.

### Kafka protocol

The following describes the options in the Start Recording dialog box that are specific to recording a Kafka protocol script.

For more information, see Record a Kafka script.

UI Element | Description
--- | ---
Configuration | The configuration file that defines the properties of the Kafka consumer.
Topics | The list of Kafka topics to which the consumer will subscribe. Consumers can subscribe to a topic in order to process the stream of events produced to the topic. Add. Adds a new line to the list in which to enter a topic. Remove. Removes the selected topic from the list. Clear. Clears all topics from the list.

## See also

- Vuser script sections

https://admhelp.microfocus.com VuGen,Professional Performance Engineering,Performance Engineering for Developers 8942
Tips to improve your search results... OpenText™ Virtual User Generator Help Center OpenText™ VuGen Help 26.1-26.3 All View Local Help Center View Online Help Center Version: