25.3.5 Enabling Dispatcher Debugging

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.

To Enable Dispatcher Error Debugging Output

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.

To Set Dispatcher Parameters (Solaris)

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.