PMDF System Manager's Guide


Previous Contents Index


cache -close

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

Syntax

pmdf cache -close

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 -close utility is used to force all 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 files comprising the database so that the database can be modified, and to force processes to re-open the queue cache database files so as to begin using any new version of that database.

Sites using TCP/IP channels, PMDF-LAN Lotus Notes channels, PMDF-XGS, or PMDF-DIRSYNC Lotus Notes directory agents will have PMDF processes which may need to close channels to the database.1


EXAMPLES

After a new queue cache database is built with pmdf cache -rebuild, a pmdf cache -close command should be issued to force any detached processes to begin using the new database. On UNIX:


# pmdf cache -rebuild
# pmdf cache -close
# ... wait a minute or two ... 
# pmdf cache -synchronize
Or on NT:


C:\> pmdf cache -rebuild
C:\> pmdf cache -close
C:\> ... wait a minute or two ... 
C:\> pmdf cache -synchronize

Note

1 Also, customer-supplied detached processes which use the PMDF API routine PMDF_set_call_back may be notified of the need to close the queue cache database with the pmdf cache -close command.


Previous Next Contents Index