Coupling facility data table statistics

The coupling facility data table (CFDT) server reports comprehensive statistics on both the coupling facility list structure it uses and the data tables it supports. It also reports on the storage that is used within the CFDT region by its AXM routines (the AXMPGLOW and AXMPGANY areas). This data can be written to SMF and can also be produced automatically at regular intervals, or by operator commands to the job log of the CFDT server.

The CFDT statistics are calculated from information that is returned by recent coupling facility requests. If the relevant information was not accessed recently by the current server, the statistics are not necessarily accurate. The number of tables and the number of lists are updated each time that the server opens or closes a table, but at other times they might not be updated. The element and entry counts are updated on successful completion of most types of coupling facility access request.

The following code is an example of coupling facility statistics that are produced by a CFDT server:
DFHCF0432I Table pool statistics for coupling facility list structure DFH
CFLS_PERFCFT2:
 Structure:    Size  Max size Elem size   Tables:   Current   Highest
             12288K    30208K       256                   4         4
 Lists:       Total    In use  Max used   Control      Data
                137        41        41        37         4
               100%       30%       30%       27%        3%
 Entries:     Total    In use  Max used      Free  Min free   Reserve
               3837      2010      2010      1827      1827       191
               100%       52%       52%       48%       48%        5%
 Elements:    Total    In use  Max used      Free  Min free   Reserve
              38691     12434     12434     26257     26257      1934
               100%       32%       32%       68%       68%        5%

This example shows the amount of space that is currently used in a coupling facility list structure (Size) and the maximum size (Max size) defined for the structure. The structure size can be increased by using a SETXCF ALTER command. The number of lists that are defined is determined by the MAXTABLES parameter for the CFDT server. In this example, the structure can support up to 100 data tables (and 37 lists for control information).

Each list entry comprises a fixed-length section for entry controls and a variable number of data elements. The size of these elements is fixed when the structure is first allocated in the coupling facility, and is specified to the CFDT server by the ELEMSIZE parameter. The allocation of coupling facility space between entry controls and elements is altered automatically and dynamically by the CFDT server to improve space utilization if necessary.

The reserve space is used to ensure that rewrites and server internal operations can still function if a structure fills with user data.

The amount of storage that is used with the CFDT region to support AXM requests is also reported. For example:
AXMPG0004I Usage statistics for storage page pool AXMPGANY:
     Size    In Use  Max Used      Free  Min Free
   30852K      636K      672K    30216K    30180K
     100%        2%        2%       98%       98%
               Gets     Frees   Retries     Fails
               3122      3098         0         0
AXMPG0004I Usage statistics for storage page pool AXMPGLOW:
     Size    In Use  Max Used      Free  Min Free
     440K       12K       12K      428K      428K
     100%        3%        3%       97%       97%
               Gets     Frees   Retries     Fails
                  3         0         0         0

The CFDT server uses storage in its own region for AXMPGANY and AXMPGLOW storage pools. AXMPGANY accounts for most of the available storage above 16 MB in the CFDT region. The AXMPGLOW refers to 24 bit addressed storage (below 16 MB) and accounts for only 5% of this storage in the CFDT region. The CFDT server has a small requirement for such storage.



dfht3c00269.html | Timestamp icon Last updated: Monday, 5 June 2017