Dispatcher debugging and log files

Dispatcher error and debugging output (if enabled) are by default written to the file   in the  MTA log directory. (But see the  Dispatcher option if you prefer to direct Dispatcher error and debugging output to an nslog file.)

Debugging output may be enabled using the   Dispatcher option in Unified Configuration (or the option DEBUG in the  Dispatcher configuration file in legacy configuration), or on a per-process  level, via the PMDF_DISPATCHER_DEBUG   environment variable (UNIX). (In legacy configuration, when enabling the DEBUG option in the Dispatcher configuration file, note that it may be set either globally, or (by setting it within  specific SERVICE sections) only for one or more services; in  particular, to enable debugging for the Dispatcher but not for  its worker processes (such as SMTP server processes), it may be set  within a &#x5b;SERVICE=DISPATCHER&#x5d; section.)

Note that as of MS 7.0.5,  enabling the MTA option    will  cause Dispatcher debugging to get flushed to disk immediately.

The format of records in the Dispatcher log file is: hh.mm.ss.ss (four-digit-thread-id): debug-message Physical lines in the Dispatcher log file are limited to 79 characters. If a record has to be continued to a second line (due to the   getting "too long"), then  the rest of the   will be indented  with white space for the   and    fields, to line up with the  initial part of  .

Note that the Dispatcher itself always has   number  ; that is, records  for the main Dispatcher process itself begin hh.mm.ss.ss (  1): The  Dispatcher option  (DEBUG option in   in legacy configuration) or   environment variable (UNIX) defines a 32-bit debug mask in  hexadecimal. Enabling all debugging is done by setting the option to , or by defining the   environment variable system-wide to  the value. The actual meaning of each bit is described in Dispatcher debugging bits.

See also:
 * imta_log MTA Option
 * use_nslog Option
 * debug Option
 * debug_flush MTA Option
 * PORT_ACCESS mapping table
 * dns_verify_domain Option
 * enable_rbl Option
 * Dispatcher