Enable debugging output.

PASCAL

status = PMDF_debug

(enqueue_debug, dequeue_debug)

C

status = PMDFdebug

(enqueue_debug, dequeue_debug)

int PMDFdebug(int enqueue_debug, int dequeue_debug)

Arguments

enqueue_debug

When true, enables message enqueue debugging output. When false, disables message enqueue debugging output.

dequeue_debug

When true, enables message dequeue debugging output. When false, disables message dequeue debugging output.

Description

PMDF is capable of producing voluminous debugging output both while enqueuing and dequeuing messages. By default, this output is disabled. To enable either enqueue or dequeue debugging output, call PMDFdebug with the appropriate argument set true. Since any of the routines PMDFinitialize, PMDFenqueueInitialize, or PMDFdequeueInitialize can explicitly initialize the debugging flags, PMDFdebug should be called after calls to those routines have been made. Note that output of additional debugging information can be enabled by setting OS_DEBUG=1 in the PMDF option file. Setting DEQUEUE_DEBUG=1 in the PMDF option file is equivalent to setting the dequeuing debug flag to true with PMDFdebug; a similar relation holds between the PMDF option MM_DEBUG and the enqueuing debug flag. On OpenVMS systems, the debugging output will be written to PMDF_DEBUG: if defined and SYS$OUTPUT otherwise. On UNIX and Windows systems, debugging output will be written to stdout.

Return Values

PMDF__OK

Normal, successful completion.