home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / dstips.exe / DSTRACE.TXT < prev    next >
Text File  |  1995-02-01  |  4KB  |  131 lines
  1. DSTrace Commands
  2.  
  3.     DSTrace is a set command available on Novell NetWare 4 servers.  DSTrace enables the Directory Services debug screen and was used by Novell developers during the development process.  It can be used to view Directory Services "in action". 
  4.  
  5.     The functionality of DSTrace can be divided into three parts: basic functions, choice of which trace statements to view, and initiation of background processes.
  6.  
  7. Basic Functions
  8. Controls the general status of the Directory Services Trace screen in NetWare 4.  An example would be Set DSTrace = ON
  9.     ON        Enables the Directory Services debug screen
  10.     OFF        Disables the debug screen
  11.     NODEBUG     Turns off all debugging messages, but leaves the screen enabled
  12.     
  13. Choice of Trace Statements
  14. Debugging messages related to different processes are enabled in the following manner.  An example using Miscellaneous as the statement choice would look like this. 
  15.     Type "Set DSTrace = +MISC" at the server console to begin viewing these messages.
  16.     Type "Set DSTrace = -MISC" to quit displaying the miscellanous debug messages.
  17.  
  18. Debugging messages are available individually for the following processes or functions in Directory Services.  The processes and DSTrace statements are:
  19.     
  20.  
  21. INIT
  22. Enables messages during initialization of the database
  23.  
  24.  
  25. FRAG/FRAGGER
  26. Enables fragger debug messages
  27.  
  28.  
  29. MISC
  30. Additional messages
  31.  
  32.  
  33. RES/RN
  34. Resolve Name requests
  35.  
  36.  
  37. STREAMS
  38. Stream Attributes
  39.  
  40.  
  41. LIMBER
  42. Verification of server name/address/replica tree connectivity
  43.  
  44.  
  45. J/JANITOR
  46. Removal of deleted entries, status of NCP servers, misc record mgmt
  47.  
  48.  
  49. BACK/BACKLINK
  50. Verification of backlinks and external references
  51.  
  52.  
  53. S/SYNC
  54. Synchronization process
  55.  
  56.  
  57. SAP
  58. Enable SAP messages
  59.  
  60.  
  61. SCHEMA
  62. Schema Synchronization
  63.  
  64.  
  65. COLL/COLLISION
  66. Entry/Attribute collisions
  67.  
  68.  
  69. I/INSPECTOR
  70. Verification of entry and entry references on the local server
  71.  
  72.  
  73. E/ERR/ERRORS
  74. Displays Errors
  75.  
  76.  
  77. PART
  78. Partitioning process
  79.  
  80.  
  81. EMU
  82. Bindery Emulator
  83.  
  84.  
  85. VC/VCLIENT
  86. Server to Server virtual client
  87.  
  88.  
  89. AUTHEN
  90. Enables authentication messages
  91.  
  92.  
  93. RECMAN
  94. Hashing/Iteration state handling
  95.  
  96.  
  97. TV/TIMEVECTOR
  98. Synchronization timestamp exchange
  99.  
  100.  
  101. DSA/DSAGENT
  102. Requests to the server agent
  103.  
  104.  
  105. ERRET
  106. Displays errors
  107.  
  108. Slashes indicate alternate command line statements.  Enable trace statements for a process with a "+" and disable with a "-".
  109.  
  110. Initiation of Background Processes
  111. Each of these preceeded with an asterisk will cause an action in Directory Services.  Example would be   Set DSTrace = *b
  112.     B    Backlink - Causes the backlink process to run.
  113.     F    Flatcleaner - Begins the process which removes deleted entries from the files.
  114.     H    Heartbeat - Causes Directory Services to try to exchange timestamps with any server with which it participates in replica operations.    
  115.     L    Limber - Causes the Directory to verify theserver name, server address and tree connectivity of replicas.
  116.     R    Reset - Causes the trace file to be reset.
  117.     S    Synchronization - Causes the Directory to check to see if synchronization is necessary on any of the replicas on that server.  If so, schedules the synchronization process to run sooner than normal.  
  118.     
  119. Saving to a File
  120. The trace statements may be saved to a disk file.
  121.     Set ttf = ON    Begins saving screen messages at the current file pointer.
  122.     Set ttf = OFF    Ends saving screen messages and closes the file.
  123.     Reseting the file to the beginning is done through the *r command mentioned above.
  124. The name of this file is SYS:System\DSTrace.DBG.  It will grow to 1M and will then wrap text to the beginning of the file when it reaches the end.
  125.  
  126. Examples
  127. Set DSTrace = INIT +MISC    Displays messages about initialization and miscellaneous functions.
  128. Set DSTrace = +j        Adds to the current trace messages those about the janitor process.
  129. Set DSTrace = Schema    Displays messages about the schema process.  Note that this does not add to the current messages displayed, but replaces the current DSTrace display with only schema messages.
  130. Set DSTrace = *f        Causes the flatcleaner process to run.  This does not affect the current set of debugging messages being displayed.
  131. Set DSTrace = -SAP        Removes the trace messages about SAP from the current set of messages being displayed.