1    /CLOSE

    Force detached PMDF processes to close any open I/O channels to
    the queue cache database.

    Syntax

      PMDF CACHE/CLOSE

    Command Qualifiers    Defaults

    None.                 None.

1.1  –  Restrictions

    SYSLCK privilege is required to in order to use this utility.

1.2  –  Parameters

    None.

1.3  –  Description

    The CACHE/CLOSE utility is used to force, cluster-wide, all
    detached PMDF processes to close any open I/O channels that they
    have to the queue cache database. This is generally done for
    two reasons: to close all channels to the file so that it can be
    modified, and to force detached processes to re-open the queue
    cache database file so as to begin using any new version of that
    database.

    Sites using the TCP/IP channel, PMDF-LAN Lotus Notes channels,
    PMDF-XGS, Jnet (BN_SLAVE), the PMDF-DIRSYNC Lotus Notes directory
    agent, or FAX receive processes will have detached PMDF processes
    which may need to close channels to the database.

1.4  –  Examples

      After a new queue cache database is built with CACHE/REBUILD,
      a CACHE/CLOSE command should be issued to force any detached
      processes to begin using the new database:

        $ PMDF CACHE/REBUILD
        $ PMDF CACHE/CLOSE
        $ ! ...wait a minute or two...
        $ PMDF CACHE/SYNCH

2    /REBUILD

    Build a new, synchronized queue cache database.

    Syntax

      PMDF CACHE/REBUILD

    Command Qualifiers    Defaults

    None.                 None.

2.1  –  Restrictions

    Requires sufficient privileges to create a file in the PMDF_
    TABLE: directory, and to scan the PMDF_QUEUE:[*] directories.

2.2  –  Parameters

    None.

2.3  –  Description

    The CACHE/REBUILD utility creates a new, synchronized queue cache
    database. 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 is owned by the same
    UIC as the QUEUE.DIR and LOG.DIR files in the PMDF_ROOT:[000000]
    directory and that the file is protected against group and world
    access (S:RWED,O:RWED,G,W).

    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
    creation dates, 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.

    The queue cache database is the file pointed at by the PMDF_
    QUEUE_CACHE_DATABASE logical. Normally, this is the file QUEUE_
    CACHE.DAT in the PMDF_TABLE: directory. This file should be
    protected against world and group access and be owned by the same
    UIC as the directory files QUEUE.DIR and LOG.DIR in the PMDF_
    ROOT: directory.

2.4  –  Examples

      To build a new queue cache database issue the commands

        $ PMDF CACHE/REBUILD
        $ PMDF CACHE/CLOSE
        $ ! wait a minute or two
        $ PMDF CACHE/SYNCH

3    /SYNCHRONIZE

    Update the queue cache database so as to reflect all messages
    currently present in the message queues.

    Syntax

      PMDF CACHE/SYNCHRONIZE

    Command Qualifiers    Defaults

    None.                 None.

3.1  –  Restrictions

    Requires sufficient privileges to scan the PMDF_QUEUE:[*]
    subdirectories and add entries to the queue cache database.

3.2  –  Parameters

    None.

3.3  –  Description

    The CACHE/SYNCHRONIZE utility updates the active queue cache
    database by updating it to reflect all non-held message files
    currently present in the PMDF_QUEUE:[*] subdirectories.

    The PMDF CACHE/CLOSE command does not need to be issued in
    conjunction with the PMDF CACHE/SYNCHRONIZE command.

    The queue cache database is the file pointed at by the PMDF_
    QUEUE_CACHE_DATABASE logical. Normally, this is the file QUEUE_
    CACHE.DAT in the PMDF_TABLE: directory. This file should be
    protected against world and group access and be owned by the same
    UIC as the directory files QUEUE.DIR and LOG.DIR in the PMDF_
    ROOT: directory.

3.4  –  Examples

      To synchronize the queue cache, for instance after renaming a
      message file, issue the command

        $ PMDF CACHE/SYNCHRONIZE