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