Teradici PCoIP protocol

The PCoIP (PC over IP) protocol supports testing on the Teradici Pervasive Computing Platform and VMware HorizonView.

The server passes images only, so the relevant actions that the user can perform are connect, disconnect, mouse click, and key press.

Using the PCoIP client

The PCoIP client is shipped with VuGen, but must be manually copied to your product installation. This is due to security considerations created by several third-party libraries used by the client, such as qt5 and ssl.

To use the client, copy the PCoIP folder from one of these locations:

  • DVD\lrunner\Common\PCoIP

  • DVD_PC\Setup\Common\PCoIP

Paste the PCoIP folder into the relevant <product root>\bin folder for the LoadRunner Professional components that will work with the protocol. For example:

<VuGen root>\bin

< OneLG root>\bin


  • The PCoIP client does not support connections to application pools (published applications). You can connect only to desktop pools.
  • The client supports only 64-bit recording and replay.

Back to top

Record a PCoIP test

  1. Click the Start Recording button.
  2. In the Start Recording dialog, select Windows Application under Recording mode and enter the PCoIP client path name in the Application field. For example,

    <VuGen root>\bin\pcoip\pcoip_client.exe

  3. Enter other information as appropriate to your test and click Start Recording.
  4. Follow the directions on the Teradici client screens to connect to the server.
  5. Record your business process from within the client.

Note: A call to Copy image to the clipboard from the snapshot context menu may throw an OpenClipboard Failed exception. In that event, close all open PCoIP clients.

Back to top

Enhance the recorded script

During recording, strings (alphanumeric keyboard presses) are recorded until some other type of activity occurs, such as mouse clicks or non-alphanumeric key presses.

When typing is slow, VuGen may break up a typing session into a number of invocations of pcoip_type() interleaved with lr_think_time(). By manually editing the script, these calls can be concatenated. This facilitates parameterization, if you need the string to be substituted with a parameter.

Back to top

Add a timeout for finding an area of a snapshot

Use the pcoip_sync_on_bitmap_ex function to add a timeout period for finding the desired area (hash) of a snapshot.

  1. Click the pcoip_mouse_click function that contains snapshot.

  2. In the Snapshot panel, right-click the snapshot and select Insert sync on bitmap.

  3. Using the mouse, select the desired zone.

  4. In the dialog box that opens, define a timeout period (in seconds), and click OK.

    The pcoip_sync_on_bitmap_ex is inserted before the pcoip_mouse_click function.

    Note: The hash value is automatically generated.

Back to top

Sample Script

This script enters "Hello World" in an open application.


	pcoip_set_auth("alex-qa", "mydomain", lr_unmask("56ec1f82347be574b867f74a72"));

	pcoip_connect("MYD-SERVER", "123.456.789.abc", "MYD-SERVER", "4172", 1);

	pcoip_set_display(980, 556);

	pcoip_key("NUM_LOCK_KEY", 0);

	pcoip_mouse_click(18, 537, LEFT_BUTTON, 0, "snapshot3");

	pcoip_key("ENTER_KEY", 0);

	pcoip_key("h", MODIF_SHIFT);

	pcoip_type("ello", 0);

	pcoip_key("w", MODIF_SHIFT);

	pcoip_type("orlx", 0);

	pcoip_key("BACKSPACE_KEY", 0);

	pcoip_key("d", 0);

	pcoip_key("ENTER_KEY", 0);

	pcoip_key("TAB_KEY", 0);


	return 0;

Back to top