zfsadm chaggr
Purpose
zfsadm chaggr changes the attributes of an aggregate.
Format
zfsadm chaggr -aggregate name
{-aggrfull{threshold,increment|OFF}|-aggrgrow {ON|OFF}|-rwshare|-norwshare }
[-trace file_name][-level][-help]
Options
- -aggregate name
- Specifies the name of the aggregate whose attributes will be changed. The aggregate name is not case-sensitive. It is translated to uppercase.
- -aggrfull threshold,increment | OFF
- Specifies the threshold and increment for reporting aggregate full error messages to the operator, or specifies that aggregate full error messages are not to be issued.
- -aggrgrow ON|OFF
- Specifies whether the aggregate is eligible to be dynamically grown.
- -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.
- -norwshare
- Specifies that the aggregate is to be made non-sysplex aware.
- -rwshare
- Specifies that the aggregate is to be made sysplex aware.
- -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
- All systems in the sysplex must be at least the V2R3 level in order to use the zfsadm chaggr command.
- The aggregate must be mounted.
- The threshold and increment values must be in the range 1-99.
- The -norwshare and -rwshare options will cause a samemode remount to be issued if the aggregate is mounted read/write. If the aggregate is mounted read-only, only the mount parameters are updated.
- In addition to changing the aggregate attributes, the zfsadm chaggr command
will also cause any corresponding zFS mount parameters to be updated in the z/OS UNIX couple data
set. When a mount parameter is updated, duplicate and related mount parameters are first removed and
the new mount parameter is added to the end of the mount parm string. Under certain error
conditions, the aggregate attributes and the mount parameters that are stored in the z/OS UNIX
couple data set might become mismatched. This will not affect how zFS behaves. It will only be of
concern if the aggregate is remounted using the mount parameters that are stored in the couple data
set.
If the mount parameters do not match the aggregate attributes, an aggregate might not have the same behavior after a remount. Because the mount parameters in a z/OS UNIX couple data set are ephemeral, any changes will not survive an unmount. Also, the mount parameters in a z/OS UNIX couple data set only reflect the zFS mount parameters that are explicitly specified on a mount or the zFS mount parameters that are explicitly changed with the zfsadm chaggr command. Hence the parameters might not represent all the aggregate attributes in use.
- The -aggrfull, -aggrgrow, -rwshare, and -norwshare options are mutually exclusive.
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.
Examples
- To show the current attributes of aggregate
PLEX.ZFS.SMALL1:
# zfsadm fsinfo plex.zfs.small1 File System Name: PLEX.ZFS.SMALL1 *** owner information *** Owner: DCEIMGVY Converttov5: OFF,n/a Size: 300240K Free 8K Blocks: 24337 Free 1K Fragments: 7 Log File Size: 3008K Bitmap Size: 48K Anode Table Size: 8K File System Objects: 7 Version: 1.5 Overflow Pages: 0 Overflow HighWater: 0 Thrashing Objects: 0 Thrashing Resolution: 0 Token Revocations: 0 Revocation Wait Time: 0.000 Devno: 36 Space Monitoring: 0,0 Quiescing System: n/a Quiescing Job Name: n/a Quiescor ASID: n/a File System Grow: ON,0 Status: RW,RS,NE,NC Audit Fid: C3C6C3F0 F0F203EC 0000 File System Creation Time: Nov 2 16:30:08 2015 Time of Ownership: Nov 2 16:30:21 2015 Statistics Reset Time: Nov 2 16:30:21 2015 Quiesce Time: n/a Last Grow Time: n/a Connected Clients: n/a Legend: RW=Read-write, RS=Mounted RWSHARE, NE=Not encrypted NC=Not compressed
- To change the mount mode of aggregate PLEX.ZFS.SMALL1 to
NORWSHARE:
# zfsadm chaggr plex.zfs.small1 -norwshare IOEZ00650I Successfully changed the attributes of aggregate PLEX.ZFS.SMALL1.
- To change aggregate PLEX.ZFS.SMALL1 to disallow dynamic
growing:
# zfsadm chaggr plex.zfs.small1 -aggrgrow off IOEZ00650I Successfully changed the attributes of aggregate PLEX.ZFS.SMALL1.
- To change aggregate PLEX.ZFS.SMALL1 to use space monitoring, with a threshold of 96 percent full
and an increment of
2%:
# zfsadm chaggr plex.zfs.small1 -aggrfull 96,2 IOEZ00650I Successfully changed the attributes of aggregate PLEX.ZFS.SMALL1.
- To display the new attributes of aggregate PLEX.ZFS.SMALL1. Note the changed values in File
System Grow, Space Monitoring, the Status area, and the
Legend:
# zfsadm fsinfo plex.zfs.small1 File System Name: PLEX.ZFS.SMALL1 *** owner information *** Owner: DCEIMGVY Converttov5: OFF,n/a Size: 300240K Free 8K Blocks: 37121 Free 1K Fragments: 7 Log File Size: 3008K Bitmap Size: 48K Anode Table Size: 8K File System Objects: 7 Version: 1.5 Overflow Pages: 0 Overflow HighWater: 0 Thrashing Objects: 0 Thrashing Resolution: 0 Token Revocations: 0 Revocation Wait Time: 0.000 Devno: 36 Space Monitoring: 96,2 Quiescing System: n/a Quiescing Job Name: n/a Quiescor ASID: n/a File System Grow: OFF,0 Status: RW,NS,NE,NC Audit Fid: C3C6C3F0 F0F203EC 0000 File System Creation Time: Nov 2 16:30:08 2015 Time of Ownership: Nov 2 17:03:23 2015 Statistics Reset Time: Nov 2 17:03:23 2015 Quiesce Time: n/a Last Grow Time: n/a Connected Clients: n/a Legend: RW=Read-write,NS=Mounted NORWSHARE,NE=Not encrypted NC=Not compressed
Related information
- zfsadm config
- zfsadm configquery
- zfsadm fsinfo
- MOUNT
- IOEFSPRM