RendezvousManager Class

Rendezvous Management

The Rendezvous Manager allows you to:

The Rendezvous Manager acts on the test runtime globally, however many Load Generators are in use. Please note the following points on the way Rendezvous function:

Example: Given that there are 3 Load Generators, (G1, G2 and G3). On G1, a Virtual User JavaScript action calls the following code:

context.rendezvousManager.setEnabled("rendezvous",false);

G1, G2 and G3 will then disable the Rendezvous named "rendezvous": all Generators obey the order issued by G1.

Synopsis

 public class RendezvousManager {
  // Public Constructors
  public RendezvousManager();
  // Public Methods
  public Boolean hasRendezvous(String RDVName);
  public Boolean isEnabled(String RDVName);
  public void setEnabled(String RDVName,
                         Boolean isEnabled);
  public void unblock(String RDVName);
  public void unblock(String RDVName,
                      int virtualUserCount);
  public void unblockAll();
}

hasRendezvous(String)

public Boolean hasRendezvous(String RDVName);

Parameters

Indicates the existence of a rendezvous by returning a Boolean value.

This method returns:

isEnabled(String)

public Boolean isEnabled(String RDVName);

Parameters

Indicates the state of a rendezvous by returning a Boolean value.

This method returns:

When the specified rendezvous does not exist, an error is thrown and the script execution is stopped.

setEnabled(String, Boolean)

public void setEnabled(String RDVName,
                       Boolean isEnabled);

Parameters

Enables or disables a given rendezvous .

Disabling a rendezvous has the following consequences:

When the specified rendezvous does not exist, an error is thrown and the script execution is stopped.

unblock(String)

public void unblock(String RDVName);

Parameters

Releases all Virtual Users detained at the specified Rendezvous at that precise moment in time.

Any Virtual User arriving at the Rendezvous after the method is called are detained.

When the specified Rendezvous does not exist, an error is thrown and the script execution is stopped.

unblock(String, int)

public void unblock(String RDVName,
                    int virtualUserCount);

Parameters

Releases a set number of Virtual Users detained at the specified Rendezvous. The Virtual Users are released on a FIFO (first in - first out) basis: the first Virtual User to arrive at the Rendezvous is the first to be released.

The number of Virtual Users released is spread among the Generators according to their load.

There are some special cases:

unblockAll()

public void unblockAll();

Releases all Virtual Users detained at that precise moment in time, whatever the Rendezvous at which they are detained.

Any Virtual User arriving at the Rendezvous after the method is called are detained.