home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / syssplit.zip / syssplituse.txt < prev   
Text File  |  2002-06-22  |  3KB  |  63 lines
  1. SYSSPLIT
  2. --------
  3.  
  4. Syntax:
  5.  
  6.          SYSSPLIT <input_file>
  7.  
  8.  
  9. Trace definition files - SYSTEM.TDF:
  10.  
  11. When applying tracepionts to a DLL, TRACE.EXE will search the current
  12. path, then the DPATH for the dll_name.TDF file. If not found it
  13. searches OS2\SYSTEM\TRACE\SYSTEM.TDF and finally,
  14. OS2\SYSTEM\TRACE\dll_name.TDF.
  15.  
  16. If the system trace definitions for a particular module needs to be
  17. replaced or modified then SYSSPLIT may be used to split SYSTEM.TDF
  18. into its constituent TDF files. The resultant *.TDF files may be saved
  19. in OS2\SYSTEM\TRACE. Because of the search order employed by TRACE.EXE
  20. it is recommended that SYSTEM.TDF be renamed after being split.
  21.  
  22. The file names of the split *.TDFs will be chosen to be the original
  23. names used to create SYSTEM.TDF.
  24.  
  25. N.B. The trace definitions for the OS2KRNL may be in OS2KRNL.TDF or
  26. DOSCALLS.TDF. The TRACE command recognises the keyword KERNEL as an
  27. alias for each of the kernel TDF names. TRACE.EXE searches the DPATH
  28. for DOSCALLS.TDF, but due to a bug only \OS2\SYSTEM\TRACE of the
  29. current drive (as opposed to the boot drive) for OS2KRNL.TDF. The
  30. result of this latter point is that TRACE ON KERNEL will only work
  31. for OS2KRNL.TDF if a directory from the boot drive is curent.
  32.  
  33. The TDFLST utility may be used with each of the resultant TDFs to
  34. format the trace point definitions.
  35.  
  36.  
  37.  
  38. Trace formatting files - SYSTEM.TFF:
  39.  
  40. When formatting the system trace, TRACEFMT.EXE will search
  41. OS2\SYSTEM\TRACE\SYSTEM.TFF for the formatting templates for each
  42. major code encountered in the trace buffer. If a major code is not
  43. found in SYSTEM.TFF then TRACEFMT will search for a file named
  44. TRC00xx.TFF, where xx is the major code number in hexadecimal.
  45.  
  46. If the formatting templates for a particular module needs to be
  47. replaced or modified then SYSSPLIT may be used to split SYSTEM.TFF
  48. into its constituent TFF files. The resultant *.TFF files may be saved
  49. in OS2\SYSTEM\TRACE. Because of the search order employed by
  50. TRACEFMT.EXE it is recommended that SYSTEM.TFF be renamed after being
  51. split.
  52.  
  53. The file names of the split *.TFFs will be chosen to be the original
  54. names used to create SYSTEM.TDF, that is names formed from their major
  55. codes.
  56.  
  57. The TFFLST utility mat be used with each of the resultant TFFs to
  58. format the trace point definitions.
  59.  
  60.  
  61. N.B. TRCUST has the ability to combine TFFs for the same major code.
  62. This is not to be confused with the special SYSTEM.TFF and SYSTEM.TDF
  63. files that are concatenations of dissimilar major code definitions.