zfsadm delete

Purpose

Removes a backup file system in a compatibility mode aggregate. Start of change Beginning in z/OS V2R2, .bak file systems can only be deleted on aggregates that are zFS owned on downlevel systems. End of change

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.

Start of change 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. End of change

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

The following command deletes the backup (clone) file system from its attached compatibility mode aggregate:

zfsadm delete OMVS.USER.PAT.bak

IOEZ00105I File System OMVS.USER.PAT.bak deleted successfully

Related information

Commands:

zfsadm attach
zfsadm detach
zfsadm lsfs

Files: File:

IOEFSPRM