PURGEDIR

Purges (unlinks) one or more directories.

Syntax

 

PURGEDIR

dir=

dir

 

 

name

; CONFIRM NOCONFIRM

3

 

 

 

 

 

 

 

 

 

 

 

 

; TREE

2NOTREE3

USENAME 2

 

 

2

; SHOW NOSHOW

3

 

 

 

 

 

2 ; SHOWERRORS NOSHOWERRORS3

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

2

 

 

 

 

 

 

 

 

 

 

 

 

3

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Parameters

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

dir

 

name

The name of the directory that is being purged (required).

 

 

 

 

The dir

 

name is assumed to be an MPE name. HFS-named

 

 

 

 

 

 

 

directories may be purged if dir

 

 

name starts with a dot (.) or

 

 

 

 

 

 

 

 

a slash (/). If dir

 

name is an HFS name and ends in a slash,

 

 

 

 

 

 

 

then all objects at all lev els under and including dir

 

name

 

 

 

 

 

 

 

are purged, unless the NOTREE option is speci￿ed. The use of

 

 

 

wildcards is permitted. The dir

 

name cannot name root (/),

 

 

 

 

 

 

 

an MPE group, or an accoun t.

 

 

 

 

 

 

 

 

 

 

 

USENAME

This default option indicates that

dir

 

 

name alone controls

 

 

 

 

 

whether or not all lev els of directories and ￿les are deleted. 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 empt y.

 

 

 

 

 

 

 

USENAME only applies to HFS-named directories, and is ignored

 

 

 

for MPE-named directories.

 

 

 

 

 

 

 

 

 

 

 

TREE

Causes all objects belo w and including dir

 

name to be purged.

 

 

 

 

The dir

 

name may or may not end in a slash (/), with no error

 

 

 

 

 

 

 

or warning reported. Since the MPE naming con vention 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

Causes dir

 

name only to be purged if it is empt y. If dir

 

name

 

 

 

 

 

is an HFS name and ends in a slash (/), a w arning tells you

 

 

 

that NOTREE overrides the trailing slash (/).

2-186 MPE/iX Commands