ThingWorx Model Definition and Composer > System > Subsystems > WebSocket Communications Subsystem
  
WebSocket Communications Subsystem
The WebSocket (WS) Communications Subsystem handles core WS communications.
Configuration
Bind Protection Settings
Setting
Base Type
Default
Notes
Bind Protection Policy
STRING
First-in-wins
Choose the desired Bind Protection Policy from the menu. By default the policy is First-in wins. This policy means that if the platform receives a new bind attempt from an edge device that is already bound, the platform rejects the new bind attempt.
The Last-in wins policy means that, rather than rejecting a new bind for the already-bound device, the platform should accept that new bind and update the routing rules on how messages are sent out to the edge.
WebSocket Communication Settings
Setting
Base Type
Default
Notes
Idle Connection Timeout (sec)
INTEGER
60
Once the connection is established, the WebSocket Communications Subsystem waits the specified number of seconds before shutting the connection down. If there is activity, the idle timer is reset.
Idle Ping Rate (secs)
INTEGER
45
ThingWorx waits the specified number of seconds for a ping from a client. If a ping is received, the communication cycle continues.
If a pong is not received for a ping request in the specified number of seconds, the SDK will disconnect and attempt to reconnect. The disconnect will close the socket, ThingWorx connection, WebSocket connection, TLS connection, and the OS-level socket. The reconnect will create new versions of these connection layers, assuming each layer of authentication is successful.
Amount of time to wait for authentication message (secs)
INTEGER
15
After the connection is established, the remote server waits the specified amount of time for authentication.If authentication is not received, the socket is shut down.
Amount of time a request will wait for the response message before timing out (secs)
INTEGER
30
If the server is online and the request fails, an error is thrown.If the server is offline, the request is placed in the queue until the server is online again.
Send a ping after sending a message or tunnel traffic
BOOLEAN
True
Sends a ping after a message is sent from a client to the platform. This setting is applied when the connection is created.
Asynchronous Configuration Setting
Setting
Base Type
Default
Notes
Max Thread Count
NUMBER
10
Amount of threads available to communicate with Remote Things. Any requests above the specified value are sent to a queue.
Client Endpoint Settings
Setting
Base Type
Default
Notes
Endpoint Name
STRING
n/a
User-defined name
Endpoint URI
STRING
n/a
URI of the remote server with which to federate
Max Endpoint Connections
INTEGER
1
Number of connections open to the remote server
Idle Ping Rate (sec)
INTEGER
45
Used when federating two servers. The idle ping rate specifies how often the server sends a ping to the remote server. It keeps the connection active so intermediate systems do not shut the server down due to it being idle, and it prevents the remote server from shutting down the connection due to it being idle.
Application Key
PASSWORD
n/a
When you click the Change Password button, the Change Password screen appears. Here you can enter a new application key.