Manage Vusers during a test run

This topic describes the runtime options for managing the behavior of Vusers during a performance test run.

View Vuser details

You can view status details of individual Vusers, and run/stop a single Vuser currently in the down/run state, irrespective of its defined schedules.

On the Performance Test Run page, click Vusers Details. The Vusers dialog box opens, enabling you to run or stop individual Vusers.

User interface elements are described below:

UI Elements	Description
	Select All. Selects all displayed Vusers.
	Deselect All. Deselects all selected Vusers.
	Invert Selection. Inverts the current selection of Vusers. That is, the non-selected Vusers are selected, and the selected Vusers are cleared.
	Run Selected Vusers. Runs the selected Vusers.
	Pause Selected Vusers. Pauses the selected Vusers.
	Stop Selected Vusers Gradually. Stops the selected Vusers gradually. The Vusers complete the current iteration before stopping.
	Stop Selected Vusers Immediately. Stops the selected Vusers immediately.
	Reset Selected Vusers. Resets the selected Vusers to the Down state.
	Show Selected Vusers Log. Opens the Vuser Activity Log, which displays runtime information for the selected Vuser. The log displays the following information: Activity log for Vuser. The selected Vuser. Refresh. Refreshes the information displayed in the log. Download log. Enables you to download the log. Close. Closes the log. Log Message. Displays the logged Vuser messages. Snapshot. Generates a snapshot (a graphical representation of the Web page) which contains the data generated by the traffic between the client and the server when the script is replayed. Note: Before using this feature, you must enable the Generate snapshot on error option in the script's runtime settings. For details on the runtime settings, see Configure runtime settings.
	Refresh. Refreshes the information displayed in the dialog box.
Elapsed Time	The amount of time the Vuser has been running.
Group	Filters displayed Vusers by Vuser group.
ID	The Vuser's ID.
Load Generator	Filters displayed Vusers by load generators.
Status	Filters displayed Vusers by their current status.

Run Vusers

You can initialize, run, or stop any number of Vusers irrespective of their defined schedules. In addition, you can add new Vusers to the performance test.

On the Performance Test Run page, click Run Vusers. The Run Vusers dialog box opens, enabling you to run additional Vusers.

User interface elements are described below:

UI Elements	Description
	Distribution Mode: by Vusers. The Vusers being given an instruction are distributed according to Vuser groups.
	Distribution Mode: by Load Generator. The Vusers being given an instruction are distributed according to load generators.
	Vuser by: Number. Enables you to give an instruction to a specific number of Vusers per Vuser group/load generator.
	Vuser by: Percentage. Enables you to give an instruction to a specific number of Vusers, which are then distributed among the Vuser groups/load generators according to a percentage which you define. Example: If you choose to run an additional 200 Vusers, among three Vuser groups, A, B, and C, and you define the percentage distribution as A = 75%, B = 20%, and C = 5%, then the Vusers would be distributed as follows: A. 150 Vusers B. 40 Vusers C. 10 Vusers Note: When selecting this method, you enter the number of Vusers to run in the box adjacent to the by Percentage button.
	Enter the number of Vusers per Vuser group/load generator.
	Enter the percentage distribution per Vuser group/load generator.
Apply	Performs the selected instruction.
Group	Lists the Vuser groups in the test.
Load Generator	Lists the load generators in the test.
Perform the following Action	Give the desired instruction to the defined number of Vusers. The possible actions are: Add new Vusers to Down state. Add the desired number of Vusers to the Down state. Add new VUDs to Down state. Add the desired number of VUDs to the Down state. Initialize Vusers from Down. Initializes the desired number of Vusers currently in the Down state. Run Vusers from Down. Runs the desired number of Vusers currently in the Down state. Run Vusers from Ready. Runs the desired number of Vusers currently in the Ready state. Stop Vusers. Moves the desired number of Vusers from the Run state to the Gradual Exiting state. Reset Vusers. Moves the desired number of Vusers from the Stopped state to the Down state. Note: You cannot perform an action on more Vusers than are currently in a particular state. For example, if you define 10 Vusers and select Initialize Vusers from Down, but there are only five Vusers in the Down state, only those five Vusers are initialized.

Add or edit Vuser groups

You can add Vuser groups to a running performance test, or edit existing Vuser group settings during a test run.

Action	Description
Add a group	On the Performance Test Run page, click Design Groups and Scheduler. Then select Add Groups. The Add/Edit Vuser Group dialog box opens, enabling you to add a Vuser group.
Edit a group	On the Performance Test Run page, on the Groups pane, place the mouse cursor over the name of the group you want to edit. Click the down arrow that appears adjacent to the name, and select Edit Group. The Edit Group dialog box opens, enabling you to edit the group's details. Group Name. The name of the Vuser group. Note: Do not use non-English characters in group names. Load Generators. The load generators on which the group is running. Protocol. The Vuser script's protocol. Script. The name of the Vuser script. Vusers. The number of Vusers assigned to the group.
View/edit runtime settings	Click Run Time Settings to view and change the runtime settings for the Vuser script. For details, see Configure runtime settings.
Send parameter	Click Command Line and type the name and value of the parameter you want to send using the format, <Parameter_Name> <value>. For information about the command line parsing functions, or for details about including arguments on a command line, see the LoadRunner Online Function Reference, provided with Virtual User Generator.

View Vuser scripts

You can view the code for each action in a running Vuser script.

On the Performance Test Run page, place the mouse cursor over a group name in the Groups pane.
Click the down arrow that appears adjacent to the name, and select View Script.

The View Script dialog box displays the script details including script name, type, the last updated date and time, the actions included in the script, and displays any files included in the script.
To download the script, click Download.

Manually release Vusers from a Rendezvous

You can manually release Vusers from a rendezvous before the Controller releases them.

On the Performance Test Run page, click View Rendezvous. The Rendezvous Policy dialog box opens. For details, see Set rendezvous policies.