TipcMonServerMaxClientLicensesGetWatch

Name

TipcMonServerMaxClientLicensesGetWatch — determine if the RTserver is watching for the server cloud to exceed the licensed number of RTclient connections

Synopsis

T_BOOL TipcMonServerMaxClientLicensesGetWatch(server_name, 
watch_status_return) 
T_STR server_name; 
T_BOOL *watch_status_return; 

Arguments

server_name — name of the RTserver to set watch status (wildcard names allowed, or use T_IPC_MON_ALL to indicate a poll of all RTservers matching the value of Monitor_Scope)

watch_status_return — storage for watch status

Return Values

TRUE if the watch status was successfully retrieved, FALSE otherwise.

Diagnostics

If TipcMonServerMaxClientLicensesGetWatch fails, it returns FALSE and sets the global SmartSockets error number to:

Description

TipcMonServerMaxClientLicensesGetWatch determines whether the server_name RTserver is watching for the server cloud to exceed the maximum licensed number of RTclient connections. The server_name argument can be the unique subject name of a single RTserver, a wildcarded subject name to match many RTservers, or T_IPC_MON_ALL to poll all RTservers that match the value of the Monitor_Scope option. The watch_status_return argument is set to TRUE if the watch is currently active, FALSE if not.

Caution

TipcMonServerMaxClientLicensesGetWatch returns FALSE, it does not store a value in watch_status_return.

RTserver licenses can only be watched, not polled.

See Also

TipcMonServerMaxClientLicensesSetWatch

Examples

This example uses TipcMonServerMaxClientLicensesGetWatch to determine whether the RTserver is watching for the RTserver cloud to exceed the maximum licensed number of RTclient connections:

T_BOOL watch_status; 
 
if (!TipcMonServerMaxClientLicensesGetWatch("/...",  
&watch_status)) { 
  return; /* error */ 
} 
TutOut("This RTclient is %s client rejections in ", 
       watch_status ? "watching" : "not watching"); 
TutOut("all servers.\n");