lr.endCrossVuserTransaction

Marks the completion in this vuser of a transaction started by a different vuser.

Transaction Functions

Syntax

lr.endCrossVuserTransaction( transactionName, transactionIdParam, status );

Arguments

Argument	Comments
transactionName	The name of the cross-Vuser transaction.
transactionIdParam	The parameter that contains the string ID of the transaction.
status	The transaction completion status to report. One of: LR_PASS LR_FAIL LR_AUTO LR_ABORT LR_STOP LR_TIMED_OUT LR_USER_DEFINED

Invoke lr.endCrossVuserTransaction to indicate that an action initiated by another vuser is finished from the point of view of this vuser. For example, a message sent from another vuser was received or not by this vuser. The initiating vuser invokes "lr.startCrossVuserTransaction" to start a transaction for the action. This vuser invokes lr.endCrossVuserTransaction to indicate the end of the transacion.

This function does not detect any events. Your script logic determines when the transaction ends and what the status is; and then calls lr.endCrossVuserTransaction.

If the initiating the user performed a broadcast activity to several recipients, each of the recipient vusers must call lr.endCrossVuserTransaction.

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.endCrossVuserTransaction is not recorded. You can add it to the script manually.

Return Values

Returns 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

You cannot use standard parameterization for any arguments in this function.

Example

lr.thinkTime(30);
lr.endCrossVuserTransaction("cross_trans_1", "{CVTIdentify}", LR_AUTO);
lr.endCrossVuserTransaction("cross_trans_2", "{CVTIdentify}", LR_AUTO);
lr.endCrossVuserTransaction("cross_trans_end_only", "{CVTIdentify}", LR_AUTO);
lr.endCrossVuserTransaction("error_trans", "{CVTIdentify}", LR_FAIL);