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".
The functionality of DSTrace can be divided into three parts: basic functions, choice of which trace statements to view, and initiation of background processes.
Basic Functions
Controls the general status of the Directory Services Trace screen in NetWare 4. An example would be Set DSTrace = ON
ON Enables the Directory Services debug screen
OFF Disables the debug screen
NODEBUG Turns off all debugging messages, but leaves the screen enabled
Choice of Trace Statements
Debugging messages related to different processes are enabled in the following manner. An example using Miscellaneous as the statement choice would look like this.
Type "Set DSTrace = +MISC" at the server console to begin viewing these messages.
Type "Set DSTrace = -MISC" to quit displaying the miscellanous debug messages.
Debugging messages are available individually for the following processes or functions in Directory Services. The processes and DSTrace statements are:
INIT
Enables messages during initialization of the database
FRAG/FRAGGER
Enables fragger debug messages
MISC
Additional messages
RES/RN
Resolve Name requests
STREAMS
Stream Attributes
LIMBER
Verification of server name/address/replica tree connectivity
J/JANITOR
Removal of deleted entries, status of NCP servers, misc record mgmt
BACK/BACKLINK
Verification of backlinks and external references
S/SYNC
Synchronization process
SAP
Enable SAP messages
SCHEMA
Schema Synchronization
COLL/COLLISION
Entry/Attribute collisions
I/INSPECTOR
Verification of entry and entry references on the local server
E/ERR/ERRORS
Displays Errors
PART
Partitioning process
EMU
Bindery Emulator
VC/VCLIENT
Server to Server virtual client
AUTHEN
Enables authentication messages
RECMAN
Hashing/Iteration state handling
TV/TIMEVECTOR
Synchronization timestamp exchange
DSA/DSAGENT
Requests to the server agent
ERRET
Displays errors
Slashes indicate alternate command line statements. Enable trace statements for a process with a "+" and disable with a "-".
Initiation of Background Processes
Each of these preceeded with an asterisk will cause an action in Directory Services. Example would be Set DSTrace = *b
B Backlink - Causes the backlink process to run.
F Flatcleaner - Begins the process which removes deleted entries from the files.
H Heartbeat - Causes Directory Services to try to exchange timestamps with any server with which it participates in replica operations.
L Limber - Causes the Directory to verify theserver name, server address and tree connectivity of replicas.
R Reset - Causes the trace file to be reset.
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.
Saving to a File
The trace statements may be saved to a disk file.
Set ttf = ON Begins saving screen messages at the current file pointer.
Set ttf = OFF Ends saving screen messages and closes the file.
Reseting the file to the beginning is done through the *r command mentioned above.
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.
Examples
Set DSTrace = INIT +MISC Displays messages about initialization and miscellaneous functions.
Set DSTrace = +j Adds to the current trace messages those about the janitor process.
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.
Set DSTrace = *f Causes the flatcleaner process to run. This does not affect the current set of debugging messages being displayed.
Set DSTrace = -SAP Removes the trace messages about SAP from the current set of messages being displayed.