# itrace overview

itrace limits the number of debug ISDN messages sent to oammon. The ISDN stack includes many entities (for example, layer 1 entities, layer 2 entities, layer 3 entities, management entities, and timer entities) that exchange messages.

Debug information is sent to oammon when the agtrace bit 0x800000 is set. It can be filtered by this utility based on board number, NAI number, NFAS group number, and entity. By default, all the entities are enabled.

#### Usage

itrace [on|off] [board] [nai] [entity_list|*] [nfas_group]

where:

Option | Meaning
--- | ---
on|off | Logging enabled or disabled.
board | Board number.
nai | Network access identifier (NAI).
entity_list | String of entity IDs (as defined in isdntype.h). If the string starts with an exclamation point (!), the buffers associated with the messages are sent to the monitoring utility.
* | All entities.
nfas_group | NFAS group number for configurations with duplicate NAI values.

## Using itrace

Perform the following steps to run the itrace utility:

Step | Action
1 | Run agtrace with mask 801000 to enable the ISDN protocol stack messages to be passed to oammon.
2 | Run itrace to enable or disable messages to and from entities in the entity_list string. Note: itrace can be run at any time of execution. Message logging is changed dynamically.

## itrace file

itrace is supplied in executable format and is located in one of the following directories:

Operating system | Directory
Windows | \nms\bin\itrace.exe
UNIX | /opt/nms/bin/itrace