MPE/iX Commands Reference Manual (32650-90864)

448 Chapter 6
Command Definitions P-R
PURGE
• "N", "NO", or Return to retain the file
• "Q", "QUIT", or
Break to stop the PURGE command
The CONFIRMALL option is ignored in jobs and when you are purging a
single file.
NOSHOW Suppresses the display of each successfully purged file. NOSHOW is the
default.
SHOW Displays the name of each successfully purged file.
SHOWERRORS Displays each lower-level error which prevents a file from being deleted.
The name of the file is shown, followed by the error message. By default
lower-level errors are not displayed. You may also enter this option in the
singular form, i.e. SHOWERROR.
NOSHOWERRORS Suppresses the display of low-level errors. NOSHOWERRORS is the default.
You may also enter this option in the singular form, i.e. NOSHOWERROR.
Operation Notes
• Usage
You can enter this command from a session, a job, a program, or in break mode.
Pressing Break does not affect this command.
You must have write access to a file to delete it.
• Purging unrecognized files
If the file does not exist in the specified domain, the following message appears:
FILE filename NOT FOUND, NO PURGE DONE. (CIWARN 383)
• Purging non-private spool files
You can purge a non-private spool file by entering PURGE filename. You must specify the
fully qualified file name (including .OUT.HPSPOOL). The PURGE command deletes the
specified spool file and all links to the spool file directory. The spool file does not print
after you purge it.
• Purging files with wildcards
You can use wildcards to remove multiple files at once. You can also use the
CONFIRMALL option to prevent accidental deletion of one or more files. Examples of the
wildcard feature are listed in the Examples section below:
Examples
• To delete a permanent file named PFILE, enter:
:PURGE PFILE
• To purge multiple files using wildcards