Share this page

# lr_start_cross_vuser_transaction

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

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

Alphabetical Listing - C Language Utility 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 26.1 Function Reference 26.1 All View Local Help Center View Online Help Center Version: