TipcSrvKeepAlive

Name

TipcSrvKeepAlive — check the health of the connection to RTserver.

Synopsis

T_BOOL TipcSrvKeepAlive() 

Arguments

None

Return Values

TRUE if RTserver responded in time, FALSE otherwise.

Diagnostics

If TipcSrvKeepAlive fails, it returns FALSE and sets the global SmartSockets error number to one of:

Description

TipcSrvKeepAlive checks if the connection to RTserver is still alive by calling TipcConnKeepAlive. This check is called a keep alive. See TipcConnKeepAlive for more information on keep alives.

TipcSrvKeepAlive may attempt to automatically create a connection to RTserver. If RTclient has a warm connection to RTserver, TipcSrvKeepAlive immediately returns FALSE. See TipcSrvCreate on automatic creation of connections and warm connections to RTserver.

Caution

None

See Also

TipcConnKeepAlive

Examples

This example creates a connection to RTserver, then performs a keep alive every 10 seconds to check the health of the connection to RTserver:

if (!TipcSrvCreate(T_IPC_SRV_CONN_FULL)) { 
  return;  /* error */ 
}  
 
for (;;) { 
  TutSleep(10.0); 
  if (!TipcSrvKeepAlive()) { 
    return;  /* error */ 
  }  
}