MPE/iX Commands Reference Manual (32650-90877)

Chapter 10 389
Command List VIII
Commands PASCAL thru PURGEUSER
[ { ;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
• "N", "NO", or
Return to retain the directory
• "Q", "QUIT", or
Break to stop the PURGE command
The CONFIRMALL option is ignored in jobs and when you are purging a
single directory.
SHOW Displays to $STDLIST each file or directory under
dir_name that was
purged. Directory names are always displayed in an HFS syntax, even if
the name was specified as an MPE name.
NOSHOW Suppresses the display of each file and directory purged. NOSHOW is the