zfsadm detach

Purpose

zfsadm detach 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.

-trace file_name

Specifies the name of the file that will have the trace records written into it. The trace file can be a z/OS UNIX file, an existing MVS sequential data set, or a member of either an existing partitioned data set (PDS) or partitioned data set extended (PDSE). Use this option only at the direction of IBM Support.

For information about preallocation instructions for debugging, see Step 5 (Optional) Preallocate data sets for debugging in zFS installation and configuration steps.

Because MVS data set names must be fully qualified, z/OS UNIX has special rules for specifying MVS data set names in the shell environment. For more information, see Specifying MVS data set names in the shell environment in z/OS UNIX System Services Command Reference.

Usage notes

1. 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.
2. zfsadm detach does not detach mounted compatibility mode aggregates.

Privilege required

The issuer must be logged in as a root user (UID=0) or have READ authority to the SUPERUSER.FILESYS.PFSCTL resource in the z/OS® UNIXPRIV class.

Related information