From:	IN%"NOVELL@SUVM.SYR.EDU"  "Novell LAN Interest Group"  1-SEP-1994 19:38:37.44
From: Julian Byrne <jcb@FAWLTY10.ENG.MONASH.EDU.AU>
Subject: DSTRACE Options

Appended is a list of DSTRACE options. It's a verbatim copy of some of the
overhead slides of a talk by Orland Seaver, Senior Consultant, Novell
Consulting Services, Novell Pty. Ltd. called "Netware 4 Inside Out".
Note that some of these options only apply to later versions of the NDS.
 
Julian Byrne <Julian.Byrne@eng.monash.edu.au>
 
 
       DSTRACE
 
  SET DSTRACE = ON
 
- View exchanges between NDS servers
- Allows output to be piped to a file
  - SET TTF = ON
  - Piped to SYS:SYSTEM\DSTRACE.DBG
- Creates screen session like "TRACK ON"
- Useful for troubleshooting and determining health of tree
- Information is not always "real-time" (-625)
 
 
  DSTRACE Debug Commands
 
   SET DSTRACE=+Command
 
AUTHEN            DS Authentication
AUDIT             Auditing Info
BACKLINK (BLINK)  Display Backlink Info
JANITOR           Janitor Process
LIMBER            Limber Up Process Info
RESNAME (RN)      Display Resolve Name Info
SKULKER           Display Skulker Info
TIMEVECTOR (TV)   Display Time Vector Info
VCLIENT (VC)      Virtual Client Info
 
 
  DSTRACE Action Commands
 
   SET DSTRACE=*Command
 
*B Start BackLink Process
*F Start Janitor Process (purges deleted objects)
*H Start Sync Process Now!
*L Start Limber Up Process
*R Reset DSTRACE.DBG file to 0 length
*S Schedule Skulker
*U Reset -625 flag in DS so the DS will really attempt to synch
 
 
  DSTRACE Timing Parameters
         NDS 296+
 
    SET DSTRACE=*Command
 
*W# Default 20, Range 1-2000
    Length of time after getting IPX timeout before resending
*X# Default 3, Range 1-500
    Number of IPX retries before issuing -625 error
*Y# Default 16, Range 1-80
    Multiplication factor
*Z# Default 10, Range 1-500
    Additional delay for IPX timeout
 
 
  DSTRACE Timing Parameters
         NDS 302+
 
    SET DSTRACE=!Command
 
!W  Default 20, Range 1-20000
    Length of time after getting IPX timeout before resending
!X  Default 3, Range 1-500
    Number of IPX retries before issuing -625 error
!Y  Default 16, Range 1-80
    Multiplication factor
!Z  Default 10, Range 1-500
    Additional delay for IPX timeout
 
 
          DSTRACE
      Retry Parameters
 
- W - Delay before Retry
- X - Number of Retries
 
 
  DSTRACE - IPX Timeout Calculation
      Formula Using Y and Z
 
1. Do a "Get Local Target"
   Returns Ticks to get there
2. Set trip time = ticks from #1 or 20 if no response
3. Calculate IPX timeout = (Trip Time * (Y)) + Z
 
Z is the magic parameter if router returns wrong answer.
 
 
  DSTRACE - Starter Parameters
 
       SET DSTRACE=+VC
       SET DSTRACE=*U
       SET DSTRACE=*H
 
 
        DSTRACE
        Summary
 
- Have DS SYNC problems
  - Objects not replicated on other servers
  - Changes not reflected on other servers
- To see current status of DS traffic
- To force DS processes
- Capture log/answer tech support questions