Beginner’s guide

Different options and their details of RECORDING OPTION of loadrunnervugen 11

At first I describe how to reach up to the recording option then I will explain further.

• Step 1

Open Virtual User Generator from the start

Figure 1: Open Vugen from start (for win7)

• Step 2

Then click on File-> new

Figure 2: Create new script.

• Step 3

Here I have selected web (HTTP/HTML) protocol, after selected it click on Create.

Figure 3: Selecting the protocol

After clicking on Create you get the following page.

Figure 4: After selecting the protocol as Web(HTTP/HTML)

• Step 4

Now to record a script you have to click on Start Recording.

Figure 5: Click on Start Recording

After clicking on Start Recording you will get the Start Recording options which is,

Figure 6: Default Start Recording options

Now I will explain each and every options here. Specially the “Options…” part.

• Application type

There are 2 options of application type, which are,

Figure 7: Options of Application Type

Most of time we use the option Internet Application, When we choose Internet Application the options that we get is

same as Figure 6. But when we select Application type as Win32 App we will get something like below,

Figure 8: Options after choosing Win32 Application

Details of Win32 Applications

Windows Socket Vusers records a Win32 applications. When we want to test a desktop application then we choose

Win32 Application option. Even you will be able to record a simple VB application.

1. Program to record:

You can browse any .exe or.com file in this part. Just make sure that the application you have entered is a Win32

application. Otherwise it won’t work.

2. Program arguments:

Enter the command line arguments for the EXE file specified above; e.g. if we specify "abc32.exe"with the

command line options "genius@xyz", it connects the user Geniusto the server "xyz"when starting

"abc32.exe".

3. Working directory:

Here you just have to provide the specific working directory where you want to work.

4. Record into Action:

Here you just have to select that where you want to record your script whether it is in the Vuser_int or the

Action or in the Vuser_end

Figure 9: Options of Record the application

5. New…

When you click on New..you will get a new small window as below,

Figure 10: Creating new Action

Actually New..is use for creating a new Action, within which the new Scripting will be recorded. After

providing a name to in place of Action2 it will be like,

Figure 11: After creating new action

6. Record The application startup

When we want Vugen to record application startup then we enable the “Record the application startup”. When

we do not want Vugen to record the application startup then we clear the box. If you did not got the clear idea

then may be this example will help you.

At first I am recording a small script while enabling the Record the application startup option. Then the

recorded script will be like figure 12. See that the web_url() function is there.

Figure 12: Script after enabling Record the application startup

Now I am recording the same page with disabling the record the application startup option. When you will

disable this option and start recording then the application will launch but initially you will not get the recording

option. Instead of that you will get Recording Suspended Dialogue box like below.

Figure 13: Recording suspended option.

So until you click on Record in the Recorded Suspended option you can navigate through any page of your AUT

(Application Under Test) but nothing will be recorded. And after clicking on Record and completing your

desired transaction you will get the recording of your desired pages. No startup page will be recorded. The

example is given below in Figure 14. You can understand from the below code that the web_url() function for

the startup of the application is not recorded in the script.

Figure 14: Recorded script after disabling the Record the application startup.

7. Options…

Now if you click on Options..then you will get a window like below.

Figure 15: recording option

This is the exact same window that you will get when you will select Internet Application in the Application

type recording option. I will discuss this Recording options individually later at the time of discussing Internet

Application.

o Details of Internet Application

As I already said that Internet option is mostly used as most of the testers are asked to test a new website which

is about to launch. So when you will select the Application type as Internet Application you will get the options

like below,

Figure 16: Options after choosing Internet Applications

1. Program to record:

Here I have written As “Microsoft Internet Explorer”, or you can browse the path from program file like below,

then also you will get Microsoft Internet Explorer as written in the Program to record section.

Figure 17: Browsing Internet Explorer

2. URL Address:

In this field you have to give the URL that you want to open. You can give www.google.com or anything that

you want. But providing any site here is a risky factor if you are planning to record a script more than one times.

