zfsadm config

Purpose

Changes the value of zFS configuration (IOEFSPRM) options in memory. See The zFS configuration options file (IOEPRMxx or IOEFSPRM) for a complete list of IOEFSPRM options.

Format

zfsadm config [-admin_threads number] [-user_cache_size number[,fixed]]
              [-meta_cache_size number[,fixed]] [-log_cache_size number[,fixed]]
              [-sync_interval number] [-vnode_cache_size number] [-nbs {on|off}]
              [-fsfull threshold,increment] [-aggrfull threshold,increment]
              [-trace_dsn PDSE_dataset_name] [-tran_cache_size number] 
              [-msg_output_dsn Seq_dataset_name] [-metaback_cache_size number[,fixed]]
              [-aggrgrow {on|off}] [-romount_recovery {on|off}]
              [-convert_auditfid {on|off}] [-client_reply_storage storage size]
              [-file_threads number]	[-client_cache_size cache size[,fixed]]
              [-token_cache_size cache size] [-sysplex_filesys_sharemode {rwshare|norwshare}]
              [-change_aggrversion_on_mount {on | off}] 
              [-format_aggrversion {4 | 5}] [-converttov5 {on | off}]
              [-system sysname] [-level] [-help]

Options

When you change options that apply to zFS aggregates and file systems, the current default changes. However, the change does not affect file systems that have already been mounted until they have been unmounted and remounted. This includes:

aggrfull
aggrgrow
convert_auditfid
change_aggrversion_on_mount
converttov5
fsfull
sysplex_filesys_sharemode

-admin_threads number: Specifies the number of threads defined to handle pfsctl or mount requests.
-aggrfull threshold,increment: Specifies the threshold and increment for reporting aggregate full error messages to the operator.
-aggrgrow on | off: Specifies whether an aggregate should be dynamically extended when it runs out of physical space.
-change_aggrversion_on_mount on | off: Specifies whether an aggregate should be changed to a version 1.5 aggregate on mount. The default is off.
-client_cache_size cache size[,fixed]: Specifies the size, in bytes, of the client cache. This is only meaningful when zFS is running sysplex-aware.
-client_reply_storage storage size: Specifies the number of bytes allocated for sysplex client reply storage. This is only meaningful when zFS is running sysplex-aware.
-convert_auditfid on | off: Specifies whether the zFS auditfid is automatically changed to the unique format on mount (attach). If on is specified, or defaulted, mount (attach) changes the standard auditfid format to the unique auditfid format if the mount (attach) is read/write. If off is specified (or the mount (attach) is read-only), the auditfid is unaffected.
-converttov5 on | off: Specifies whether directories in a version 1.5 aggregate should be converted from v4 directories to extended (v5) directories as they are accessed. A version 1.4 aggregate is changed to a version 1.5 aggregate. You can override this setting at mount time by specifying CONVERTTOV5 or NOCONVERTTOV5.
-file_threads number: Specifies the current number of file threads. This is only meaningful when zFS is running sysplex-aware.
-format_aggrversion 4 | 5: Specifies whether a version 1.4 aggregate or a version 1.5 aggregate should be formatted by default.
-fsfull threshold,increment: Specifies the threshold and increment for reporting file system full error messages to the operator.
-help: Prints the online help for this command. All other valid options 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 number [,fixed]: Specifies the size, in bytes, of the cache used to contain buffers for log file pages. The fixed option reserves real storage for usage by zFS only.
-meta_cache_size number [,fixed]: Specifies the size, in bytes, of the cache used to contain meta data. The fixed option reserves real storage for usage by zFS only.
-metaback_cache_size number [,fixed]: Specifies the size of the backing cache for meta data. The fixed option reserves real storage for usage by zFS only.
-msg_output_dsn Seq_dataset_name: Specifies the name of a data set that contains any output messages that come from the zFS PFS.
-nbs on | off: Controls the global new block security. zFS always runs with new block security on. The off option is no longer supported; if specified, it is accepted but not used.
-romount_recovery on | off: Specifies whether zFS will automatically avoid a read-only mount failure (zFS reason code EFxx6271) because of the need to run log recovery for this aggregate. This can occur when the aggregate has been mounted read/write and a failure occurred before it was unmounted. If the next mount is for read-only, log recovery needs to run for the mount to be successful. If on is specified and this situation occurs, zFS temporarily mounts the aggregate read/write to allow log recovery to run and then zFS will unmount and then mount the aggregate read-only.
-sync_interval number: Specifies the number of seconds between the times where zFS flushes data in its buffers to disk. The default is 30 seconds.
-sysplex_filesys_sharemode rwshare | norwshare: Specifies the default for the mount PARM when a zFS read/write file system is mounted on a sysplex=filesys system. You can override this setting at mount time by specifying an alternate value in the actual mount PARM.
-system sysname: Specifies the name of the system that the configuration option change request will be sent to.
-token_cache_size cache size: Specifies the token cache size maximum. When the token_cache_size is decreased, it is really the maximum size that is being decreased. This is only possible if the current usage is less than the maximum size. The token cache size cannot be decreased to lower than the current usage. The current usage is displayed through the MODIFY ZFS,QUERY,STKM command. This is only meaningful when zFS is running sysplex-aware.
-trace_dsn PDSE_dataset_name: Specifies the name of a data set that contains the output of any operator MODIFY ZFS,TRACE,PRINT commands or the trace output if zFS abends.
-tran_cache_size number: Specifies the number of transactions in the transaction cache.
-user_cache_size number [,fixed]: Specifies the size, in bytes, of the cache used to contain file data. The fixed option reserves real storage for usage by zFS only.
-vnode_cache_size number: Specifies the number of vnodes that will be cached by zFS.

Usage

The zfsadm config command changes the configuration options (in memory) that were specified in the IOEFSPRM file (or defaulted). The IOEFSPRM file is not changed. If you want the configuration specification to be permanent, you must modify the IOEFSPRM file because zFS reads the IOEFSPRM file to determine the configuration values when zFS is started. The values that can be specified for each option are the same as the values that can be specified for that option in the IOEFSPRM file. You can specify that the configuration option change request should be sent to another system by using the -system option. The following options cannot be set using the zfsadm config command:

-cmd_trace
-debug_dsn
-group
-msg_input_dsn
-trace_table_size
-sysplex_state

Privilege required

The issuer must have READ authority to the data set that contains the IOEFSPRM file and must be root or have READ authority to the SUPERUSER.FILESYS.PFSCTL resource in the z/OS® UNIXPRIV class. If you are not using IOEFSPRM but instead, you are using parmlib (IOEPRMxx), the issuer is required to be logged in as root or to have READ authority to the SUPERUSER.FILESYS.PFSCTL resource in the z/OS UNIXPRIV class.

Examples

The following example changes the size of the user cache:

zfsadm config -user_cache_size 64M

IOEZ00300I Successfully set -user_cache_size to 64M

Related information

Command:

zfsadm configquery

File:

IOEFSPRM