PMDF System Manager's Guide


Previous Contents Index

11.6 Debugging and Log Files

Service Dispatcher error and debugging output (if enabled) are written to the file dispatcher.log in the PMDF log directory.

Debugging output can be enabled using the option DEBUG in the Dispatcher configuration file, or on a per-process level, via the PMDF_DISPATCHER_DEBUG logical (OpenVMS) or environment variable (UNIX or NT).

The DEBUG option or PMDF_DISPATCHER_DEBUG logical name (OpenVMS) or environment variable (UNIX or NT) 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 11-2.

Table 11-2 Dispatcher debugging bits
Bit Hexadecimal Decimal Usage
  value value  
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 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 handoffs
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 mapping, DNS_VERIFY_DOMAIN, and ENABLE_RBL denials to the dispatcher.log file


Previous Next Contents Index