TipcSrvMonPrintWatch

Name

TipcSrvMonPrintWatch — print all monitoring categories being watched

Synopsis

T_BOOL TipcSrvMonPrintWatch(srv, func) 
T_IPC_SRV srv; 
T_OUT_FUNC func; 

Arguments

srv — connection handle to RTserver

func — TutOut-style output function

Return Values

TRUE if the watch information was successfully printed, FALSE otherwise.

Diagnostics

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

Description

TipcSrvMonPrintWatch prints all the monitoring categories being watched to a TutOut-style output function. The output function is called once for each line of output.

Caution

None

Examples

This example starts watching a few monitoring categories and then calls TipcSrvMonPrintWatch to print out what is being watched:

if (!TipcSrvMonSubjectSubscribeSetWatch(srv, T_IPC_MON_ALL, TRUE)) 
{ 
  return;  /* error */ 
}  
if (!TipcSrvMonProjectNamesSetWatch(srv, TRUE)) { 
  return;  /* error */ 
}  
if (!TipcSrvMonClientTimeSetWatch(srv, "primary", TRUE)) { 
  return;  /* error */ 
}  
if (!TipcSrvMonClientMsgSubscribeSetWatch(srv, "primary", 
                                          "numeric_data")) { 
  return;  /* error */ 
}  
if (!TipcSrvMonPrintWatch(srv, TutOut)) { 
  return;  /* error */ 
} 

The above fragment prints this output:

Watching project_names. 
Watching subject_subscribe <@>. 
Watching client_time <primary>. 
Watching client_msg_recv <primary> <numeric_data>.