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

lr_rendezvous_ex

Creates a rendezvous point in the Vuser script.

C Language

int lr_rendezvous_ex( char *rendezvous_name );
Example: lr_rendezvous_ex Run-Time Functions

Arguments

Name Comments
rendezvous_name The name of the rendezvous.

The lr_rendezvous_ex function creates a rendezvous point in a Vuser script. When this statement is executed, the Vusers stop and wait for permission to continue.

The default timeout is 30 sec. The timeout is set in the scenario policy in the Controller.

This function can only be used in an action section, and not in vuser_init or vuser_end.

The difference between this function and lr_rendezvous is that lr_rendezvous does not return a range of values.

Return Values

The return values of the lr_rendezvous_ex function are defined in the Lrun.h file. On Linux platforms, the function returns 0 for success and -1 for an illegal name. On PC platforms, the function returns one of the values described in the table below:

Enum Value Meaning
LR_REND_ALL_ARRIVED 0 Vuser was released after all the designated Vusers arrived.
LR_REND_TIMEOUT 1 Vuser was released after the timeout value was reached.
LR_REND_DISABLED 2 The rendezvous was disabled from the Controller.
LR_REND_NOT_FOUND 3 The rendezvous was not found.
LR_REND_VUSER_NOT_MEMBER 4 Vuser was not defined in the rendezvous.
LR_REND_VUSER_DISABLED 5 Vuser was disabled for the rendezvous.
LR_REND_BY_USER 6 The rendezvous was released by the user.

Parameterization

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