How to Establish a PCoIP Session¶

Before you can establish a PCoIP session with a host desktop, gather the following host desktop details:

IP Address
Port number
Session ID
Server name indication (SNI)
Connection tag

This information can then be passed to the provided in-session client to establish a PCoIP session programmatically. See the example code for specific call syntax. In terms of programming interface, there are two ways that the connection and security information can be presented to ClientSession.app:

Pass the pieces of Information Individually to the Executable The following command invokes ClientSession.app to establish a PCoIP session and passes the connection and session information as parameters, where:
- Connection tag: SCS1WsopFJ3iz1l48PTJMXFkcD4b6M9aiakHXH3ellLhUROBceWAifSSn%2b4AV1FC8IihWVmsISmYFKeA25AtzFrdMpdaCtqlic0zfxAA
- IP address: 10.64.60.115
- Session ID: 2305843009213693961
```
client_session.exe -i connect-tag=
SCS1WsopFJ3iz1l48PTJMXFkcD4b6M9aiakHXH3ellLhUROBceWAifSSn%2b4AV1FC
8IihWVmsISmYFKeA25AtzFrdMpdaCtqlic0zfxAA address=10.64.60.115
session-id=2305843009213693961
```
- Encode all information into a string container (URI) and then pass to the executable The following command invokes ClientSession.app to establish a PCoIP session and passes the connection tag as a parameter and a URI encapsulating the IP address and Session ID in a string container, where:
Connection Tag: SCS1WsopFJ3iz1l48PTJMXFkcD4b6M9aiakHXH3ellLhUROBceWAifSSn%2b4AV1FC8IihWVmsISmYFKeA25AtzFrdMpdaCtqlic0zfxAA
URI: "teradici-pcoip://10.64.60.115:4172?sessionid= 230584300921369396"

URI Format Documentation

There is a document describing the URI format in the root of the SDK,

client_session connecttag=
SCS1WsopFJ3iz1l48PTJMXFkcD4b6M9aiakHXH3ellLhUROBceWAifSSn%2b4A
V1FC8IihWVmsISmYFKeA25AtzFrdMpdaCtqlic0zfxAA "teradicipcoip://
10.64.60.115:4172?session-id=230584300921369396"