Name

TAU_TRIGGER_CONTEXT_EVENT_THREAD — Triggers a context user event

Synopsis

C/C++:
TAU_TRIGGER_CONTEXT_EVENT_THREAD( name,  
  value,  
  thread);  
const char *   name;
double   value;
int   thread;
Fortran:
TAU_TRIGGER_CONTEXT_EVENT_THREAD( integer ,  
  integer ,  
  event_name);  
int   integer (2);
int   integer (2);
character   event_name(size);

Description

Triggers an event with a name and the list of routines along the callstack. A context event tracks information like a user defined event and TAU records the maxima, minima, mean, std. deviation and the number of samples for each context event. A context event helps distinguish the data supplied by the user based on the location where an event occurs and the sequence of actions (routine/timer invocations) that preceeded the event. The depth of the the callstack embedded in the context event's name is specified by the user in the environment variable TAU_CALLPATH_DEPTH. If this variable is not specified, TAU uses a default depth of 2.

Example

C/C++ :

int user_square(int count) {
  TAU_TRIGGER_CONTEXT_EVENT_THREAD("Error in Iteration", count * count, workTask);
  return 0;
}
		

Fortran :

call TAU_TRIGGER_CONTEXT_EVENT_THREAD(count, workTask, 'Error in Iteration')