PMDF User's Guide
OpenVMS Edition


Previous Next Contents Index


PURGE

Deletes all messages in the wastebasket folder.

Syntax

PURGE

Qualifiers Defaults
/RECLAIM /NORECLAIM
/STATISTICS /NOSTATISTICS

Parameters

None.

Description

The PURGE command irrevocably deletes all messages from the wastebasket folder of the currently open mail file. If no mail file is open, then your default mail file is opened and its wastebasket purged.

Purged message space is not available for reuse until a reclaim operation is performed. When the amount of deleted message space in the mail file exceeds 32,767 bytes, a reclaim operation is automatically done by the PURGE command. You can explicitly request a reclaim operation with the /RECLAIM qualifier. Note that when a reclaim operation is performed on your default mail file, you cannot receive new mail messages until the operation completes.

You can use the SHOW DELETED command to show the amount of unreclaimed, deleted message space in the current mail file.

An implicit PURGE command is done when you exit from PMDF MAIL with the EXIT command and the last opened mail file was your default mail file. To prevent a purge from occurring, either exit with the QUIT command or issue the command SET NOAUTO_PURGE. The effect of that SET command will be remembered even after you exit PMDF MAIL.


Qualifiers

/RECLAIM

/NORECLAIM (default)

Reclaim deleted message space. While purging your default mail file with PURGE/RECLAIM, you will not be able to receive new mail.

/STATISTICS

/NOSTATISTICS (default)

Produce a simple report detailing the results of the purge and any reclamation.

Examples

In the following example, the PURGE/RECLAIM/STATISTICS command is used to delete the messages from the wastebasket folder. The amount of deleted message space before and after the purge operation is displayed with the SHOW DELETED command.


EMAIL> SHOW DELETED
Mail file D1:[BOB]MAIL.MAI;1 
        contains 14125 deleted message bytes. 
EMAIL> PURGE/RECLAIM/STATISTICS
%EMAIL-I-RECLPLSWAIT, reclaiming deleted file space.  Please wait... 
Reclaim statistics: 
        Messages deleted:        15 
        Data buckets scanned:    18 
        Data buckets reclaimed:  13 
        Index buckets reclaimed: 0 
        Total buckets reclaimed: 13 
EMAIL> SHOW DELETED
Mail file D1:[BOB]MAIL.MAI;1 
        contains 0 deleted message bytes. 
EMAIL> 


Previous Next Contents Index