TipcMonPrintWatch

Name

TipcMonPrintWatch — print all monitoring categories being watched

Synopsis

T_BOOL TipcMonPrintWatch(func) 
T_OUT_FUNC func; 

Arguments

func — TutOut-style output function

Return Values

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

Diagnostics

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

Description

TipcMonPrintWatch 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 TipcMonPrintWatch to print out what is being watched:

if (!TipcMonSubjectSubscribeSetWatch(T_IPC_MON_ALL, TRUE) { 
  return; /* error */ 
}  
if (!TipcMonProjectNamesSetWatch(TRUE) { 
  return; /* error */ 
}  
if (!TipcMonClientTimeSetWatch("primary", TRUE) { 
  return; /* error */ 
}  
if (!TipcMonClientMsgSubscribeSetWatch("primary",  
                                       "numeric_data") { 
  return; /* error */ 
}  
if (!TipcMonPrintWatch(TutOut)) { 
  return; /* error */ 
} 

The above fragment would print this output:

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