Purpose

Displays information about an aggregate, or all attached aggregates, if there is no specific aggregate specified.

Options

-aggregate name

Specifies the name of an aggregate about which information is to be displayed. The aggregate must be attached. The aggregate name is not case-sensitive. It is translated to uppercase. If this option is omitted, information is provided about all of the attached aggregates on the system. Compatibility mode aggregates are implicitly attached when they are mounted.

-fast

Causes the command to display a single line of output for each attached aggregate. See Usage for an explanation of the information that is displayed on each line.

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

-long

Causes the output of the command to be extended to display the following additional information about space usage in an aggregate:

• Version of the aggregate
• File system identification (auditfid)
• Indicates sysplex-aware when the aggregate is sysplex-aware for read/write
• Indicates converttov5 if the aggregate has the converttov5 attribute
• Number of free 8-KB blocks
• Number of free 1-KB fragments
• Size of the log file
• Size of the filesystem table
• Size of the bitmap file
• If the aggregate is quiesced, the job name, system name and the time stamp of when the quiesce occurred.

-system sysname

Specifies the name of the system that owns the attached aggregates for which the information is displayed.

Usage

The zfsadm aggrinfo command lists information about the total amount of disk space and the amount of disk space currently available on attached aggregates. The -aggregate option can be used to specify a single aggregate about which information is to be displayed. If this option is omitted, information about all aggregates that are attached in the sysplex (if shared file systems are being used) or the system is displayed. In a shared file system environment, you can limit the display to a single system by using the -system option. Compatibility mode aggregates are implicitly attached when they are mounted.

This command displays a separate line for each aggregate. Each line displays the following information:

• The aggregate name.
• Whether the aggregate is read/write (R/W) or read-only (R/O), it is a mounted compatibility mode aggregate (COMP) or an attached compatibility mode aggregate (MULT), or the aggregate is currently quiesced (QUIESCED), disabled (DISABLED), or both.
• The amount of space available in KB.
• The total amount of space in the aggregate in KB. (To grow an aggregate using the zfsadm grow command, specify a number larger than this number.)
• If -long is specified, the version of the aggregate, the auditfid, sysplex-aware if the aggregate is sysplex-aware for read/write, the converttov5 attribute, the number of free 8-KB blocks, the number of free 1-KB fragments, the size of the log file, the size of the file system table, the size of the bitmap file, and if the aggregate is quiesced, the job name, timestamp, and system name of the job.

Privilege required

If you are using an IOEFSPRM file in your zFS PROC, the issuer must have READ authority to the data set that contains the IOEFSPRM file. If you are using parmlib (IOEPRMxx), the issuer does not need special authorization.

Related information