Novell Doc: Novell eDirectory 8.8 What's New Guide

14.3 DSTrace Messages

You can filter the trace messages based on the thread ID, connection ID, and severity of the messages.

Once you specify a filter for the messages, only the messages that fit the filter are displayed on the screen. All the other messages for the enabled tags will get logged into the ndstrace.log if the file is set to ON.

Only one filter is applicable at a time. Filter has to be specified for each session of ndstrace.

By default, the severity level is set to INFO, this means that all the messages with severity level more that INFO would be displayed. You can see the severity level by enabling the svty tag.

You can use iMonitor also to filter the trace messages. For more information, refer to Section 14.4, iMonitor Message Filtering.

14.3.1 Linux and UNIX

Complete the following procedure to filter the trace messages:

Enable filtering with the following command:
```
ndstrace tag filter_value
```
To disable filtering, enter the following command:
```
ndstrace tag
```
Examples for enabling filtering:
- To enable filtering for thread ID 35, enter the following:
```
ndstrace thrd 35
```
- To enable filtering for severity level fatal, enter the following:
```
ndstrace svty fatal
```
  Severity levels can be FATAL, WARN, ERR, INFO, and DEBUG.
- To enable filtering for connection ID 21, enter the following:
```
ndstrace conn 21
```
Examples for disabling filtering:
- To disable filtering based on thread ID, enter the following:
```
ndstrace thrd 
```
- To disable filtering based on connection ID, enter the following:
```
ndstrace conn 
```
- To disable filtering based on severity, enter the following:
```
ndstrace svty
```

Figure 14-1 Sample Trace Message Screen With Filters

14.3.2 Windows

Complete the following procedure to filter the trace messages:

Select Start > Control Panel > Novell eDirectory Services
In the Services tab, select dstrace.dlm.
Click Edit > Options in the Trace window.

The Novell eDirectory Trace Options dialog box is displayed.

Figure 14-2 Trace Options Screen on Windows
Click on the Screen tab.
Select the filter option from the Filters group and enter the filter value.

You can filter the messages based on:
- Thread ID
- Connection ID
- Severity
Before selecting any of the filters, ensure that it is enabled under Trace Line Prefixes.

You can also disable the filtering by selecting None or unselecting the filter option.

NOTE:If you've selected Thread ID or Connection ID as your filter option and enter a value that does not exist, then the messages won't be displayed on the screen. However, all the other messages will still get logged to the ndstrace.log file.