Build a new, synchronized queue cache database.

Syntax

pmdf cache -rebuild

Command Qualifiers	Defaults
None.	None.

restrictions

Must have superuser privileges (UNIX) or be logged in as Administrator (NT) in order to use this utility.

Parameters

None.

Description

The pmdf cache -rebuild utility creates a new, synchronized queue cache database consisting of a directory containing several database files.

Rebuilding the queue cache database with this command should only be performed as a last resort, e.g., if disk problems have corrupted your queue cache database, as it will cause loss of some information from the queue cache database. (The sort of information lost includes, but is not limited to, message deferral dates, message expiration dates, and the original message owner information used by the pmdf qm utility to allow users to bounce their own messages.)

The command pmdf cache -close should be issued immediately after building the new queue cache so as to ensure that any detached processes close any I/O channels to the old database and open new channels to the new database.

On UNIX, the queue cache database directory is pointed at by the PMDF_QUEUE_CACHE_DATABASE option in the PMDF tailor file, /etc/pmdf_tailor, and hence is usually /pmdf/table/queue_cache. Although the new database will inherit the ownership and file protections of the previous database, it is a good idea to check afterwards that the new queue cache directory and files have the same uid as the /pmdf/queue and /pmdf/log directories and that the queue cache database directory and files are protected against group and world access (-rwx------).

On NT, the queue cache database directory is pointed at by the PMDF_QUEUE_CACHE_DATABASE Tailor registry entry, and hence is usually C:\pmdf\table\queue_cache.

EXAMPLES

To build a new queue cache database issue the UNIX commands

# pmdf cache -rebuild # pmdf cache -close # ... wait a few minutes.. # pmdf cache -synchronize

or the NT commands

C:\> pmdf cache -rebuild C:\> pmdf cache -close C:\> ... wait a few minutes.. C:\> pmdf cache -synchronize