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:
- The UDFS to be deleted must not be mounted.
- Only a user with input/output (I/O) system configuration (*IOSYSCFG) special authority can specify this command.
- The user must have object existence (*OBJEXIST) authority to all of the objects in the UDFS.
- The user must have write (*W) and execute (*X) authority to all of the non-empty directory objects in the UDFS.
- If any non-empty directory object in the UDFS has the "restricted rename and unlink" attribute set on (this attribute is equivalent to the S_ISVTX mode bit) then one or more of the following must be true:
- The user must be the owner of all the objects contained in the directory.
- The user must be the owner of the directory.
- The user must have all object (*ALLOBJ) special authority.
- The UDFS cannot be deleted if it contains an object with the "read only" attribute set to "yes" or if it contains an object that is checked out.
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 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.
- /dev/QASP01/udfsname.tmpudfs, where udfsname is the name of the user-defined file system. Because temporary user-defined file systems only exist in the system ASP, 'QASP01' must be specified as the ASP name.
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.
Note: This parameter is Unicode-enabled. See "Unicode support in CL" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/ for additional information.
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
- Directory contains objects. Directory is &1.
- CPFA1B8
- *IOSYSCFG authority required to use &1.
Top |