TipcSrvGetAutoFlushSize

Name

TipcSrvGetAutoFlushSize — get the auto flush size of the connection to RTserver

Synopsis

T_BOOL TipcSrvGetAutoFlushSize(auto_flush_size_return) 
T_INT4 *auto_flush_size_return; 

Arguments

auto_flush_size_return — storage for auto flush size

Return Values

TRUE if the auto flush size was successfully retrieved from the connection to RTserver, FALSE otherwise.

Diagnostics

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

Description

TipcSrvGetAutoFlushSize gets the auto flush size of the connection to RTserver by calling TipcConnGetAutoFlushSize. The auto flush size is used to control how much outgoing data (in bytes) are 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.

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

Caution

Unlike 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.

If TipcSrvGetAutoFlushSize returns FALSE, it does not store a value in auto_flush_size_return.

See Also

TipcConnGetAutoFlushSize, TipcSrvSetAutoFlushSize

Examples

This example creates a connection to RTserver, then gets and prints the auto flush size of the connection to RTserver:

T_INT4 auto_flush_size; 
 
if (!TipcSrvCreate(T_IPC_SRV_CONN_FULL)) { 
  return;  /* error */ 
}  
 
if (!TipcSrvGetAutoFlushSize(&auto_flush_size)) { 
  return;  /* error */ 
}  
 
TutOut("The connection to RTserver auto flush size is %d bytes.\n", 
       auto_flush_size);