Coz after recording several times the server of that particular website may block you. For that reason Vugen has

a sample application as Web Tours for practice purpose. So here I have given that URL of the Web Tours.

Before working with the HP Webtour Application you have to start the web server.You can start the web server

by following process,

Start->All programs->HP LoadRunner->samples->Web->Start Web Server

Figure 18: Process to Start Web server

After you click on Start Web Server You will get a window like below,

Figure 19: Web Server of Web Tours

Now you have started the Web Server and after you got this window it will then disappear within 2-3 secs. But if

you need to close the server you can't just close it, by click on the cross, coz this command prompt is gone. So if

you want to turn off the server all you have to do is open task manager, then click on the processes and select

xigui32.exe process, then end task. Closing this will stop your web server.

Figure 20: Selecting xigui32.exe fromTask manger

You will get the URL from the below steps,

Start->All programs->HP LoadRunner->samples->Web->HP Web Tour Application

After Clicking on HP Web Tour Application your default browser will open the following,

Figure 21: Opening web Browser

Now just Copy the URL and paste it in URL Address part.

3. Working Directory

Same as Win32 Application

4. Record into Action

Same as Win32 application

5. New

Same as Win32 Application

6. Record the application startup

Same as Win32 Application

7. Options…

In the Recording Options there are 4 general parts which are,

General, Data Format Extension, network, HTTP Properties. Within these options there are different sub-options

also. Here I will discuss all the options and their detailed description.

i. Script

When you click on script we will get a window like Figure 15.

Here the 1st option is Scripting Language, which is for Vugen 11 is by default C. The scripting language for

loadrunner is C. But for the later version like 12.5 you will get C and Java both as options.

Then Comes the Scripting options, where the Properties and their values are given. By default some of the

property options are selected previously as shown in the figure 15. Here I am discussing all the properties in

details

Close all AUT processes when recording stops

Automatically closes all of the AUT's (Application Under Test) processes when VuGen stops recording. Means

checking this automatically closes all of the application that has been opened for recording when VuGen stops

recording

Default value: disabled.

So did you understand the point?? If yes then GOOD. If no then record a small script in web tours while

disabling this option. So after you are completed recording the script and you have hit the stop button to stop the

script from recording you will see that the Web tour is still opened in the browser as you left working with it.

Like this-

Figure 22: Result after disabling the “Close all AUT processes when recording stops”

Here to show the result I have stopped the recording after clicking on flights so in IE browser web tour is opened

as the last transaction which is done.

So now if I enabled it then after recording is completed the browser will automatically close this site.

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.

When you enabled it and provide any specific think time then the result will be something like Figure 24.

Figure 23: Enabling think time as 7 secs

Figure 24: Change in the script after Enabling

Generate recorded events log

Generates a log of all events that took place during recording.

Default value: disabled.

If we enabled it then you will get a recorded event log in the output windows

Figure 25: Recorded event log is shown in the output window

Generate think time greater than threshold

Before understanding this option you have to understand what is think time and threshold. So let’s start with

think time,

Think time: Think time is the time taken by the users to think or to navigate

to different pages in the application. Depending upon the application context, the think time would vary. It's not

advisable to have the default think time for all applications under testing. Example-If after opening any site I had

taken 12 secs to provide my username and password. After providing the username and password I checked

whether the username and password is correct or not. That takes 5 secs more. Then I clicked on the login button

which is my next transaction so my total think time for after opening the site to before login is (12+5)=17 sec.

Think time plays a major role in testing as a real life user. Think time creates a huge impact on the server load.

We need to understand the fact that decreasing the think time will increase the server load & vice versa. Never

forget that we can play around with the server load just by changing the think time. To illustrate, consider the

following example. Five tests were conducted with 5 virtual users simultaneously accessing the application. In

each of the test, the think time is the only metric which was changed.

So from this table you can understand that when think time is less that time server load and CPU usage is more.

Threshold:Threshold level is the level below which the recorded think time will be ignored. So if I enable the

option “Generate think time greater than threshold” and/or change the value, then all the think time within the

