Assignment of Major and Minor Codes

Component and subsystem developers who assign their own major and minor trace codes should follow the following conventions:

• Minor codes should be assigned in the range 0001H-FFFFH. Minor code 0000H is reserved and should not be used.

• An interface/event which requires both a pre-invocation trace and post-invocation trace of the event should share the same major code. The minor code assigned for the pre-invocation trace should be in the range 0001H-7FFFH. The minor code for the post-invocation trace of the event should be in the range 8001H-FFFFH and should be assigned by turning on the high order bit of the pre-invocation minor code. For example:

                                      Major     Minor
  Event Name                          Code      Code
  ----------                          ----      ----
  KbdCharIn Pre-Invocation            0011H     0001H
  KbdCharIn Post-Invocation           0011H     8001H
  

• The Trace Definition Files for dynamic tracepoints should use the following TYPE definitions when defining tracepoints. Other TYPEs or GROUPs may be defined as desired but these should be used as a minimum.

  • TYPE=(PRE,API) - pre-invocation of external interface

  • TYPE=(POST,API) - post-invocation of external interface

  • TYPE=(PRE,INT) - pre-invocation of internal interface

  • TYPE=(POST,INT) - post-invocation of internal interface

  ---

  [Back: Guidelines for Defining Tracepoints]
  [Next: Trace Event Call Location]