Share this page

# lr_vuser_status_message

Sends a message to the Vuser status area.

    int lr_vuser_status_message( char *format, exp1, exp2,...expn  );

Alphabetical Listing - C Language Utility Functions

## Arguments

Name | Comments
--- | ---
format C Language | A formatted string. If it is a literal string, enclose it with quotation marks. Use the standard Message Formatting that is available for printf to set the format for the expressions you want to print.
exp 1, exp 2,.. exp n C Language | The expressions (variables) to be formatted and printed.
message Object Oriented | A string containing the message to send to the Output window. See Java String Arguments.

The lr_vuser_status_message function sends a string to the Status area of the Controller. It also sends the string to the Vuser log. When run from VuGen, the message is sent to output.txt.

## Return Values

On success, returns the length of the message that was sent. On failure, returns a negative number.

## Parameterization

You cannot use standard parameterization for any arguments in this function.

## Example

In this example, an `Iteration Number` type parameter called "`iteration`" was defined. The lr_vuser_status_message function sends a message indicating the current iteration number.

    lr_vuser_status_message( "We are on iteration #%s", lr_eval_string( "{iteration}" ) );

Tips to improve your search results... VuGen Function Reference Version 26.1-26.3 Function Reference 26.1-26.3 All View Local Help Center View Online Help Center Version: