Scribd
Upload
364 views

Load Runner Functions

The document lists various general API functions that can be used in ANSI C LoadRunner Vuser scripts to enhance functionality. It includes transaction functions for marking transactions, command line parsing functions for retrieving variables, informational functions for recording data and getting host names, string functions for manipulating strings, message functions for sending messages, and run-time functions for controlling script execution.

Uploaded by

Sudarshan Rao Adimulam
Copyright
© Attribution Non-Commercial (BY-NC)
Available Formats
Download as DOC, PDF, TXT or read online on Scribd
364 views

Load Runner Functions

The document lists various general API functions that can be used in ANSI C LoadRunner Vuser scripts to enhance functionality. It includes transaction functions for marking transactions, command line parsing functions for retrieving variables, informational functions for recording data and getting host names, string functions for manipulating strings, message functions for sending messages, and run-time functions for controlling script execution.

Uploaded by

Sudarshan Rao Adimulam
Copyright
© Attribution Non-Commercial (BY-NC)
Available Formats
Download as DOC, PDF, TXT or read online on Scribd
You are on page 1/ 4

In LoadRunner, 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. As per my knowledge, below is a list of general API functions for ANSI C scripts. It includes all protocols except for Java, VB, and GUI: TRANSACTION FUNCTIONS 1. LR_END_SUB_TRANSACTION Marks the end of a sub-transaction for performance analysis. 2. LR_END_TRANSACTION Marks the end of a transaction. 3. LR_END_TRANSACTION_INSTANCE Marks the end of a transaction instance for performance analysis. 4. LR_FAIL_TRANS_WITH_ERROR Sets the status of open transactions to LR_FAIL and sends an error message. 5. LR_GET_TRANS_INSTANCE_DURATION Gets the duration of a transaction instance specified by its handle. 6. LR_GET_TRANS_INSTANCE_WASTED_TIME Gets the wasted time of a transaction instance by its handle. 7. LR_GET_TRANSACTION_DURATION Gets the duration of a transaction by its name. 8. LR_GET_TRANSACTION_THINK_TIME Gets the think time of a transaction by its name. 9. LR_GET_TRANSACTION_WASTED_TIME Gets the wasted time of a transaction by its name. 10. LR_RESUME_TRANSACTION Resumes collecting transaction data for performance analysis. 11. LR_RESUME_TRANSACTION_INSTANCE Resumes collecting transaction instance data for performance analysis. 12. LR_SET_TRANSACTION_INSTANCE_STATUS Sets the status of a transaction instance. 13. LR_SET_TRANSACTION_STATUS Sets the status of open transactions. 14. LR_SET_TRANSACTION_STATUS_BY_NAME Sets the status of a transaction. 15. LR_START_SUB_TRANSACTION Marks the beginning of a subtransaction. 16. LR_START_TRANSACTION Marks the beginning of a transaction. 17. LR_START_TRANSACTION_INSTANCE Starts a nested transaction specified by its parents

handle. 18. LR_STOP_TRANSACTION Stops the collection of transaction data. 19. LR_STOP_TRANSACTION_INSTANCE Stops collecting data for a transaction specified by its handle. 20. LR_WASTED_TIME Removes wasted time from all open transactions. COMMAND LINE PARSING FUNCTIONS 1. LR_GET_ATTRIB_DOUBLE Retrieves a double type variable used on the script command line. 2. LR_GET_ATTRIB_LONG Retrieves a long type variable used on the script command line. 3. LR_GET_ATTRIB_STRING Retrieves a string used on the script command line. INFORMATIONAL FUNCTIONS 1. LR_USER_DATA_POINT Records a user-defined data sample. 2. LR_WHOAMI Returns information about a Vuser to the Vuser script. Not applicable for Application Management. 3. LR_GET_HOST_NAME Returns the name of the host executing the Vuser script. 4. LR_GET_MASTER_HOST_NAME Returns the name of the machine running the LoadRunner Controller or Tuning Console. Not applicable for Application Management. STRING FUNCTIONS 1. LR_EVAL_STRING Replaces a parameter with its current value. 2. LR_SAVE_STRING Saves a null-terminated string to a parameter. 3. LR_SAVE_VAR Saves a variable length string to a parameter. 4. LR_SAVE_DATETIME Saves the current date and time to a parameter. 5. LR_ADVANCE_PARAM Advances to the next available parameter. 6. LR_DECRYPT Decrypts an encoded string. 7. LR_EVAL_STRING_EXT Retrieves a pointer to a buffer containing parameter data. 8. LR_EVAL_STRING_EXT_FREE Frees the pointer allocated by lr_eval_string_ext. 9. 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.

MESSAGE FUNCTIONS 1. LR_DEBUG_MESSAGE Sends a debug message to the Output window or the Business Process Monitor log files. 2. LR_ERROR_MESSAGE Sends an error message to the Output window or the Business Process Monitor log files. 3. LR_GET_DEBUG_MESSAGE Retrieves the current message class. 4. LR_LOG_MESSAGE Sends a message to a log file. 5. LR_OUTPUT_MESSAGE Sends a message to the Output window or the Business Process Monitor log files. 6. LR_SET_DEBUG_MESSAGE Sets a debug message class. 7. LR_VUSER_STATUS_MESSAGE Generates and prints formatted output to the Controller or Console Vuser status area. Not applicable for Application Management. 8. LR_MESSAGE Sends a message to the Vuser log and Output window or the Business Process Monitor log files. RUN-TIME FUNCTIONS 1. LR_LOAD_DLL Loads an external DLL. 2. LR_PEEK_EVENTS Indicates where a Vuser script can be paused. 3. LR_THINK_TIME Pauses script execution to emulate think timethe time a real user pauses to think between actions. 4. LR_CONTINUE_ON_ERROR Specifies an error handling method. 5. LR_RENDEZVOUS Sets a rendezvous point in a Vuser script. Not applicable for Application Management. INFORMATIONAL FUNCTIONS 1. LR_USER_DATA_POINT Records a user-defined data sample.

2. LR_WHOAMI Returns information about a Vuser to the Vuser script. Not applicable for Application Management tests. 3. LR_GET_HOST_NAME Returns the name of the host executing the Vuser script. 4. LR_GET_MASTER_HOST_NAME Returns the name of the machine running the LoadRunner Controller or Tuning Console. Not applicable for Application Management tests.

Command Line Parsing Functions 1. LR_GET_ATTRIB_DOUBLE Retrieves a double type variable used on the script command line. 2. LR_GET_ATTRIB_LONG Retrieves a long type variable used on the script command line. 3. LR_GET_ATTRIB_STRING Retrieves a string used on the script command line.

You might also like