TipcSrvSetAutoFlushSize

Name

TipcSrvSetAutoFlushSize — set the auto flush size of the connection to RTserver

Synopsis

T_BOOL TipcSrvSetAutoFlushSize(auto_flush_size) 
T_INT4 auto_flush_size; 

Arguments

auto_flush_size — auto flush size (in bytes)

Return Values

TRUE if the auto flush size was successfully set for the connection to RTserver, FALSE otherwise.

Diagnostics

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

Description

TipcSrvSetAutoFlushSize sets the auto flush size of the connection to RTserver by calling TipcConnSetAutoFlushSize. The auto flush size is used to control how much outgoing data (in bytes) is buffered before being automatically flushed to RTserver. The default for the auto flush size is 8192 bytes. See TipcConnGetAutoFlushSize for more information on auto flush sizes.

TipcSrvSetAutoFlushSize may attempt to automatically create a connection to RTserver. If RTclient has a warm connection to RTserver, TipcSrvSetAutoFlushSize sets the auto flush size of the warm connection. See TipcSrvCreate on automatic creation of connections and warm connections to RTserver.

Caution

Unlike with other connections, the auto flush size T_IPC_NO_AUTO_FLUSH_SIZE cannot be used with the connection to RTserver to disable all automatic flushing of outgoing messages.

See Also

TipcConnGetAutoFlushSize, TipcConnSetAutoFlushSize, TipcSrvGetAutoFlushSize

Examples

This example creates a connection to RTserver, then sets the auto flush size to 4096 bytes:

if (!TipcSrvCreate(T_IPC_SRV_CONN_FULL)) { 
  return;  /* error */ 
}  
 
if (!TipcSrvSetAutoFlushSize(4096)) { 
  return;  /* error */ 
}