JMeter – Recycle On EOF? Usage In CSV Data Set Config

Recycle On EOF? is one of the multiple parameters of the CSV Data Set Config configuration element in JMeter. CSV Data Set Config is a config element of Apache JMeter, and you can use it in your software load test plan if you want to read data from a CSV file. You can read more about CSV Data Set Config if you want to know how it works and when to use it in your software load test plan. Here we will learn about the usage of the Recycle On EOF? JMeter parameter.

Use Of Recycle On EOF? Jmeter

Recycle On EOF? flag allows you to set your preference to read/don’t read data from the beginning of the file once it reaches on end of the file. If set to true, it will read data from the beginning of the file once reaches on end of the file. Else it will stop reading data from the file once it reaches on end of the file.

Example On Usage Of Recycle On EOF? in JMeter

We will use the same CSV Data Set Config.JMX software load test example and Test.csv file to see the actual usage of the Recycle On EOF? parameter in CSV Data Set Config.

You can see there are only 5 rows of data in Test.csv file.

Example csv data for recycle on eof
Example CSV data. Image by Author.

And thread group has Loop Count = 15 and Number of Threads = 1.

(Note: In this case, it will work the same for Loop Count = 1 and Number of Threads = 15)

recycle on eof loop count
Recycle on eof loop count. Image by Author.

Now set JMeter Recycle On EOF? = False.

set Recycle On EOF false
set Recycle On EOF false. Image by Author.

In this configuration, the Thread will read and get data from csv file for 1st 5 loop counts only. When the thread enters in 6th loop count, It will not get data from csv file as we have set Recycle On EOF? = False. It will show the message EOF. View the result in the tree data for the 5th and 6th debug sampler will look like below.

5th debug sampler result :

result on recycle on eof false
result on recycle on eof false. Image by Author.

6th debug sampler result :

eof result on recycle on eof false
eof result on recycle on eof false. Image by Author.

Now, if you set Recycle On EOF? = True and run your test, the 6th sampler’s result will look like below.

set Recycle On EOF true
set Recycle On EOF true. Image by Author.
result on set Recycle On EOF true
result on set Recycle On EOF true. Image by Author.

The thread will get data from the beginning(1st row of the CSV file) of the file once it reaches EOF if set Recycle On EOF? = True in JMeter. You can set it as per your requirement in the software load test plan.

Leave a Reply

Your email address will not be published. Required fields are marked *