zfsadm lsfs

Purpose

zfsadm lsfs lists all the file systems on a given aggregate or all attached aggregates.

Format

zfsadm lsfs [-aggregate name| -system sysname] [{-fast | -long}] [-level] [-help]

Options

-aggregate name: Specifies an aggregate name that is used to retrieve file system information. The aggregate name is not case-sensitive. It is always translated to uppercase. If this option is not specified, the command displays information for all attached aggregates.
-fast: Causes the output of the command to be shortened to display only the aggregate name.
-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 a file system: the allocation limit, the free space limit, the size of the inode table, the number of file requests, the version of the file system, the creation date and time, and the last update date and time.
-system sysname: Specifies the name of the system that owns the aggregates that contain the file systems to be displayed.

Usage

The zfsadm lsfs command displays information about file systems in aggregates. The file systems do not need to be mounted. The zfsadm lsfs command displays the following information for a specified aggregate or all attached aggregates on a system or all attached aggregates in the sysplex:

The total number of file systems that are contained in the aggregate.
The file system’s name (with a .bak extension, if appropriate).
The type (RW for read/write, or BK for backup).
Whether it is mounted.
The allocation usage and the free space usage, in kilobytes.
Whether the file system is online.
Whether the backup is being deleted.
The total number of file systems online, offline, busy, and mounted appear at the end of the output for all file systems.

If -fast is specified, it only displays the file system names.

If -long is specified, the following information is displayed:

Total number of file systems that are contained in the aggregate.
File system’s name.
File system’s ID.
The type (RW for read/write, or BK for backup).
Whether it is mounted or not.
State vector of the file system.
Whether the file system is online or not.
Whether the backup is being deleted.
Allocation limit and allocation usage.
Free space limit and free space usage.
Size of the Filesystem Inode Table and the number of file requests.
Version of the aggregate.
Day, date, and time when the file system was created.
Day, date, and time when the contents of the file system were last updated.
Total number of file systems online, offline, busy, and mounted appears at the end of the output for all file systems.

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.

Examples

The following example displays information for the aggregate OMVS.PRV.AGGR001.LDS0001:

zfsadm lsfs -aggregate omvs.prv.aggr001.lds0001 -long

IOEZ00129I Total of 1 file systems found for aggregate OMVS.PRV.AGGR001.LDS0001
OMVS.PRV.FS1 100000,,5 RW (Not Mounted)      states 0x10010005 On-line
    4294967232 K alloc limit;          9 K alloc usage
         25000 K quota limit;          9 K quota usage
         8 K Filesystem Inode Table    0 file requests

    version 1.4
    Creation Thu Aug  9 17:17:03 2001
    Last Update Thu Aug  9 17:17:03 2001

Total file systems online 1; total off-line 0; total busy 0; total mounted 0

Related information

Commands:

None