Service Dispatcher error and debugging output (if enabled) are written
to the file dispatcher.log
in the PMDF log directory.
Debugging output may 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 .
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 denials to the
dispatcher.log file
|