MPE/iX Commands Reference Manual (32650-90877)

390 Chapter10
Command List VIII
Commands PASCAL thru PURGEUSER
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.
2. If
dir_name is an HFS name, ends in a slash (/), and the ;NOTREE option is not
requested, then a TREE purge occurs.
The
dir_name parameter cannot reference root (/) because purging root is undesirable, and
most likely is not what is intended.
A file or directory is not deleted if it is being accessed (opened); however, all non-accessed
objects under
dir_name are still purged. A final "IN USE" error indicates that dir_name
was not deleted because one or more children objects could not be removed.
If CONFIRM is specified while your session is interactive, and it is legal for you to purge
dir_name , then you are prompted to confirm the purge of dir_name . If a NOTREE purge is
requested, the following prompt is displayed: