zfsadm detach

Purpose

Detaches one or more aggregates from zFS. Any file systems contained in the detached aggregate are unavailable to zFS.

Options

-aggregate aggregate name

Specifies the aggregate name of the aggregate to be detached. Use this option or use -all, but not both. The aggregate name is not case-sensitive. It is always translated to uppercase.

-all

Specifies that all attached aggregates in the sysplex are to be detached. Use this option or use -aggregate but not both.

-help

Prints the online help for this command. All other valid options specified with this option are ignored.

-level

Prints the level of the zfsadm command. This option is useful when you are diagnosing a problem. Except for -help, all other valid options specified with -level are ignored.

-system sysname

Specifies the name of the system where the aggregates to be detached reside. It cannot be specified without the -all option.

Usage

The zfsadm detach command is used to detach an aggregate. Detaching an aggregate makes it unavailable to the system. To detach one or more aggregates, use the -all or the -aggregate option to specify the aggregates to be detached. Use the -system option to limit the detach to a single system. The -system option cannot be specified without the -all option.

zfsadm detach does not detach mounted compatibility mode aggregates.

Privilege required

The issuer must have READ authority to the data set that contains the IOEFSPRM file and must be logged in as root or have READ authority to the SUPERUSER.FILESYS.PFSCTL resource in the z/OS® UNIXPRIV class. If you are not using IOEFSPRM but instead, you are 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.

Related information