PMDF System Manager's Guide
Previous Next Contents Index

CACHE/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.

restrictions

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

Parameters

None.

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, or the PMDF-DIRSYNC Lotus Notes directory agent will have detached PMDF processes which may need to close channels to the database.1

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

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 CACHE/CLOSE command.

Previous Next Contents Index