PMDF System Manager's Guide
Previous Contents Index

31.5.3 Operation

Each time PMM scans PMDF, it activates the PMDF scanning module. This module initializes PMDF. If PMDF cannot be initialized, either because PMDF has not been started or because of a serious configuration error, a fatal error is signalled back to PMM. If PMDF is running, the module "scans" PMDF and transmits back to PMM five different types of scanning records:

Software version

The software version record gives the version and link time of the PMDF shareable image, PMDF_SHARE_LIBRARY (OpenVMS) or libpmdf.so (UNIX). This is the single most critical image in PMDF and contains the core PMDF library routines. If this information cannot be obtained, an error is signalled to PMM.

Time zone

The time zone records show the numerical offset from Greenwich mean time (GMT) as well as the mnemonic time zone code (e.g., EST for Eastern Standard Time). If this information cannot be obtained, an error is signalled to PMM.

Queue (OpenVMS only)

A queue record containing current queue status information is sent for the MAIL$BATCH queue as well as each queue cited in the PMDF configuration file. If a queue cannot be located or information about it obtained, an error is signalled to PMM. If the queue is stalled, stopping, or stopped, a warning is signalled to PMM.

Job (OpenVMS only)

For each job queued to a PMDF processing queue, a job record is sent to PMM. Errors will be signalled if the periodic delivery or message bouncer jobs are missing from the MAIL$BATCH queue.

NCL

The PMDF channel counters for each channel are sent in twelve records; each record containing the value of a particular counter in its "Counter Value" field. For each set of twelve records, the name of the channel is given in the "Object Name" field. Each of the twelve records is distinguished by the value of the "Identifier" field in the record. The different values of that field and their interpretation are given in the table below.
  Identifier Description
+ Received messages Cumulative count of the messages enqueued to the channel
+ Enqueued messages Cumulative count of the messages enqueued (sent) by the channel
+ Stored messages Current count of the messages held by the channel and waiting to be processed
+ Dequeued messages Cumulative count of the messages processed by the channel
  Received recipients Cumulative count of the message recipients enqeued to the channel
  Enqueued recipients Cumulative count of the message recipients enqueued (sent) by the channel
  Stored recipients Current count of the message recipients held by the channel and waiting to be processed
  Dequeued recipients Cumulative count of the message recipients processed by the channel
  Received volume Cumulative size of the messages enqueued to the channel
  Enqueued volume Cumulative size of the messages enqueued (sent) by the channel
  Stored volume Current size of the messages held by the channel and awaiting processing
  Dequeued volume Current size of the messages processed by the channel
+For these counters, the rate of change (message/hour) and tendency (messages/hour/hour) are also reported, respectively, in the "Counter Derivative" and "Counter Tendency" fields.
If the channel counters cannot be obtained, an error is signalled to PMM.

Once all of these records have been transmitted back to PMM, the scanning module exits, awaiting a subsequent invocation by PMM.

Previous Next Contents Index