zfsadm lsfs

Purpose

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

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.

-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 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 name of the file system (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.
   • The name of the file system.
   • The ID of the file system.
   • 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

The issuer does not need special authorization.

Related information