Starts a transaction instance.

C Language

long lr_start_transaction_instance( char *transaction_name, long handle );
Example: lr_start_transaction_instanceTransaction Functions


transaction_name The name of the transaction.
handle The parent transaction's handle. A value of 0 instructs VuGen to create a new parent transaction.

The lr_start_transaction_instance function marks the beginning of a transaction instance. A transaction instance is an occurrence of a transaction with transaction_name. Instances are identified by their handle which distinguishes them from other instances of the same transaction.

This function enables multiple instances of a transaction to be created. Use transaction instances when the same transaction is required to be performed under different circumstances and an analysis of each circumstance is required.

By passing the handle of a parent transaction instance, the new instance will be considered a sub-transaction instance of the parent. Pass zero as the handle if there is no parent. For more information on sub-transactions, see lr_start_sub_transaction.

The function returns the handle of the transaction instance which identifies the instance. Note that each lr_start_transaction_instance statement must be matched with an lr_end_transaction_instance statement or it will be interpreted as an illegal command.

Note: For information on allowed characters and maximum length for transaction names, see Transaction guidelines in the Virtual User Generator Help Center (select the relevant version).

Return Values

This function returns a unique long number which identifies the specific transaction instance. On error, a negative number is returned.


All string arguments (char type) can be parameterized using standard parameterization.