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.

  #define INCL_DOSPROCESS

  #include <stdio.h>                     /* C library for standard I/O        */
  #include <stdlib.h>                    /* C library of standard routines    */
  #include <string.h>                    /* C library for string operations   */
  #include <os2.h>                       /* OS/2 Dos api calls                */
  #include <trace.h>                     /* Trace public API data structures  */

  #define HKWD_TEST 43
  #define hkwd_test_entry 0001

  struct {
    ULONG  var1;
    USHORT var2;
  } trace_data;

  TCEREQUEST trace_create_entry_packet;

  VOID main(VOID)
  {
    APIRET rc = NO_ERROR;

    /**************************************************************************/
    /* Set up the TraceCreateEntry parameter packet                           */
    /**************************************************************************/
    trace_create_entry_packet.packet_size            = sizeof(TCEREQUEST);
    trace_create_entry_packet.packet_revision_number = TRACE_RELEASE;
    trace_create_entry_packet.major_event_code       = HKWD_TEST;
    trace_create_entry_packet.minor_event_code       = hkwd_test_entry;
    trace_create_entry_packet.event_data_length      = sizeof(trace_data);
    trace_create_entry_packet.event_data             = (PVOID)&trace_data;

    /**************************************************************************/
    /* Place tracepoint data in the tracepoint data buffer                    */
    /**************************************************************************/
    trace_data.var1 = UINT_MAX;
    trace_data.var2 = 1;

    rc = TraceCreateEntry(&trace_create_entry_packet);
    if (rc |= NO_ERROR) {
      printf("TraceCreateEntry RC(%d)\n", rc);
    }
  }