lr.advance_param

Advances to the next available parameter value.

int lr.advance_param( String parameter );

String and Parameter Functions

Java Syntax

Arguments

Name	Comments
param	The name of the parameter in quotes (no brackets).

The lr.advance_param function causes the script to use the next available value of the parameter. If you are running multiple iterations, you can specify in the parameter properties to advance automatically to the next value for each iteration. Use this function within an iteration to advance to the next value.

The effect on other parameters in the same data file depends on the settings in the Vuser parameter list dialog.

This function is not recorded—you insert it manually into your script.

Return Values

This function returns 0 on success and -1 on failure.

Parameterization

Parameterization is not applicable to this function.

Example

In the following example, Stock is a parameter defined in the Parameter list. The lr.advance_param function advances to the next value in the parameter file.

lr.output_message("Track Stock: " + lr.eval_string("<STOCK>")); for(int i=0; i<3; i++) { int j = lr.advance_param("STOCK"); lr.output_message("Track Stock: " + lr.eval_string("<STOCK>")); }

The Stock.dat file has the following values:

    STOCK

    MERQ

    IBM

    MSFT

Output:
    Track Stock: MERQ
    Track Stock: IBM
    Track Stock: MSFT