Purpose

The zfsadm configquery command queries the current value of zFS configuration options.

Options

-adm_threads

Displays the number of threads that are defined to handle pfsctl or mount requests.

-aggrfull

Displays the threshold and increment for reporting aggregate full error messages to the operator.

-aggrgrow

Displays whether an aggregate should be dynamically extended when it runs out of physical space.

-all

Displays the full set of configuration options.

-change_aggrversion_on_mount

Displays whether a version 1.4 aggregate should be changed to a version 1.5 aggregate when it is mounted.

-client_cache_size

Displays the size, in bytes, of the client cache. This is only meaningful when zFS is running sysplex-aware.

-client_reply_storage

Displays the number of bytes allocated for sysplex client reply storage. This is only meaningful when zFS is running sysplex-aware.

-cmd_trace

Displays whether command tracing is active.

-converttov5

Displays whether an aggregate should be assigned the converttov5 attribute on mount or remount. This attribute controls whether v4 directories will be converted to extended (v5) directories as they are accessed.

-convert_auditfid

Displays whether the zFS auditfid is automatically changed to the unique format on mount (attach). If on is specified or defaulted and the mount (attach) is read/write, the mount (attach) changes the standard auditfid format to the unique auditfid format. If off is specified or the mount (attach) is read-only, the auditfid is unaffected.

-debug_dsn

Displays the name of the debug input parameters data set.

-file_threads

Displays the current number of file threads. This is only meaningful when zFS is running sysplex-aware.

-format_aggrversion

Displays whether an aggregate formatting default should be a to format as a version 1.4 or 1.5 aggregate.

-fsfull

Displays the threshold and increment for reporting file system full error messages to the operator.

-group

Displays the XCF group that is used by zFS for communication between sysplex members.

-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 is useful when you are diagnosing a problem. Except for -help, all other valid options specified with -level are ignored.

-log_cache_size

Displays the size, in bytes, of the cache that is used to contain buffers for log file pages.

-meta_cache_size

Displays the size, in bytes, of the cache that is used to contain metadata.

-metaback_cache_size

Displays the size of the backing cache for metadata.

-msg_input_dsn

Displays the name of the data set that contains translated zFS messages.

-msg_output_dsn

Displays the name of a data set that contains any zFS initialization output messages that come from the zFS PFS.

-nbs

Controls the global new block security. zFS always runs with new block security on. If you use zfsadm config to set -nbs to off, it is displayed as off, but the value is not used.

-romount_recovery

Displays whether read-only mount recovery is on or off. When romount_recovery=on, zFS temporarily mounts the aggregate read/write to allow log recovery to run, and then zFS unmounts and mounts the aggregate again in read-only format.

-sync_interval

Displays the number of seconds in the interval that zFS flushes data in the buffers to disk.

-syslevel

Displays the zFS kernel (the PFS) information, including:

• The version and release of z/OS®
• The service level and FMID of zFS
• The date and time the PFS was built
• Whether the PFS is running sysplex-aware on a file system basis (referred to as filesys), or sysplex-aware on a system basis (referred to as file), or not sysplex-aware (referred to as admin-only), and the zFS XCF protocol level when running in a shared file system environment. (For information about the XCF protocol level, see Determining the XCF protocol interface level.) When filesys is indicated, the default mount PARM (NORWSHARE or RWSHARE) also displays.

This is the same information that is displayed by the operator command MODIFY ZFS,QUERY,LEVEL. In contrast, zfsadm configquery -level shows the level information for the zfsadm command itself.

-sysplex_filesys_sharemode

Displays the current default for the mount PARM (RWSHARE or NORWSHARE). It is only meaningful on systems running zFS sysplex=filesys.

-sysplex_state

Displays the sysplex state of zFS.

3

zFS is running in a sysplex-aware environment with sysplex=filesys.

-system sysname

Specifies the name of the system the report request is sent to retrieve the data requested.

-token_cache_size

Displays the current token_cache_size maximum. The current usage is displayed through the MODIFY ZFS,QUERY,STKM command. This is only meaningful when zFS is running sysplex-aware.

-trace_dsn

Displays the name of the data set that contains the output of any operator modify zfs,trace,print commands or the trace output if zFS abends.

-trace_table_size

Displays the size, in bytes, of the internal trace table.

-tran_cache_size

Displays the number of transactions in the transaction cache.

-user_cache_size

Displays the size, in bytes, of the cache that is used to contain file data.

-vnode_cache_size

Displays the number of vnodes that will be cached by zFS.

Usage

The zfsadm configquery command displays the current value of zFS configuration options. The value is retrieved from zFS address space memory rather than from the IOEFSPRM file. You can specify that the configuration option query request should be sent to another system by using the -system option.

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