zfsadm delete
Purpose
Removes a backup file system in a compatibility mode aggregate. Beginning in z/OS V2R2, .bak file systems can only be deleted on aggregates that are zFS owned on downlevel systems.
This command will be removed in a future release.
Format
zfsadm delete -filesystem name [-aggregate name] [-level] [-help]
Options
- -aggregate name
- Specifies the name of the aggregate where the zFS file system resides. It is specified to qualify the zFS file system name (-filesystem) when there are multiple zFS file systems with the same name in different aggregates. The aggregate name is not case-sensitive. It is always folded to uppercase.
- -filesystem name
- Specifies the name of the backup file system to be removed. Include the .bak extension. The file system name is case-sensitive.
- -help
- Prints the online help for this command. All other valid options that are specified with this option are ignored.
- -level
- Prints the level of the zfsadm command. This is useful when you are diagnosing a problem. Except for -help, all other valid options that are specified with -level are ignored.
Usage
The zfsadm delete command removes the backup zFS file system that is indicated by the -filesystem option from its aggregate. The aggregate containing the file system to be deleted must be attached. Removing a backup file system does not remove the read/write file system.
Beginning in z/OS V2R2, no aggregates can be attached that contain more than one file system or a clone (.bak). Therefore, file systems can only be deleted from aggregates that are zFS owned on downlevel systems.
You can delete a compatibility mode file system (and its aggregate) by using the IDCAMS DELETE operation. This operation deletes the VSAM linear data set. For more information about renaming or deleting a compatibility mode aggregate, see Renaming or deleting a compatibility mode aggregate.
Privilege required
The issuer must have READ authority to the data set that contains the IOEFSPRM file and must be root or have READ authority to the SUPERUSER.FILESYS.PFSCTL resource in the z/OS® UNIXPRIV class. If you are instead using parmlib (IOEPRMxx), the issuer is required to be logged in as root or to have READ authority to the SUPERUSER.FILESYS.PFSCTL resource in the z/OS UNIXPRIV class.
Examples
zfsadm delete OMVS.USER.PAT.bak
IOEZ00105I File System OMVS.USER.PAT.bak deleted successfully
Related information
- zfsadm attach
- zfsadm detach
- zfsadm lsfs
- IOEFSPRM