dsadm configquery

Purpose

dsadm configquery queries the current value of DSFS configuration options.

Format

dsadm configquery [-all] [-compress][-directory_pool_size] 
[-directory_refresh_timeout] Start of change[-enable_sysout]End of change [-filecache_size] [-fsfull]
[-hlq_mode] [-hlq_list] [-io_pool_size] 
[-ispf_extended_statistics] [-msg_input_dsn] [-pds_enq_duration] 
[-pds_interval] [-ps_dyn_duration] [-ps_interval] 
[-security_pool_size] [-security_timeout][-trace_table_size]
Start of change[-sysout_directory_pool_size] | [-sysout_io_pool_size]End of change
[-trace <file_name>]Start of change[-utfs_name]End of change[-level] [-help]

Options

-all
Displays the full set of configuration options.
-compress
Displays whether a newly defined utility file system will be formatted to use compression upon its first mount.
-directory_pool_size
The number of processing threads used to handle directory requests that require access to DFSMS data sets or catalogs.
-directory_refresh_timeout
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.
Start of change-enable_sysout End of change
Start of changeDisplays whether users can access JES spool data sets. End of change
-filecache_size
Displays the size, in bytes, of the cache that is used to contain file data.
-fsfull
Displays the threshold and increment for reporting file system full error messages to the operator.
-hlq_mode
Displays the HLQ mode that is used by DSFS.
EXCLUDE
The HLQ_LIST will list HLQ directory names that are not allowed in the DSFS tree. Any HLQ directory that is not in the HLQ_LIST is allowed in the DSFS tree. EXCLUDE is the default if HLQ_MODE is not provided in the IDFFSPRM file.
-hlq_list
Displays the list of HLQ directory names that are not allowed access by DSFS users. The default is an empty list.
io_pool_size
Displays the number of DSFS worker threads that are used to process data set I/O requests using the QSAM access methods.
-ispf_extended_statistics
Displays whether DSFS should retrieve and store ISPF extended statistics when processing PDS and PDSE members.
-msg_input_dsn
Displays the name of the data set that contains converted DSFS messages.
-pds_enq_duration
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
Displays the number of seconds between the time a DSFS task will look at cached PDS/PDSE directories to determine if they have exceeded their enqueue duration. If so, then it will release the enqueue.
-ps_dyn_duration
Displays the number of seconds that DSFS will hold a dynamic allocation on PS data sets and PDS/PSDE members, which allows DSFS to cache their contents for that period of time and reduce the number of calls to read the data set.
-ps_interval
Displays the number of seconds between the time a DSFS task will look at cached PS data sets and PDS/PSDE members to determine whether they have exceeded their dynamic allocation duration. If so, then it will release the allocation, which will cause DSFS to uncache the file’s contents.
-security_pool_size
Displays the number of DSFS worker threads that are used to process SAF security calls.
-security_timeout
Displays 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.
Start of change-sysout_directory_pool_sizeEnd of change
Start of changeThe number of processing threads used to handle subsystem interface (SSI) calls used to determine job information.End of change
Start of change-sysout_io_pool_sizeEnd of change
Start of changeDisplays the number of DSFS worker threads that are used to process sysout data set I/O requests using the QSAM access method. End of change
-trace_table_size
Displays the size, in bytes, of the internal trace table.
-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.
Start of change-utfs_name End of change
Start of changeThe value that is specified in the configuration file for the utility file system name.End of change
-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 configquery command displays the current value of DSFS configuration options. The value is retrieved from DSFS address space memory rather than from the IDFFSPRM file.

Privilege required

The issuer does not need special authorization.

Examples

  1. The following command displays the current value of the file cache:
    dsadm configquery -filecache_size                
The value for -filecache_size is 64M.
  2. The following command displays the current value of the io pool.
    dsadm configquery -io_pool_size                
The value for -io_pool_size is 128.

Related information

Commands:
  • dsadm config
Files:
  • IDFFSPRM