zfsadm config

Purpose

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

Format

zfsadm config [-adm_threads number]
              [-user_cache_size cache_size[,fixed|edcfixed]]
              [-meta_cache_size cache_size[,fixed]]
              [-log_cache_size cache_size[,fixed]]
              [-sync_interval number][-vnode_cache_size number][-nbs {ON|OFF}]
              [-fsfull threshold,increment] [-aggrfull threshold,increment][-trace_dsn dataset_name]
              [-tran_cache_size number][-msg_output_dsn dataset_name]              
              [-metaback_cache_size cache_size[,fixed]][-aggrgrow {ON|OFF}]
              [-vnode_cache_limit number][-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}] 
              [-modify_cmd_threads number] [-honor_syslist {ON|OFF}] 
              [-long_cmd_threads foreground,background]
              [-smf_recording {ON|ON,intvl|OFF}]  
              [-format_encryption {ON|OFF}] 
              [-edc_buffer_pool storage_size]  
              [-format_perms number][-system sysname]
              [-trace file_name] [-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 were already mounted until they have been unmounted and remounted. Those options are as follows:
  • aggrfull
  • aggrgrow
  • convert_auditfid
  • change_aggrversion_on_mount
  • converttov5
  • fsfull
  • sysplex_filesys_sharemode
-adm_threads number
Specifies the number of threads that are defined to handle pfsctl or mount requests.
-aggrfull threshold,increment
Specifies the threshold and increment for reporting aggregate full error messages to the operator.
Default value: None.
-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.
-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. This option is not supported; if it is specified, it is accepted but not used.
-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 not affected.
-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.
-edc_buffer_pool number
Specifies how much real storage will be permanently fixed by zFS for encryption and compression I/O.
-format_aggrversion 4 | 5
Specifies whether a version 1.4 aggregate or a version 1.5 aggregate should be formatted by default.
-format_compression ON | OFF
Specifies whether a newly created zFS aggregate will be formatted with compression.
-format_encryption ON | OFF
Specifies whether a newly created zFS aggregate will be formatted with encryption.
-file_threads number
Specifies the current number of file threads. This option is only meaningful when zFS is running sysplex-aware.
-format_perms number
Specifies the permissions that are used for the root directory of the file system during a format when the -perms option is not specified. The valid values are in the range 0 to o7777. The number can be specified as octal (for example, o755), as hexadecimal (for example, x1ED), or as decimal (for example, 493).
-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 that are specified with this option are ignored.
-honor_syslist ON | OFF
Specifies whether to use the z/OS UNIX AUTOMOVE options when determining the new zFS owner. The -honor_syslist option is no longer supported. Its value can be changed but is ignored when moving zFS ownership. For more information about zFS ownership movement, see Dynamic movement of the zFS owner.
-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.
-log_cache_size number [,fixed]
Specifies the size, in bytes, of the cache that is used to contain buffers for log file pages. The fixed option reserves real storage for usage by zFS only.
-long_cmd_threads <foreground,background>
Specifies the number of foreground and background threads that are defined to handle long-running administrative commands.
-meta_cache_size number [,fixed]
Specifies the size, in bytes, of the cache that is used to contain metadata. The fixed option reserves real storage for usage by zFS only.
-metaback_cache_size number
Specifies the size of the metadata backing cache. This size is combined with meta_cache_size to get the total size of the metadata cache.
-modify_cmd_threads number
Specifies the current number of threads that are defined to handle zFS modify commands.
-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 not supported. If it is 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 log recovery must be run for this aggregate. This situation 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 be run before the mount can be successful. If the ON is specified and this situation occurs, zFS temporarily mounts the aggregate read/write to allow log recovery to run. After the log recovery is run, zFS unmounts and then mounts the aggregate read-only.
-smf_recording ON | ON,intvl | OFF
Specifies that data is to be collected and recorded by System Management Facilities (SMF).
ON
Specifies that SMF is to collect and record zFS data.  The SMF parameters that were previously set determines the type that is recorded and the recording interval that is used. For more information about SMF, see z/OS MVS System Management Facilities (SMF).
ON,intvl
Specifies that SMF is to collect and record zFS data at intvl interval. The SMF parameters that were previously set determines the type of data that is recorded, but the SMF interval is overridden by the intvl specification. The intvl option specifies the number of minutes between periodic recording of statistics.
OFF
Specifies that SMF is not to collect and record zFS data.
-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 is 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 option 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. This option is not supported; if it is specified, it is accepted but not used.
-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.

-user_cache_size number [,fixed|edcfixed]
Specifies the size, in bytes, of the cache that is used to contain file data. The fixed and edcfixed options can fix the user file cache in real memory.
  • The fixed option avoids page fix and page unfix for disk I/Os that do not use compression.
  • The edcfixed option avoids page fix and page unfix for disk I/Os that use compression. It also avoids data movement for compression I/Os.
-vnode_cache_size number
Specifies the number of vnodes that zFS will cache.

Usage notes

  1. 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 by using the zfsadm config command:
    • -cmd_trace
    • -debug_dsn
    • -group
    • -msg_input_dsn
    • -trace_table_size
    • -sysplex_state

Privilege required

The issuer must be logged in as a root user (UID=0) or 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

Commands:
  • zfsadm configquery
Files:
  • IOEFSPRM