Dispatcher error and debugging output (if enabled) are written to the file dispatcher.log in the MTA log directory. The dispatcher configuration information is specified in the msg-svr-base/config/dispatcher.cnf file. A default configuration file is created at installation time and can be used without any changes made. However, if you want to modify the default configuration file for security or performance reasons, you can do so by editing the dispatcher.cnf file.
Table 25–5 Dispatcher Debugging Bits
Bit
|
Hexadecimal value |
Decimal value |
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. |
Edit the dispatcher.cnf file.
Set the DEBUG option to -1.
You can also set the logical or environmental variable IMTA_DISPATCHER_DEBUG (UNIX), which defines a 32-bit debug mask in hexadecimal, to the value FFFFFFFF. The table above describes the meaning of each bit.
The dispatcher services offered in the dispatcher configuration file affects requirements for various system parameters. The system’s heap size (datasize) must be enough to accommodate the dispatcher’s thread stack usage.
To display the heap size (that is, default datasize), use one of the following:
The csh command:
# limit |
The ksh command
# ulimit -a |
The Solaris utility
# sysdef |
For each dispatcher service compute STACKSIZE*MAX_CONNS, and then add up the values computed for each service. The system’s heap size needs to be at least twice this number.