452 Chapter 6
Command Definitions P-R
PURGEDIR
PURGEDIR
Purges (unlinks) one or more directories.
Syntax
PURGEDIR[ dir=] dir_name
[ { ;TREE ;NOTREE ;USENAME } ]
[ { ;CONFIRM ;NOCONFIRM ;CONFIRMALL } ]
[ { ;NOSHOW ;SHOW}][{ ;SHOWERROR ;NOSHOWERROR } ]
Parameters
dir_name The name of the directory that is being purged (required). The dir_name is
assumed to be an MPE name unless you begin it with a dot (.) or a slash (/)
to indicate an HFS directory.
If dir_name is an HFS directory that ends in a slash and you don't include
the NOTREE option, PURGEDIR deletes all objects at all levels under and
including dir_name.
The use of wildcards is permitted. The dir_name cannot name root (/), an
MPE group, or an account.
TREE Purges all objects below and including dir_name. The dir_name may or may
not end in a slash (/), with no error or warning reported. Since the MPE
naming convention does not support a trailing slash (/), the TREE option is
the only way to delete a non-empty, MPE-named directory with a single
command.
NOTREE Purges dir_name only if it is empty. If dir_name is an HFS name and ends in
a slash (/), a warning tells you that NOTREE overrides the trailing slash (/).
USENAME Indicates that dir_name alone controls whether or not all levels of
directories and files are deleted. (This is the default.) If dir_name is an HFS
name and ends in a slash (/), then it, and all objects under it are deleted. If
dir_name does not end in a slash (/), then only dir_name is purged, assuming
it is empty. USENAME only applies to HFS-named directories, and is ignored
for MPE-named directories.
CONFIRM Requires the user to confirm the purge of the directory. A different prompt
is seen depending on whether dir_name is to be purged with the TREE
option or with the trailing slash feature. CONFIRM is the default for
sessions. CONFIRM is ignored for jobs.
NOCONFIRM Purges dir_name (and all objects under it for TREE purges) without user
confirmation. NOCONFIRM is the default for jobs.
CONFIRMALL Requires the user to confirm each directory before the purge is executed. A
proper response is one of the following:
• "Y" or "YES" to purge the directory
