Dispatcher error and debugging output (if enabled) are written to the file dispatcher.log in the MTA log directory.
Debugging output may be enabled using the option DEBUG in the Dispatcher configuration file, or on a per-process level, using the IMTA_DISPATCHER_DEBUG environment variable (UNIX).
The DEBUG option or IMTA_DISPATCHER_DEBUG environment variable (UNIX) defines a 32-bit debug mask in hexadecimal. Enabling all debugging is done by setting the option to -1, or by defining the logical or environment variable system-wide to the value FFFFFFFF. The actual meaning of each bit is described in Table 4–27.
Table 4–27 Dispatcher Debugging Bits
Bit
|
Hexadecimalvalue |
Decimalvalue |
Usage
|
---|---|---|---|
0 |
x 00001 |
1 |
Basic Service Dispatcher main module debugging. |
1 |
x 00002 |
2 |
Extra Service Dispatcher main module debugging. |
2 |
x 00004 |
4 |
Service Dispatcher configuration file logging. |
3 |
x 00008 |
8 |
Basic Service Dispatcher miscellaneous debugging. |
4 |
x 00010 |
16 |
Basic service debugging. |
5 |
x 00020 |
32 |
Extra service debugging. |
6 |
x 00040 |
64 |
Process related service debugging. |
7 |
x 00080 |
128 |
Not used. |
8 |
x 00100 |
256 |
Basic Service Dispatcher and process communication debugging. |
9 |
x 00200 |
512 |
Extra Service Dispatcher and process communication debugging. |
10 |
x 00400 |
1024 |
Packet level communication debugging. |
11 |
x 00800 |
2048 |
Not used. |
12 |
x 01000 |
4096 |
Basic Worker Process debugging. |
13 |
x 02000 |
8192 |
Extra Worker Process debugging. |
14 |
x 04000 |
16384 |
Additional Worker Process debugging, particularly connection hand-offs. |
15 |
x 08000 |
32768 |
Not used. |
16 |
x 10000 |
65536 |
Basic Worker Process to Service Dispatcher I/O debugging. |
17 |
x 20000 |
131072 |
Extra Worker Process to Service Dispatcher I/O debugging. |
20 |
x 100000 |
1048576 |
Basic statistics debugging. |
21 |
x 200000 |
2097152 |
Extra statistics debugging. |
24 |
x 1000000 |
16777216 |
Log PORT_ACCESS denials to the dispatcher.log file. |