traceWrite()

Writes a tracing message to the log destination.

Syntax

void traceWrite(int traceLevel, char * info,
          char * filterName);
 

Parameters

traceLevel [in]
Is one of the following trace levels, to use for writing the message:
Tracing::LEVEL1
 
  
 Tracing::LEVEL2
 
  
 Tracing::LEVEL3
 
  
 Tracing::LEVEL4
 
  
 Tracing::LEVEL5
 
 

The method writes the trace message when the current trace level is greater than or equal to traceLevel.

Note:
Do not specify a trace level of zero (LEVEL0) with a tracing message. A trace level of zero indicates that tracing is turned off. Therefore, any trace message associated with a traceLevel of LEVEL0 will never print.
info [in]
Is a pointer to the message text.
filterName [in]
Is a pointer to the filter to use for writing the message.

Return values

None.

Notes

You can use the traceWrite() method to write your own tracing messages for an application.

To write a tracing message without a filter, specify NULL for filterName.

Note:
The traceWrite() method is also available in the GenGlobals class. It is provided in the BOHandlerCPP class for access to tracing from within the business object handler.

Examples

traceWrite(Tracing::LEVEL3, "Invalid LoginId", NULL);
 

See also

See also the description of the Tracing class.

Copyright IBM Corp. 1997, 2003