Delete User-Defined FS (DLTUDFS)

Where allowed to run: All environments (*ALL) Threadsafe: No

Parameters Examples Error messages

The Delete User-Defined File System (DLTUDFS) command deletes an existing and unmounted user-defined file system (UDFS) and all of the objects within it. The command will fail if the UDFS is mounted.

Restrictions:

1. The UDFS to be deleted must not be mounted.

2. Only a user with input/output (I/O) system configuration (*IOSYSCFG) special authority can specify this command.

3. The user must have object existence (*OBJEXIST) authority to all of the objects in the UDFS.

Top

---

 

Parameters

Keyword	Description	Choices	Notes
UDFS	User-defined file system	Path name	Required, Positional 1

Top

 

User-defined file system (UDFS)

Specifies the path name of the existing UDFS to be deleted. It must be in one of the following two forms:

• /dev/qaspXX/udfsname.udfs, where XX is one of the valid system or basic user auxiliary storage pool (ASP) numbers on the system, and udfsname is the name of the user-defined file system. All other parts of the name must appear as in the example above.

• /dev/aspname/udfsname.udfs, where aspname is one of the valid independent ASP names on the system, and udfsname is the name of the user-defined file system. All other parts of the name must appear as in the example above.

The name part of the path must be unique within the specified qaspXX or aspname directory.

Wildcard characters such as '*' and '?' are not allowed in this parameter. The command will fail if the UDFS specified is currently mounted.

This is a required parameter.

Top

---

 

Examples

Example 1: Deleting a User-defined File System

 DLTUDFS   UDFS('/dev/QASP01/joe.udfs')

This command deletes the user-defined file system (UDFS) named joe.udfs from the system auxiliary storage pool (ASP 1).

Top

---

 

Error messages

*ESCAPE Messages

CPFA0A9

Object not found. Object is &1.

CPFA09C

Not authorized to object. Object is &1.

CPFA09E

Object in use. Object is &1.

CPFA0AC

Request cannot be completed. Directory contains objects.

CPFA1B8

*IOSYSCFG authority required to use &1.

Top