HP 3000 Manuals HP 3000 Manuals
PURGE
This command deletes one or more files from the system.
Syntax
[{;CONFIRM }]
PURGE filereference[;TEMP] [[;ONERROR=] {CONTINUE}] [{;NOCONFIRM }]
[ {QUIT }] [{;CONFIRMALL}]
[{;NOSHOW}] [{;SHOWERRORS }]
[{;SHOW }] [{;NOSHOWERRORS}]
Parameters
filereference The actual file designator of the file to be
deleted, interpreted according to MPE-escaped
semantics filereference, can be either an MPE file
(i.e., one that uses MPE syntax) or it can be a
POSIX file name beginning with a dot or a slash.
For example, you can use the escaped pathname
/SYS/PUB/FILE since it is equivalent to the MPE
name FILE.PUB.SYS.
TEMP Specifies that the file is a temporary file in the
job/session temporary file domain. You can specify
a filename in MPE or HFS syntax and may name a
symbolic link that resolves to a filename. You
must enter this parameter to delete a temporary
file. The default is that a permanent file is
assumed.
CONTINUE Allows PURGE to continue until the end of the list
is reached, regardless of errors. CONTINUE is the
default option.
QUIT Quits the execution of PURGE when it encounters an
error and sets the CIERROR variable to the last
execution error.
CONFIRM Verifies the filereference parameter by requiring
you to validate the purge during command execution.
Valid responses are "YES" or "NO". If you respond
"YES", the PURGE command is executed. Pressing
Break at the prompt is equivalent to responding
"NO". CONFIRM is the default for sessions, unless
the filereference designates a single file.
NOCONFIRM Continues the purge without verification from the
user. NOCONFIRM is the default for jobs or if the
filereference designates a single file.
CONFIRMALL Requests verification for each file before the
purge is executed. A proper response is one of the
following:
* "Y" or "YES" to purge the file
* "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
:PURGE /users/jeff/bin/FILES/file@
3 FILES matched
Continue PURGE? (YES/NO) yes
3 selected. 3 succeeded. 0 failed.
* To purge multiple files interactively using wildcards
To purge a number of files, one at a time, in an interactive mode
so that you can skip a file or stop your purge, you can use the
CONFIRMALL option.
:PURGE /users/jeff/bin/FILES/file@; CONFIRMALL
3 FILES matched
/users/jeff/bin/FILES/file1 ? (NO/YES/QUIT) yes
/users/jeff/bin/FILES/file2 ? (NO/YES/QUIT) no
/users/jeff/bin/FILES/file3 ? (NO/YES/QUIT) yes
2 selected. 2 succeeded. 0 failed.
Type "q","quit", or press the BREAK key if you decide to stop the
PURGE command completely.
* To purge log files using wildcards
The following example shows you how to purge all log files within
your current working directory that start with log, followed by
any number from 0 - 9 (#), followed by any number of alphanumeric
characters (@).
:PURGE log#@
10 FILES matched
Continue PURGE? (YES/NO) yes
10 selected. 9 succeeded. 1 failed.
Since the PURGE command does not remove the currently opened log
file, the command always returns "1 failed".
Related Information
Commands ALTSEC, BUILD, LISTFILE, LISTSPF
Manuals None