dsadm config

Purpose

dsadm config changes the value of the DSFS configuration file (IDFFSPRM) options in memory. For a complete list of IDFFSPRM options, see The DSFS configuration file (IDFPRMxx or IDFFSPRM).

Options

-directory_pool size <number>

Specifies the number of processing threads used to handle directory requests that require access to DFSMS data sets or catalogs.

-directory_refresh_timeout <number>

Specifies the length of time in seconds between successive catalog searches to verify that the DSFS cached directory contents match those of the catalog for HLQ directories. It is also the length of time in seconds between successive PDSE directory searches to verify that the DSFS cached directory contents match those of the PDSE data set.

-enable sysout <on | off>

Specifies whether users are allowed to access JES spool data sets.

-filecache_size <cache_size [,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 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. DSFS will automatically fix the cache in edcfixed format if the utility file system is enabled for compression.

-fsfull <(threshold,increment) | off>

Specifies the threshold and increment when sending file system utilization messages to the operator.

-hlq_list_add [ <hlq1,hlq2,…> ]

Allows the administrator to add high-level qualifiers that are to be excluded. The -hlq_list_add and -hlq_list_remove options are mutually exclusive. They cannot be specified at the same time with the same dsadm config command.

• The high-level qualifiers that are listed must be separated by commas with no intervening spaces.
• The specified high-level qualifiers can consist of one or more qualifiers.
• After a high-level qualifier is added to the HLQ list, the associated HLQ directories are removed from the UNIX tree after all users finish accessing objects in the HLQ directory subtree.

-hlq_list_remove <hlq1,hlq2,…>

Allows the administrator to remove high-level qualifiers from the list. The -hlq_list_add and -hlq_list_remove options are mutually exclusive. They cannot be specified at the same time with the same dsadm config command.

• The high-level qualifiers that are listed must be separated by commas with no intervening spaces.
• The specified high-level qualifiers can consist of one or more qualifiers.

-io_pool_size <number>

Specifies the number of DSFS worker threads that are used to process data set IO requests using the QSAM access methods.

-ispf_extended_statistics <ON | OFF>

Specifies whether DSFS should retrieve and store ISPF extended statistics when processing PDS and PDSE members.

-pds_enq_duration <number>

Specifies the number of seconds that DSFS will hold enqueues on PDS/PDSE data sets, which allows DSFS to cache their directory contents for that period of time and reduce the number of calls to read the PDS/PDSE data set directory.

-pds_interval <number>

Specifies the number of seconds between the time a DSFS task will look at cached PDS and PDSE directories to determine whether they have exceeded their enqueue duration. If so, then it releases the enqueue.

-ps_dyn_duration <number>

Specifies the number of seconds that DSFS will hold a dynamic allocation on PDS/PDSE members and PS data sets. Holding the dynamic allocation allows DSFS to cache their contents for that period of time and reduces the number of calls to read the data set.

-ps_interval <number>

Specifies the number of seconds between the time a DSFS task will look at cached PDS/PDSE members and PS data sets to determine whether they have exceeded their dynamic allocation duration. If so, then it releases the allocation, which will cause DSFS to uncache the file's contents.

-security_pool_size <number>

Specifies the number of DSFS worker threads that are used to process SAF security calls.

-security_timeout <number>

Specifies the number of seconds that DSFS will use its cached security access query for a user's access to a data set. If the number of seconds since the last query exceeds this value, then DSFS will make another query to the SAF product to determine the user's access.

-sysout_directory_pool_size <number>

Specifies the number of processing threads used to handle sysout directory requests that require access to the subsystem interface (SSI).

-sysout_io_pool_size <number>

Specifies the number of DSFS worker threads that are used to process IO requests from the sysout data set by using the QSAM access methods.

-trace <file_name>

Specifies the name of the file that will have the trace records written into it. The trace file should be a z/OS UNIX file.

-level

Prints the level of the dsadm 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.

-help

Prints the online help for this command. All other valid options that are specified with this option are ignored.

Usage notes

1. The dsadm config command changes the configuration options (in memory) that were specified in the IDFFSPRM file (or defaulted). The IDFFSPRM file is not changed. If you want the configuration specification to be permanent, you must modify the IDFFSPRM file because DSFS reads the IDFFSPRM file to determine the configuration values when DSFS 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 IDFFSPRM file.
2. The dsadm config command does not accept positional parameters.
3. The values for -directory_pool_size, -security_pool_size, -io_pool_size, -sysout_directory_pool_size, and -sysout_io_pool_size are only allowed to be increased. They can only be decreased by updating the IDFFSPRM file, stopping DSFS and restarting it.

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.

Related information