QUERY FILEPOOL OVERVIEW

Notes:

¹ The default is the default file pool ID for your virtual machine. If there is no default file pool ID, the command fails.

Authorization

File Pool Administrator or Connected User

Purpose

Use the QUERY FILEPOOL OVERVIEW command to return overview information about a specified file pool. This includes information that allows a comparison between file pool limits and the present highest values (for example, Virtual Storage, Connections, Agents).

The information returned can assist you with the task of performance analysis and timing for file pool servers.

Note that this command should not be used by permanent applications to acquire data. The content of the output from this command may change in the future.

Operands

filepoolid
filepoolid:: is the name of the file pool. If not specified, the default file pool for your virtual machine is used.

Options

STACK FIFO
STACK LIFO: places the information in the console stack rather than displaying it at the terminal. The headings also are stacked. FIFO is the default.
FIFO: specifies the information is stacked in a first in, first out order. This option is equivalent to STACK FIFO.
LIFO: specifies the information is stacked in a last in, first out order. This option is equivalent to STACK LIFO.
XEDIT: indicates the QUERY output should be placed in the file currently being edited (using XEDIT). The edited file must either be fixed format with a logical record length (LRECL) of 80 or variable length format. The information replaces the current line and below until the END OF FILE is reached. Then the remaining text (if any) is inserted before the END OF FILE.

Usage Notes

The XEDIT option is useful for scrolling through the data and for saving it for later browsing. You might also consider entering this command when FULLSCREEN is set to ON. CMS FULLSCREEN also lets you scroll through the information.
The XEDIT option must be used from within an XEDIT session. An easy way to use the option is to edit a new file and then enter the QUERY FILEPOOL OVERVIEW command with the XEDIT option on the command line. When a new file is edited, there isn't a chance of accidentally overlaying information already in the file.
If the QUERY FILEPOOL OVERVIEW command is issued from an exec or an assembler program for a file pool that is active (that is, has some work on it which has not been committed or rolled back) on the current default work unit, the command will cause an error.
If the current release of z/VM® is processing prior release file pool information, you will only see the information applicable for that prior release.

Responses

The QUERY FILEPOOL OVERVIEW command displays file pool overview information. An example of the output is:

 
                  VM9SERV  File Pool Overview
 
Start-up Date mm/dd/yy                  Query Date mm/dd/yy
Start-up Time hh:mm:ss                  Query Time hh:mm:ss
===========================================================
FILE POOL OVERVIEW INFORMATION
 
    6291456  Virtual Storage Size in Bytes (6144 in KB)
       4057  Virtual Storage Highest Value in KB
          0  Virtual Storage Requests Denied
          0  Virtual Storage Reclaim Value
 
         25  Maximum Number of Connections
         11  Connections Highest Value
 
         16  Total Number of Agents
          2  Active Agents Highest Value
 
         10  Maximum Number of Storage Groups
          2  Storage Groups in Use
 
         10  Maximum Number of Minidisks
          5  Minidisks in Use
 
    1769472  Potential Addressable 4K Blocks in File Pool
       2358  Defined Addressable 4K Blocks in File Pool
    1767114  Undefined Addressable 4K Blocks in File Pool
===========================================================

In the FILE POOL OVERVIEW INFORMATION you will see some maximum numbers. These were established for the file pool during file pool generation (or regeneration) by the FILESERV GENERATE or FILESERV REGENERATE commands. To exceed any of these maximums, you must regenerate the file pool.

For a description of the fields, see FILE POOL OVERVIEW INFORMATION of the command QUERY FILEPOOL REPORT.

Messages and Return Codes

In addition to the messages listed below, this command displays other system messages. These system messages are listed in z/VM: CMS Commands and Utilities Reference.

Messages:

DMS065E option option specified twice [RC=24]
DMS105S Error nn writing file fn ft fm to XEDIT [RC=31, 55, 70, 76, 99, or 100]
DMS109S Virtual storage capacity exceeded [RC=109]
DMS389E Incorrect filepoolid: filepoolid [RC=24]
DMS391E Unexpected operand(s): operands [RC=24]
DMS639E Error in NUCXLOAD routine; return code was nnnn [RC=24]
DMS688E XEDIT option only valid from XEDIT environment [RC=24]
DMS689E File must be F-format 80 or V-format [RC=24]
DMS1223E There is no default file pool currently defined [RC=40]