Starts a sub-transaction specified by its parent's name.


void   lr.start_sub_transaction( String  sub_transaction, String  parent_transaction );


Sub lr.start_sub_transaction( ByVal sub_transaction As String, ByVal parent_transaction As String )
Example: lr.start_sub_transactionTransaction Functions


sub_transactionThe name of the sub-transaction
parent_transactionThe name of the parent transaction in which the sub-transaction is nested.

The lr.start_sub_transaction function marks the beginning of a sub-transaction. To mark the end of the sub-transaction, use lr.end_sub_transaction. You insert these functions immediately before and after the sub-transaction actions.

Sub-transactions are used for isolating parts of a business process. For example, a sub-transaction "electrical_purchases" may be nested within the larger transaction "purchases." The transaction "purchases" is the parent transaction and "electrical_purchases" the sub-transaction.

Multiple sub-transactions can be nested within a parent transaction. A sub-transaction may also be a parent to a smaller sub–transaction.

The duration of a transaction or sub-transaction is the sum of the durations of all steps between its start and end, including the steps that are included in sub-transactions.

Each lr.start_sub_transaction statement must be matched with an lr.end_sub_transaction statement within the script 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

No value returned.


All string input arguments can be passed using standard parameterization.