zfsadm query

Purpose

Displays internal zFS statistics (counters and timers) maintained in the zFS Physical File System (PFS).

Format

zfsadm query [-system sysname] [-locking] [-reset] [-storage] [-usercache] [-trancache]
             [-iocounts] [-iobyaggregate] [-iobydasd] [-knpfs] [-logcache]
             [-metacache] [-dircache] [-vnodecache] [-level] [-help]

Options

-dircache: Specifies that the directory cache counters report should be displayed. Beginning with z/OS® V1R13 this option is not meaningful; the report shows zeros.
-help: Prints the online help for this command. All other valid options specified with this option are ignored.
-iobyaggregate: Specifies that the I/O count by aggregate report should be displayed.
-iobydasd: Specifies that the I/O count by Direct Access Storage Device (DASD) report should be displayed.
-iocounts: Specifies that the I/O count report should be displayed.
-knpfs: Specifies that the kernel counters report should be displayed. This option only displays counters for PFS calls on the zFS owner. It does not display (a second set of) counters for PFS calls when this system is a zFS client.
-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 specified with -level are ignored.
-locking: Specifies that the locking statistics report should be displayed.
-logcache: Specifies that the log cache counters report should be displayed.
-metacache: Specifies that the metadata cache counters report should be displayed.
-reset: Specifies the report counters should be reset to zero. Should be specified with a report type. The reset takes place after displaying the current values. For example, if you enter zfsadm query -knpfs -reset, the command returns the current values for the kernel counters report before resetting to zero.
-storage: Specifies that the storage report should be displayed.
-system sysname: Specifies the name of the system the report request will be sent to, to retrieve the data requested.
-trancache: Specifies that the transaction cache counters report should be displayed.
-usercache: Specifies that the user cache report should be displayed.
-vnodecache: Specifies that the vnode cache counters report should be displayed.

Usage

The zfsadm query command is used to display performance statistics maintained by the zFS Physical File System.

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 is one of the queries that displays performance statistics.

zfsadm query -iobyaggr

                     zFS I/O by Currently Attached Aggregate
DASD   PAV
VOLSER IOs Mode  Reads       K bytes     Writes      K bytes     Dataset Name
------ --- ----  ----------  ----------  ----------  ----------  ------------
CFC000   1  R/W          13          92        7641       30564  PLEX.JMS.AGGR001.LDS0001
CFC000   1  R/O           9          60           0           0  PLEX.JMS.AGGR002.LDS0002
CFC000   1  R/W          26         188        4483       17952  PLEX.JMS.AGGR004.LDS0004
------ --- ----  ----------  ----------  ----------  ----------  ------------
     3                   48         340       12124       48516  *TOTALS*

Total number of waits for I/O:         52
Average I/O wait time:                 3.886 (msecs)

Related information

Commands:

zfsadm lsaggr