Utility Functions and C Language Reference > Utility Functions: C Language (lr_) > Alphabetical Listing > lr_start_cross_vuser_transaction

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.