TraceCreateEntry

TraceCreateEntry creates an event entry in the system event buffer. It is the static trace-point creation mechanism.

Syntax
TraceCreateEntry(pTraceCreateEntry);

Parameters

 * pTraceCreateEntry (PTCEREQUEST) - input: Pointer to the TraceCreateEntry parameter packet.

Returns

 * rc (APIRET) - returns:TraceCreateEntry returns the following values:
 * 1702 INVALID_LF_PACKET_REVISION_NUMBER
 * 1703 INVALID_DATA_POINTER
 * 1802 INVALID_TRACE_MAJOR_CODE
 * 1803 INVALID_TRACE_MINOR_CODE
 * 1806 INVALID_PACKET_SIZE

Remarks
Event trace records contain information that describes the occurrence of software events. They can be used both as service aids and in performance monitoring.

The library TRACE.LIB must be linked with object files that use TraceCreateEntry.

Example Code
The following example adds an event trace entry to the system trace buffer. For this example, the trace entry will contain the contents of two internal program variables.