Load runner functions
C functions used in Vuser generator:
-----------------------------------------
You can add C Vuser functions to any Vuser script in order to enhance the
script. VuGen generates only a few of the general Vuser functions while you
record. If required, the remaining functions can be manually programmed
into a script.”
The following list shows the general LoadRunner functions for ANSI C
scripts. This includes all protocols except for Java and GUI.
Transaction Functions:
lr_end_transaction Marks the end of a LoadRunner transaction.
lr_resume_transaction Resumes the collection of transaction data.
lr_start_transaction Marks the beginning of a transaction.
lr_start_sub_transaction Marks the beginning of a subtransaction.
lr_stop_transaction Stops the collection of transaction data.
lr_start_transaction_instance Starts a nested transaction specified by its parent’s handle.
lr_end_sub_transaction Marks the end of a sub-transaction for performance analysis.
lr_end_transaction_instance Marks the end of a transaction instance for performance analysis.
lr_stop_transaction_instance Stops collecting data for a transaction specified by its handle.
lr_resume_transaction Resumes collecting transaction data for performance analysis.
lr_resume_transaction_instance Resumes collecting transaction instance data for performance analysis.
lr_wasted_time Removes wasted time from all open transactions.
lr_get_transaction_duration Gets the duration of a transaction by its name.
lr_get_trans_instance_duration Gets the duration of a transaction instance specified by its handle.
lr_get_transaction_think_time Gets the think time of a transaction by its name.
lr_get_transaction_wasted_time Gets the wasted time of a transaction by its name.
lr_get_trans_instance_wasted_time Gets the wasted time of a transaction instance by its handle.
lr_get_trans_instance_wasted_time Gets the wasted time of a transaction instance by its handle.
lr_set_transaction_status Sets the status of open transactions.
lr_set_transaction_instance_status Sets the status of a transaction instance.
Command Line Parsing Functions
String Functions
lr_set_transaction_status_by_name Sets the status of a transaction.
lr_fail_trans_with_error Sets the status of open transactions to
LR_FAIL and sends an error message.
lr_get_attrib_double Retrieves a double type variable used on the script command line.
lr_get_attrib_long Retrieves a long type variable used on the script command line.
lr_get_attrib_string Retrieves a string used on the script command line.
lr_user_data_point Records a user-defined data sample.
lr_whoami Returns information about a Vuser script to the Vuser script.
lr_get_host_name Returns the name of the host executing the Vuser script.
lr_get_master_host_name Returns the name of the machine running the LoadRunner Controller.
lr_eval_string Replaces a parameter with its current value.
lr_save_string Saves a null-terminated string to a parameter.
lr_save_var Saves a variable length string to a parameter.
lr_save_datetime Saves the current date and time to a parameter.
lr _advance_param Advances to the next available parameter.
lr _decrypt Decrypts an encoded string.
lr_eval_string_ext Retrieves a pointer to a buffer containing parameter data.
Message Functions
Run-Time Functions
lr_eval_string_ext_free Frees the pointer allocated by lr_eval_string_ext.
lr_save_searched_string Searches for an occurrence of string in a buffer and saves a portion of the buffer,
relative to the string occurrence, to a parameter.
lr_debug_message Sends a debug message to the Output window.
lr_error_message Sends an error message to the Output window.
lr_get_debug_message Retrieves the current message class.
lr_log_message Sends a message to a log file.
lr_output_message Sends a message to the Output window.
lr_set_debug_message Sets a debug message class.
lr_vuser_status_message Generates and prints formatted output to the Controller Vuser status area.
lr_message Sends a message to the Vuser log and Output window.
lr_load_dll Loads an external DLL.
lr_peek_events Indicates where a Vuser script can be paused.
lr_think_time Pauses script execution to emulate think time—the time a real user pauses to think between actions.
lr_continue_on_error Specifies an error handling method.
lr_rendezvous Sets a rendezvous point in a Vuser script.