script will be ignored. If you are still confused about what I meant as Ignored then come to this given example

below.

Let’s think that you have given it as 30 sec. and recorded a script. So the 1st transaction you have done in 5 sec

2nd

in 10 sec and the last one in 40 sec. So when you will see the recorded script you will find only one think

time there in only one transaction. Guess at which transaction it will be??

Yes. It is only in the 3rd transaction. Let’s see the script that I have recorded here for this example.

Figure 26: When “Generate think time greater than threshold” is 30

I can assure you that there is no other lr_think_time() is there. Now what happens when I change the Generate

think time greater than threshold to 3sec.

Figure 27: Same recorded script after providing think time as 3.

So you understand the difference. I think now you can understand what “Generate think time greater than

threshold” do.

Maximum number of lines in action file

It means that the maximum number of lines VUGen will generate in an action. If the script is larger, VUGen will

automatically create a new action. The default is set to 60,000. The maximum value which can be specified is

65,000. And the minimum value is 5000.

Track Processes created as COM local servers

Before knowing about this option you have to understand what is COM. COM means Component Object Model.

COM is a platform-independent, distributed, object-oriented system for creating binary software components

that can interact. COM objects can be created with a variety of programming languages. Object-oriented

languages, such as C++, provide programming mechanisms that simplify the implementation of COM objects.

These objects can be within a single process, in other processes, even on remote computers. COM is designed to

make it possible to add the support for location transparency that extends across a network. It allows

applications written for single computers to run across a network and provides features that extend these

capabilities and add to the security necessary in a network.

Now as we got a basic idea about COM so we can now move on to COM local Server. A COM client is

whatever code or object gets a pointer to a COM server and uses its services by calling the methods of its

interfaces. A COM server is any object that provides services to clients; these services are in the form of COM

interface implementations that can be called by any client that is able to get a pointer to one of the interfaces on

the server object.

Did you understand about COM server? If not then just remember that COM local server is same as any local

server but here it interacts with the client machine using objects.

So when we enable the option “Track processes created as COM local servers” To let VuGen COM/DCOM

recorder to know about what objects you are interested in recording. The purpose of listing all necessary objects

here in the filtering option is to enable the recorder to read the type information about the object, so that it would

monitor the creation of such objects and all activities done by the objects. Finally, after the recording, the

recorder could generate appropriate script for all the activities trapped.

Now we can move to the next sub-option in General option which is Protocols.

ii. Protocols

Do you know what Protocols is?? If you know then well and good but if don’t then you might be interested in

this next paragraph.

The dictionary meaning of Protocol is agreement, treaty, convention, deal, pact, settlement etc. That means it is

a system of rules agreed by both the parties. So in Information Technology terms Protocol means a uniform set

of rules that enable two devices to connect and transmit data to one another. Protocols determine how data are

transmitted between computing devices and over networks. They define issues such as error control and data

compression methods. The protocol determines the following: type of error checking to be used, data

compression method (if any), how the sending device will indicate that it has finished a message and how the

receiving device will indicate that it has received the message. Internet protocols include TCP/IP (Transfer

Control Protocol/Internet Protocol), HTTP (Hypertext Transfer Protocol), FTP (File Transfer Protocol), and

SMTP (Simple Mail Transfer Protocol).

When you click on protocols you will get options like this below.

Figure 28: List of Protocols under protocols option.

Now you can ask a question that what is the important of this option? You have already selected the protocols

when you are creating the script (refer to figure 3 for understand). See this option will come handy when you are

working with multiple protocols. For example if instead of selecting new single protocol script if I selected new

multiple protocol script before (refer figure 3) then figure 3 will become,

Figure 29: selecting multiple protocols.

Here I have selected only 3 protocols. So now if I go to the Protocols option of Recording option then it will be,

Figure 30: list of active protocols in Protocols list.

Now you can check or uncheck any protocols from here as you required.

Let’s say that you are regenerating the same script but you want some of the specific protocol to be enabled this

time. So you can just check only your specific protocols from here, and you will get your desired regenerated

script.

iii. Recording

This option is one of the most important options of Recording Options. Whenyou open this you will get a

window like below,

Figure 31: Options under General: Recording

There are 2 options, HTML-based script and URL-based script. I will discuss them one by one. But before that

you have to understand why you should go for HTML-based script or URL-based script.

1. HTML based mode does recording as you perform clicks and doesn’t give you inside information like what

is happening behind the recording while URL based mode records each and every step and emulate

Javascript code.

2. HTML mode would have less correlation to do while URL mode has much more complex correlation

requirements.

3. HTML mode is smaller and is more intuitive to read as the statements are inside the functions

corresponding to the user action performed. In the case of URL based, all statements gets recorded into

web_url().

4. HTML mode is recommended for browser applications while URL mode is recommended for non-browser

applications.

5. Don’t get the impression that I am advocating for HTML mode ☺ . URL mode can be of real help when

you want to have control over the resources that need to be or need not to be downloaded, since you have

each and every statement in-front of you.

HTML-based script

When you will click on HTML Advanced… you will get a window like below,

Figure 32: Options under HTML Advanced..

The 1st option is Script type which has another two options. I am discussing each options one by one.

A script describing user actions (e.g. web_link,web_submit_form):

Example: look at the following recorded script which is generated after enabling this option,

Figure 33: Recorded script after enabling “A script describing user actions”

When you check this option and start recording, Vugen generates functions for all the actions done during the

process of recording. Functions are generated corresponding to the actions.

If user open/request a web page web_URL function is generated

If user clicks on any links on the page web_link function is generated.

If user clicks on any image links on the page then web_image is generate.

If user clicks on any submit button on the page then web_submit_form function is generated

A script containing explicit URLs only (e.g. web_url,web_submit_data):

This mode is useful for instances where many links within your site have the same link text. If you recorded

using the first option, it records an instance for the link, but if you record using this option then each link is

listed by its URL. This facilitates parameterization and correlation for that step.

Figure 34: Script recorded using “A script containing explicit URLs only” option

The 2nd option is Non HTML generated elements (e.g. Javascript, VBScript, ActiveX, Applets) type which has

another three options. I am discussing each options one by one.Using this options we can control Non HTML

generated elements.

Record within the current script step:

When this option is enabled new functions are not generated for non-html resources. They become part of

web_url, web_link and web_submit_dataetc functions. These non-HTML resources are indicated by EXTRAS

flag.

Need to be

parameterized

Need to be

correlated

Figure 35: Script recorded after enabling “Record within the current script step”

Record in separate steps and use concurrent groups:

When this option is enabled then all the non-html elements are recorded as new functions. All of the web_url

functions for non-html resources are placed in a concurrent group within web_concurrent_start and

web_concurrent_end.

Non-html

resources

Non html

resources

Figure 36: Script recorded after enabling “Record in separate steps and use concurrent groups”

Do not record:

Enabling this will instruct Vugen not to record any of the non-html resources. In the below image you can see

that none of the non-html resources have been recorded. That means here is no functions related to body_bg.gif

or banner_bg.jpg

Figure 37: Script recorded after enabling “Do not record”

URL-based script

When you will click on URL Advanced you will get a window like below. I will discussed each options now.

Figure 38: Options within Advanced URL

Create concurrent groups for resources after their source HTML page:

This option instructs to record URLs and their resources in concurrent groups. A concurrent group represents

links and resources that are loaded on a page at the same time.

Figure 39(a): all the .aspx requests are in a particular concurrent group

Figure 39(b): All the image(.png/.jpg) and .js(java script) requests are in a particular group

Use web_custom_request only:

This option instruct to record all the contents under web_custom_request function.

Existence

of .aspx

files

Existence of

image and .js

files

Figure 40: Script recorded after enabling “Use web_custom_request only”

If you enable both the option then all the URL and their resources will be recorded in a concurrent group but

under web_custom_request function.

Figure 41: when both the options are enabled.

Under Data Format Extension there are Configuration, Header chain, Body Chain, Cookies Chain, Query String

