PMDF System Manager's Guide
PMDF-REF-6.0

Previous | Contents

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, 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.¹

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

¹ 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