Share this page

# lr_start_cross_vuser_transaction

Initiates a transaction that is closed in one or more vusers other than the initiating vuser.

## C Language

    int lr_start_cross_vuser_transaction( char *transaction_name, char *trans_id_param);

Example: lr_start_cross_vuser_transaction | Transaction Functions

## Arguments

Name | Comments
--- | ---
transaction_name | The name of the cross-Vuser transaction.
trans_id_param | The parameter that contains the string ID of the transaction. The string can be any value. The exact same value is used by lr_end_cross_vuser_transaction to identify the transaction

Invoke lr_start_cross_vuser_transaction to indicate the start of a transaction that will be closed in one or more vusers other that the initiating vuser. lr_start_cross_vuser_transaction is invoked by the vuser that initiates an event that will be detected by another vusers, such as sending a message. The recipient vusers invoke lr_end_cross_vuser_transaction to indicate that the expected event occurred or failed.

If the transaction ID identifier parameter value is longer than 16 bytes, or contains a null character (0x00), the value is replaced with the equivalent MD5 hash value.

lr_start_cross_vuser_transaction is not recorded. You can add it to the script manually.

## Return Values

This function returns zero on success, -1 on failure, TRANSACTION_MSGS_EMPTY_START_TRANSACTION_STRING if the transaction name is not specified, or TRANSACTION_MSGS_EMPTY_IDENTIFIER_DATA if transaction_id_param is empty.

## Parameterization

All input arguments can be parameterized using standard parameterization. The *transaction_id_param argument is always passed using standard parameterization.

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