Chain. At first I will discuss what the work of Configuration option is.

Under the Configuration option you will see options like below,

Recorded under

web_concurrent_re

quest

Figure 42: Configuration option

Enable Data Format Extension enables easier scripting of web applications by providing the ability to decode

and encode formatted data that is exchanged between the client and the server. This enables easier correlation

and parameterization of the generated Vuser scripts.

You may find this following website very useful about this.

http://claudihome.com/html/LR/WebHelp/Content/VuGen/c_web_data_format_extensions.htm

When you record a Vuser script, VuGen records the HTTP requests and responses that are passed between the

client and the web server. The data in these HTTP requests and responses is often encoded. For example, some

of the data may be in binary format. The encoded data may be in the HTTP query string, headers, body, or

cookies. When the encoded data is included in a Vuser script, the resulting script will contain data that is

difficult to decipher. This makes it difficult to identify text strings that can be used for parameterization and

correlation.

The script below (Figure 43) shows a section of a Vuser script that was generated while recording business

processes on a GWT-based application. Notice how some sections of the script contain encoded data and

therefore difficult to decipher.

LoadRunner uses data format extensions (DFEs) to resolve the difficulties that arise from encoded data in Vuser

scripts. DFE support allows easier creation of Vuser scripts by providing the ability to decode the encoded data

that is exchanged between the client and the server. By providing the decoded format of the data, the

information is presented in the Vuser script in a readable format that enables you to correlate and parameterize

the script as required. When the script is replayed, the DFE support re-encodes the modified Vuser script, and

enables the Vuser to send the correctly encoded request to the server.

Figure 43: Example of encoded data that is exchanged between the client and web server

When a DFE is applied to a Vuser script and the script is then regenerated, the DFE modifies the script and

replaces the encoded data with decoded data.

If you want to do it by yourself then here is a list of websites which uses DFE’s of type GWTs (Google web

tookit).

• http://wallet.google.com

• https://www.google.com/flights/

• https://www.google.com/cars

• https://play.google.com/apps/pub...

• https://www.google.com/about/job...

• http://adwords.google.com/

• http://bibale.com/

• http://bookedin.net/

• http://chrome.angrybirds.com/

• http://drawmics.com/

• http://engage.calibreapps.com/

• http://engagiert-in-deutschland.de/

• http://envolve.com/

• http://evernote.com/

• http://ghostnest.com/

• http://netsas.com/

• http://opennetworx.org/

• http://rstudio.org/

• http://seesmic.com/app

• http://www.squidjob.com/

• http://tasktop.com/blog/tasktop/...

• http://vchub.com/

• https://agreedo.com/

• https://apps.facebook.com/friend...

• https://clarityaccounting.com/

• https://google.com/webfonts/v2

Apart from configuration all the other options are not used vastly. So I am skipping then and directly discussing

to the Network. Under the Network option there is only one option which is Port Mapping. Before going into

any details first you have to understand what Port Mapping actually does. If you know what is port then you can

skip the next paragraph, but if you don’t know then you may find this interesting.

A port number is a way to identify a specific process to which an Internet or other network message is to be

forwarded when it arrives at a server. For the Transmission Control Protocol and the User Datagram Protocol, a

port number is a 16-bitinteger that is put in the header appended to a message unit. This port number is passed

logically between client and server transport layers and physically between the transport layer and the Internet

Protocol layer and forwarded on. For example, a request from a client (perhaps on behalf of you at your PC) to a

server on the Internet may request a file be served from that host's File Transfer Protocol (FTP) server or

process. In order to pass your request to the FTP process in the remote server, the Transmission Control Protocol

(TCP) software layer in your computer identifies the port number of 21 (which by convention is associated with

an FTP request) in the 16-bit port number integer that is appended to your request. At the server, the TCP layer

will read the port number of 21 and forward your request to the FTP program at the server.

Examples include:

• 21: File Transfer Protocol (FTP)

• 22: Secure Shell (SSH)

• 23: Telnet remote login service

