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.

## Example

The following example shows the opening of several cross transactions.

Copy code

    lr_start_cross_vuser_transaction("cross_trans_1", "{CVTIdentify}");
    lr_start_cross_vuser_transaction("cross_trans_2", "{CVTIdentify}");
    lr_start_cross_vuser_transaction("cross_trans_start_only", "{CVTIdentify}");
    lr_start_cross_vuser_transaction("error_trans", "{CVTIdentify}");

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