Chapter 6 453
Command Definitions P-R
PURGEDIR
• "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
default.
SHOWERROR Displays on $STDLIST each lower-level error that prevents an object below
dir_name from being deleted'. The object (file or directory) name is shown,
followed by the error message. By default, lower-level errors are not
displayed. SHOWERRORS is a synonym for SHOWERROR.
NOSHOWERROR Suppresses the display of low-level errors. NOSHOWERROR is the default.
`NOSHOWERRORS'' is a synonym for NOSHOWERROR.
Use
You can issue the PURGEDIR command from a job, a session, a program, or in BREAK.
Pressing
Break terminates execution of this command. You must have TD access to each
component in the dir_name pathname, and DD permission to the parent directory of
dir_name. (Refer to the ALTSEC command for more information on directory access.) If
wildcards are specified with dir_name, then RD access is required to the parent directory of
each wildcard component. If the purge is multilevel, then TD, RD and DD accesses are
necessary to each directory below dir_name.
Operation
The PURGEDIR command purges the directory dir_name. The dir_name cannot name an MPE
account, an MPE group, a file, or root (/). Dot (.) and dot-dot (..) can be specified but cannot
be purged.
By default PURGEDIR deletes an MPE-named directory. This means that dir_name must
follow all MPE naming rules, unless it is prefixed with a dot (.) or a slash (/). Since the
MPE name syntax defines three levels, fully (or partially) qualified MPE-named
directories can only be created under MPE groups. Unqualified MPE-named directories
are created relative to the CWD. Directories do not support lockwords, file equations, or
system defined file names (for example, $NEWPASS). If dir_name begins with a dot (.) or a
slash (/), then HFS naming rules are enforced.
The directory referenced by dir_name must be empty (except for dot (.) and dot-dot (..)) in
order to be purged, unless a TREE purge is requested. A TREE purge may be requested as
follows:
1. Specify the TREE option. (The dir_name parameter does not control a multilevel purge in
this case). This is the only choice available if dir_name is an MPE name.