• 25: Simple Mail Transfer Protocol (SMTP)

• 53: Domain Name System (DNS) service

• 80: Hypertext Transfer Protocol (HTTP) used in the World Wide Web

• 110: Post Office Protocol (POP3)

• 119: Network News Transfer Protocol (NNTP)

• 143: Internet Message Access Protocol (IMAP)

• 161: Simple Network Management Protocol (SNMP)

• 194: Internet Relay Chat (IRC)

• 443: HTTP Secure (HTTPS)

• 465: SMTP Secure (SMTPS)

• 8443: Router remote access

The default setting is Socket Level data. The Socket Level API and WinINet API are two different types of

filters.LoadRunner can record the data on the either/both filters. While not all application use WinInet API, so if

the application does not use WinInet API, the WinInet recording can record nothing. All application will use

WinSock API, so theoretically Socket level data recording should work for all kinds of applications.

Actually this frame should be left intact. If you’re recording a desktop application, then you may have to

choose WinINet level data.Most of the application though communicate at the socket level and the events get

recorded by loadrunner using socket level data capture. But, sometimes the applications are designed to interact

using WinINet API and in such cases we should use WinINet level capture in loadrunner, to capture the events

successfully. So, the use of socket level/WinINet level capture depends on how the application communicates.

Note: The requests might get duplicated if you are using socket level and wininet level data capture and you can

comment the duplicated requests in the script.

Now if you click on Options while selecting the Socket level data then you will get a dialog-box like below,

Figure 44: Options under Socket level data

SSL (Secure Sockets Layer) is the standard security technology for establishing an encrypted link between a

web server and a browser. This link ensures that all data passed between the web server and browsers remain

private and integral. SSL is an industry standard and is used by millions of websites in the protection of their

online transactions with their customers.

Enable auto SSL detection:

Automatically detects SSL communication. Specify the version and default cipher that you want to detect. Note

that this only applies to port mappings that were defined as auto in the Connection type box, or not defined at

all. If a server, port, or server:port combination was defined as either Plain or SSL, then auto SSL detection

does not apply.

Here you can select SSL2/3 (means both SSL2 and SSL 3 is included) SSL 3.x (means both SSL 3.0 and SSL

3.1 will be captured), SSL2.x (means SSL2.0 version), TLS1.x (means any version of TLS1.0, TLS 1.1, TLS 1.2

and TLS 1.3). You can wonder that why there is no SSL1.x. actually SSL1.0 version was never publicly released

because of the serious security flow in the protocol.

TLS means Transport Layer Security which is the new name of SSLs from SSL 3.1. TLS and SSL are protocols

that provide data encryption and authentication between applications and servers in scenarios where that data is

being sent across an insecure network.

A SSL cipher is an encryption algorithm that creates a special certificate, which is used as a key between two

computers on the Internet. This certificate creates a secret encrypted connection between the two networked

computers, which blocks unwanted snooping of shared data.

Enable auto detection of SOCKET based communication

Automatically detects the type of communication. If required, raise the maximum number of transitions, one at a

time until VuGen succeeds in detecting the protocol. You can also gradually increase the maximum buffer size

by 1024 bytes (1 KB) at a time until VuGen succeeds in detecting the protocol. This allows VuGen to review a

larger amount of data in order to find a signature.

Log Level

Sets the logging level for the automatic socket detection.

When you will Click on New Entry you will get a window like below,

Figure 45: Server Entry options

Some applications may use ports that are different from the browser. The default HTTP port is 80 by most

application but this may not be used by the application that you are recording against. In such situation, you may

need to configure Vugen to capture the HTTP traffic by mapping the ports to the service type. The service type

other than HTTP are FTP, Socket, etc depending on your application needs. In this way, Vugen will become a

proxy and capture traffic on the defined port.

To know more about how Server option works please refer to the following link,

http://community.hpe.com/t5/LoadRunner-and-Performance/The-Port-Mapping-dialog-one-dialog-that-does-it-

all/ba-p/6357353

