How-to and troubleshooting guide for RTE Vusers

RTE Vusers how-to and troubleshooting steps

For Recording:

Make sure that you save the terminal set up so that it uses the correct or same screen during replay. To save the terminal setup, you need to:

1. Start RTE recording.

2. Go to Communication -> Connect.

3. Set up the settings/parameters and connect to your host.

4. Implement either of the following:

To automatically save the setting into the script’s directory before the end of recording:

Go to Terminal -> Setup -> Preferences.

Enable "Save Terminal Setup" in the "On PowerTerm Exit" section.

To save the setting in a separate location using some other names.

Go to File -> Save Terminal Setup as.

Save the information in a file with a .pts extension.


You need to copy this .pts file to the script directory after recording.

If you are saving the script after recording:

1. You need to make sure that the termset.pts file is copied into script directly. If you prefer to use your own setup file, you need to replace the termset.pts in the script directory with your own .pts file (rename it to termset.pts).

2. Avoid saving the script to a directory that has spaces embedded in it as it cause potentially cause problems.

For Replay:

1. Enable think time for replay. Go to Run-Time Settings -> General -> Think Time, and set "Replay Think Time."

2. Make sure that you have a termset.pts file in the script directory.

3. When you add the script into the Controller, click on Details -> More -> Files and make sure that the termset.pts file is listed. If not, click on the "Add" button to include the file.

4. Go to the Load Generators tab and highlight the relevant Load Generator machine.

5. Go to Details -> Vuser Limit, and select the "RTE" checkbox.

6. In order to run more than 400 RTE Vusers from NT, you need to increase the size of the Non-Paged Pool.

Go to Start -> Run, and enter regedit.

Navigate to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SessionManager\Memory Management.

Value Name: NonPagedPoolSize

Data Type: REG_DWORD (DWORD Value)

Value Data: size of paged pool in bytes (default = 0)

This key specifies the size of nonpaged pool in bytes. When this value is 0, the system uses the default size (based on physical memory). The maximum amount is about 80 percent of physical memory.


1. Even though possible, it is recommended to run around 150 ~ 200 RTE Vuser per machine regardless of the size of the machine to avoid any stability issue.

2. The recommended way to run excessive RTE Vusers per machine is to run on MTS servers with around 100 Vusers on each MTS sessions.

Supported platform:

There is no support for Unix-based replay for a RTE Vuser.

Known limitations

1. The "Show Vuser" option is only enabled during execution of the Action section.

2. RTE users only disconnect when the Vuser terminates. You cannot emulate login and logout in the Action section of the script. The TE_connect function and the login sequence should be in the vuser_init section.


1 Comment

  1. Thank you for this useful post.

    I’m stuck with the error “Retrying. Reason: Unable to connect to host.The error message is: Connection closed by host.” the script works fine in Vugen also when I just place the TE_connect code in a new script and new vugen. but when I upload the script to ALM 12 and execute i face the above failure.

    Do I need to make any specific changes to the Load generator.?
    I also tried uploading the script with All file so the termset.pst is present in the script.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s