zfsadm query

Purpose

zfsadm query displays internal zFS statistics (counters and timers) that are maintained in the zFS Physical File System (PFS).

Format

zfsadm query [-system sysname][-compress]
             [-locking][-reset][-storage][-usercache][-trancache]
             [-iocounts][-iobyaggregate][-iobydasd][-knpfs] -logcache]
             [-metacache][-dircache][-vnodecache][-ctkc][-svi][-stsm] 
             [-level][-help][-trace file_name] 

Options

-ctkc
Displays the sysplex client operations report. For more information about this report, see Statistics Sysplex Client Operations Information
-compress
Displays the compression statistics. For more information, see Statistics Compression Information.
-ctkc
Displays the sysplex client operations report. For more information about this report, see Statistics Sysplex Client Operations Information
-dircache
Displays the directory cache counters report. Beginning in z/OS® V1R13, this option is not meaningful; the report will show zeros. For more information about this report, see Statistics Directory Cache Information.
-help
Prints the online help for this command. All other valid options that are specified with this option are ignored.
-iobyaggregate
Displays the I/O count by aggregate report. For more information about this report, see Statistics Iobyaggr Information.
-iobydasd
Displays the I/O count by direct access storage device (DASD) report. For more information about this report, see Statistics Iobydasd Information.
-iocounts
Displays the I/O count report. For more information about this report, see Statistics Iocounts Information.
-knpfs
Displays the kernel counters report. 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. For more information about this report, see Statistics Kernel Information.
-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.
-locking
Displays the locking statistics report. For more information about this report, see Statistics Locking Information.
-logcache
Displays the log cache counters report. For more information about this report, see Statistics Log Cache Information.
-metacache
Displays the metadata cache counters report. For more information about this report, see Statistics Metadata Cache Information.
-reset
Resets the report counters to zero. Should be specified with a report type. The reset takes place after the current values are displayed. For example, if you enter zfsadm query -knpfs -reset, the command returns the current values for the kernel counters report before resetting to zero.
-stkm
Displays the server token manager report. For more information about this report, see Statistics Server Token Management Information.
-storage
Displays the storage report. For more information about this report, see Statistics Storage Information.
-svi
Displays the server vnode interface statistics report. For more information about this report, see Statistics Sysplex Owner Operations Information.
-system sysname
To retrieve the data requested, specifies the name of the system that will receive the report request.
-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.

-trancache
Displays the transaction cache counters report. Beginning with z/OS V2R2, this option is not meaningful; the report will show zeros. For more information about this report, see Statistics Transaction Cache Information.
-usercache
Displays the user cache report. For more information about this report, see Statistics User Cache Information.
-vnodecache
Displays the vnode cache counters report. For more information about this report, see Statistics Vnode Cache Information.

Usage notes

Use the zfsadm query command to display performance statistics that are maintained by the zFS Physical File System.

Privilege required

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 fsinfo
  • zfsadm lsaggr