Under HTTP Properties there are two options Advanced and Correlation. When you open Advanced this

window will come,

Figure 46: Options under HTTP:Advanced

I. Reset context for each action

Most of the web applications will have resources (images, shock wave files) and cookies cached when it is

accessed multiple time. Many of the resources will not be requested if it is already cached. If we record the

session without checking this option, Load Runner will not capture the resources. This option is to start the

recording as if it is accessed for the first time.

II. Save snapshot resources locally

Instructs VuGen to save the snapshot resources to files on the local machine. This feature lets the Run-Time

viewer create snapshots more accurately and display them quicker. So in your local machine you will get

some files like below,

Figure 47: Snapshot stored in your local machine

III. Generate web_reg_find functions for page titles

Generates web_reg_find functions for all HTML page titles. VuGen adds the string from the page's title tag

and uses it as an argument for web_reg_find. When you will enable this option your script look like below,

Figure 48: Script after enabling “Generate web_reg_find functions for page titles”

IV. Generate web_reg_find functions for sub-frames

Generates web_reg_find functions for page titles in all sub-frames of the recorded page.

Figure 49: web_reg_find is generated for sub frames

V. Add comment to script for HTTP errors while recording

Adds a comment to the script for each HTTP request error. An error request is defined as one that generated

a server response value of 400 or greater during recording. Server Response values are nothing but the

values of the numeric status code toHTTPrequests, like Bad request 400, Not found 404, Internal Error 500

etc.So after enabling this option your code will look like below,

Figure 50: Recorded script after enabling “Add comment to script for HTTP errors while recording”

VI. Support charset

UTF-8

This instructs VuGen to convert non-ASCII UTF-8 characters to the encoding of your locale's machine in

order to display them properly in VuGen.UTF-8 is a character encoding capable of encoding all possible

characters in Unicode.Unicode is a computingindustry standard for the consistent encoding, representation,

and handling of text expressed in most of the world's writing systems.

EUC-JP

If you are using Japanese Windows, select this option to enable support for Web sites that use EUC-JP

character encoding. This instructs VuGen to convert EUC-JP strings to the encoding of your locale's

machine in order to display them properly in VuGen.

VII. Record script using earlier recording engine

It enables the recording of a script using the earlier recording engine, instead of the standard multi-protocol

engine. It is useful for the next Vuser script.

If you enable this option then when you will create the next vugen script then you will get web_api.h header

included into your init(), action() and end().

Figure 51:web_api.h included

Even your recording option will also look different, like below,

Figure 52:Start Recording option

And the after clicking on options you will get,

Figure 53: Recording option

I am not discussing Headers.. Content Types..and Non-Resources.. as by opening them you can get a clear idea

about them,

The last option is Correlation

If Enable correlation during recording option is enabled and you know all the necessary data about what you

want to correlate then you can correlate them automatically. But if you are a beginner then I will advise you not

to use it now. But for learning purpose you can follow the steps below,

Just click on New Application then give a proper name of the application, then click on new rule and provide the

left and right boundary and all the other necessary information as you need. Here I am only providing the Left

and Right boundary.

Figure 54: Correlation option

Now if you click on Advanced then you will get some more options regarding the correlation, like below. For an

example I am keeping the default setting. And the script will be generated like Figure 56.

Figure 55: Advanced correlation properties

Figure56: Example of automatic correlation

The option Offset and Length in automatic correlation has the same use as the SaveOffset and SaveLen in

manual correlation. In general term we can say if we specify offset as 5 that means the first 5 digit/alphabet

values will be discarded and then rest value will be saved in the parameter. If we specify Length as 10 then from

a given offset value the next 10 digit/alphabet values will be stored in the parameter. In Figure 57 we have

specified offset as 5 and length as 10 in correlation options (automatic correlation).

Figure 57: Script after specifying offset and length.

Note: If you are specifying offset and length then I will suggest you to uncheck the “Replace with parameter

only for exact matches” option. Otherwise automatic correlation will not happen.

-----------------------------------------------------------------X------------------------------------------------------------------