zfsadm quiesce

Purpose

zfsadm quiesce specifies that an aggregate and the file system that is contained in it should be quiesced.

Options

-aggregate name

Specifies the name of the aggregate that is to be quiesced. The aggregate name is not case-sensitive. It is always translated to uppercase. An aggregate must be attached to be quiesced. All current activity against the aggregate is allowed to complete but no new activity is started. Any mounted file systems are quiesced.

-all

Specifies that all attached aggregates are to be quiesced. Use this option or use -aggregate.

-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 option is useful when you are diagnosing a problem. Except for -help, all other valid options that are specified with -level are ignored.

-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 quiesce command is used to temporarily drain activity to the aggregate. During this time:
   • The aggregate cannot be detached, or grown.
   • No activity can occur against mounted file systems.
   • If you attempt to unmount a quiesced compatibility mode aggregate, the attempt fails unless you specify unmount force.
2. The aggregate can be the target of lsaggr, aggrinfo, lsfs (file systems are indicated as busy). While at least one RWSHARE aggregate remains quiesced, message IOEZ00581E is displayed on the zFS owning system's console. Also, if there is at least one task that is waiting for access to the quiesced file system, message IOEZ00830E is displayed.
3. While an RWSHARE file system is quiesced, the command D OMVS,F displays QUIESCED in the PFS EXCP field.
4. The aggregate is typically quiesced prior to backing up the aggregate. After the backup is complete, the aggregate can be unquiesced.

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