Coupling Facility Usage Summary section

This section of the Coupling Facility Activity report gives a snapshot of coupling facility storage and specific structure data at the end of the reporting interval. It lists all the structures occupying space either in the coupling facility real storage or in storage class memory (SCM), including those with no currently active connections. For asynchronously duplexed secondary structures, it provides a summary on consumed processing times and performance counts related to asynchronous duplexing. Data shown for asynchronous duplex sync up requests are accumulated over all reported systems that have a connector to the structure.

All structure summary data is grouped in the report by structure type (LIST, LOCK, CACHE and UNKN in that order). Within the structure type, the report lines are in alphanumeric order by structure name. This ordering puts the structure data in the same relative position across interval reports.

Figure 1. Coupling Facility Activity Report - Usage Summary

                                      C O U P L I N G   F A C I L I T Y   A C T I V I T Y
                                                                                                                     PAGE   1
    z/OS V2R4              SYSPLEX UTCPLXJ8            DATE 05/11/2019           INTERVAL 030.00.000
                           RPT VERSION V2R4 RMF        TIME 12.00.00             CYCLE 01.000 SECONDS

  -----------------------------------------------------------------------------------------------------------------------------
   COUPLING FACILITY NAME = X7CFP87
   TOTAL SAMPLES(AVG) =  1800  (MAX) =  1800  (MIN) =  1799
  -----------------------------------------------------------------------------------------------------------------------------
                                               COUPLING  FACILITY  USAGE  SUMMARY
  -----------------------------------------------------------------------------------------------------------------------------
   GENERAL STRUCTURE SUMMARY
  -----------------------------------------------------------------------------------------------------------------------------                                                                                                                                   
                                                    % OF             % OF   % OF     AVG    LST/DIR  DATA      LOCK     DIR REC/  
          STRUCTURE                          ALLOC  CF          #    ALL    CF       REQ/   ENTRIES  ELEMENTS  ENTRIES  DIR REC   
   TYPE   NAME              STATUS CHG  ENC  SIZE   STOR      REQ    REQ    UTIL     SEC    TOT/CUR  TOT/CUR   TOT/CUR  XI'S      
                                                                                                                                  
   LIST   DBSVPLX7_SCA      ACTIVE      YES    5M    0.0    10754     1.5    1.8     5.97    3484      6743       N/A       N/A   
                             PRIM                                                             182       622       N/A       N/A   
          DFHXQLS_G2POOL1   ACTIVE      NO    63M    0.4        0     0.0    0.0     0.00      96K       96K      N/A       N/A   
                                                                                             1822      1859       N/A       N/A   
   LIST   ISTGENERIC        ACTIVE      YES   11M    0.0    20850     0.0    0.0    11.58      25K      499         4       N/A   
                             PRIM                                                              47         2         0       N/A   
          THRLSTSCMKP1_1    ACTIVE      NO     4G    4.1    20114K    4.4   16.5    11174    1428K     8569K     1024       N/A   
                                                                                             1262K     7060K        0       N/A   
   LOCK   DBTPLX5_ALOCK     ACTIVE      N/A   44M    0.3    68212     9.4    9.2    37.90      11K        0        17M      N/A   
                             SEC A                                                              0         0         0       N/A   
   CACHE  IRRXCF00_B002     ACTIVE      NO     2M    0.0        0     0.0    0.0     0.00     184       181       N/A         0   
                                                                                                4         1       N/A         0   
   …                                                                                                                            
                                             ----   ----   -------   ----   ----   -------                                        
              STRUCTURE TOTALS                15G   57.0    29430K    100   90.5    16350                                        



   SCM STRUCTURE SUMMARY
  ------------------------------------------------------------------------------------------------------------------------------

                                SCM SPACE AUGMENTED  LST ENTRY LST ELEM  --- SCM READ ---- --- SCM WRITE ---  SCM AUX   DELAYED
          STRUCTURE             MAX/      EST.MAX/   EST.MAX/  EST.MAX/  CNT/BYTE AVG ST/  CNT/BYTE AVG ST/   ENABLED   FAULTS
   TYPE   NAME              ALG %USED     %USED      CUR       CUR       X'FERRED STD_DEV  X'FERRED STD_DEV   CMD/%ALL  CNT/%ALL

   LIST   THRLSTSCMKP1_1    KP1   16384M      754M      9585K    57508K     4790   1353.8     3944   1762.3         0     58749
                                    0.0       0.3          0         0      5023M   832.0     4136M   736.6       0.0       0.0

   ASYNCHRONOUS CF DUPLEXING SUMMARY                                                                                            
  ------------------------------------------------------------------------------------------------------------------------------
                                                                                                                              
                            --------- ASYNC DUPLEX CF OPERATIONS ---------    --- ASYNC DUPLEX SYNC_UP REQUESTS ---             
          STRUCTURE          TOTAL    --TRANSMIT TIME--   --SERVICE TIME--      TOTAL  #SUSPEND    --SUSPEND TIME--             
   TYPE   NAME                           AVG   STD_DEV       AVG   STD_DEV                            AVG   STD_DEV             
                                                                                                                              
   LOCK   DBTPLX5_ALOCK      19432K      1.1      22.6       1.2      23.8      43197         1     744.0       0.0             
          DBTSTPLX_LCK        6700K      1.1      22.2       1.1      23.8       7420         0       0.0       0.0             
                  
                                                                                                                              
                                                                                                                              

   STORAGE SUMMARY
  ------------------------------------------------------------------------------------------------------------------------------

                                              ALLOC     % OF CF     ------- DUMP SPACE -------
                                              SIZE      STORAGE     % IN USE   MAX % REQUESTED

   TOTAL CF STORAGE USED BY STRUCTURES        6202M        6.2
   TOTAL CF DUMP STORAGE                      1024M        1.0          0.0               0.0
   TOTAL CF AUGMENTED SPACE                      2M        0.0
   TOTAL CF STORAGE AVAILABLE                93138M       92.8
                                             -------
   TOTAL CF STORAGE SIZE                    100366M


                                              ALLOC     % ALLOCATED
                                              SIZE

   TOTAL CONTROL STORAGE DEFINED            100366M        5.7
   TOTAL DATA STORAGE DEFINED                    0K        0.0


                                              ASSIGNED  % IN USE    SUM MAX SCM

   TOTAL CF STORAGE CLASS MEMORY             16384M        0.0        16384M

   PROCESSOR SUMMARY
  ------------------------------------------------------------------------------------------------------------------------------

   COUPLING FACILITY         2827        MODEL H66      CFLEVEL  19           DYNDISP OFF

   AVERAGE CF UTILIZATION  (% BUSY)           53.9      LOGICAL PROCESSORS:   DEFINED   2    EFFECTIVE    2.0
                                                                              SHARED    0    AVG WEIGHT   0.0

The report summarizes request activity for active structures. This activity is described in more detail in the Coupling Facility Structure Activity section of the report. It is included in this report to give the customer a quick view of the relative amount of activity among the structures in a coupling facility.

The following table explains the field headings in the Coupling Facility Usage Summary section.

Table 1. Fields in the Coupling Facility Activity Report - Usage Summary
Field Heading	Meaning
TOTAL SAMPLES (AVG), (MAX), (MIN)	Average (AVG), the maximum (MAX) and minimum (MIN) sample count for all systems connected to this coupling facility.
GENERAL STRUCTURE SUMMARY
TYPE	Indicates whether the structure is a list, lock, or cache structure. The structures being reported are grouped by structure type. UNKN indicates a structure for which there was no activity during the interval but that is still allocated in the coupling facility. There are no structure activity details for UNKN structures.
STRUCTURE NAME	The name given to the structure by the coupling facility policy specification in the Function Couple Data Set. It is up to 16 characters and is unique within a sysplex.
STATUS	Indicates status of the structure at the end of the interval: ACTIVE At least one system is connected to the structure. If a structure became active during this interval, the report gives the partial interval activity data. In the unlikely event a structure becomes active several times during an interval, only the last activation is reported. ACTIVE PRIM The structure is the rebuilt-old (primary) structure in a duplexing rebuild process. An appended A indicates that the structure is asynchronously duplexed. ACTIVE SEC The structure is the rebuilt-new (secondary) structure in a duplexing rebuild process. An appended A indicates that the structure is asynchronously duplexed. INACTV No system is connected to the structure but it still occupies storage in the coupling facility. The structure will not show any request activity because RMF was unable to gather end-of-interval data for calculating delta values. A structure is inactive while it is undergoing recovery operations or being moved to another coupling facility, or it was specified by the owning subsystem as a persistent structure. There are no structure activity details for an inactive structure. UNALLOC No system is connected to the structure and it no longer occupies storage in the coupling facility. The structure was active earlier in the interval but no activity data is shown because RMF was unable to collect end-of-interval data for calculating delta values. There are no structure activity details reported for an unallocated structure. The PRIM and SEC indicators of synchronously duplexed structures might not appear if data from one or more systems in the sysplex is missing.
CHG	X indicates that the status of this structure changed during the reporting interval.
ENC	YES indicates that the CF structure is encrypted. NO indicates that the CF structure is not encrypted or cannot be encrypted. A CF structure cannot be encrypted if the structure is only used by a down-level system in the Parallel Sysplex, that does not support encryption of CF structures. N/A indicates that encryption of lock (LOCK) structures is not supported.
ALLOC SIZE	The number of bytes set aside in the coupling facility for this structure by the coupling facility policy in the Function Couple Data Set. Storage is allocated in increments of 4K bytes. This storage consists of both control and data storage.
% OF CF STOR	The percentage of the total coupling facility storage allocated to this structure.
# REQ	The number of requests processed by the coupling facility against this structure. This is the same number as appears in the TOTAL line of the Coupling Facility Structure Activity report.
% OF ALL REQ	The percentage of all requests attributable to this structure. Use this field for a quick idea of where the activity occurred during the interval.
% OF CF UTIL	The percentage of CF processor time used by the structure. The structure execution time is related to the total CF-wide processor busy time. The sum of the values in this column is less than 100%, because not all CF processor time is attributable to structures. `N/A` is shown in this field if the CF level is lower than 15.
AVG REQ/SEC	The average number of requests per second for this structure.
LST/DIR ENTRIES	TOT Maximum number of list or directory entries that can reside in coupling facility real storage for the structure. CUR Number of structure list or directory entries which are currently in use and reside in coupling facility real storage. `N/A` in this and the following fields indicates that the information is not applicable.
DATA ELEMENTS	TOT Maximum number of list elements that can reside in coupling facility real storage. CUR Number of structure list elements which are currently in use and reside in coupling facility real storage.
LOCK ENTRIES	TOT The total number of lock table entries. CUR The non-zero lock table count found.
DIR REC/ DIR REC XI'S	Number of Cache directory reclaims. Directory reclaims occur when the total number of used unique entities exceeds the total number of directories. Whenever this shortage of directory entries occurs, the coupling facility will reclaim in-use directory entries associated with unchanged data. All users of that data must be notified that their copy of the data is invalid. As a consequence, it may happen that this data must be re-read from DASD and registered to the coupling facility again. Directory reclaim activity can be avoided by increasing the directory entries for a particular structure. The second value is the number of reclaims that caused an XI (see XI field in the Structure Activity section). A high value is an indicator for a performance problem in this structure.
SCM STRUCTURE SUMMARY^{(See note 2)}
ALG	Type of algorithm that is used by the coupling facility to control the movement of structure objects between coupling facility real storage and storage class memory: KP1 KeyPriority1 UNK Unknown
SCM SPACE	MAX Maximum amount of storage class memory that this structure can use (in bytes). %USED Percentage of maximum amount of storage class memory that is in use by this structure.
AUGMENTED	EST.MAX Estimated maximum amount of CF space that may be assigned as augmented space for this structure (in bytes). %USED Percentage of maximum augmented space that is in use by this structure.
LST ENTRY	EST.MAX Estimated maximum number of list entries that may reside in storage class memory for this structure. CUR Number of existing structure list entries that reside in storage class memory.
LST ELEM	EST.MAX Estimated maximum number of list elements that may reside in storage class memory for this structure. CUR Number of existing structure list elements that reside in storage class memory.
SCM READ	CNT The number of read operations against storage class memory that were either initiated by a reference to list structure objects residing in storage class memory, or as a prefetch operation in order to retrieve list structure objects in storage class memory that are expected to be referenced. BYTE X'FERRED SCM read bytes transferred. This is the number of bytes transferred from storage class memory to CF. AVG ST Average service time per SCM read operation to storage class memory in microseconds. STD_DEV Standard deviation of the service time for SCM read operations to storage class memory in microseconds.
SCM WRITE	CNT The number of list write operations performed to storage class memory. BYTE X'FERRED SCM write bytes transferred. This is the number of bytes transferred from CF storage to storage class memory. AVG ST Average service time per SCM write operation to storage class memory in microseconds. STD_DEV Standard deviation of the service time for SCM write operations to storage class memory in microseconds.
SCM AUX ENABLED	CMD SCM auxiliary enabled command count. This is the number of commands that required the use of CF auxiliary frames. %ALL Percentage of the SCM auxiliary enabled command count in relation to all requests for this structure.
DELAYED FAULTS	CNT Number of commands and for multiple list-entry commands, the number of list item references that were delayed due to a fault condition resulting in a required access to storage class memory. %ALL Percentage of delayed faults in relation to all requests for the structure.
ASYNCHRONOUS CF DUPLEXING SUMMARY^{(See note 3)}
ASYNC DUPLEX CF OPERATIONS	TOTAL Number of asynchronous duplex operations transmitted from the primary to the secondary structure that completed in the secondary structure. TRANSMIT TIME AVG Average asynchronous duplex operation transmission time for operations sent from the primary to the secondary structure, in microseconds. TRANSMIT TIME STD_DEV Standard deviation of the average asynchronous duplex operation transmission time. SERVICE TIME AVG Average service time to transfer the asynchronous duplex operation to the secondary structure and complete the operation in the secondary structure, in microseconds. SERVICE TIME STD_DEV Standard deviation of the average service time to transfer and complete the asynchronous duplex operation in the secondary.
ASYNC DUPLEX SYNC_UP REQUESTS	TOTAL Total number of user requests that requested sync up with the primary structure. User requests are summed up over all systems connected to the structure. #SUSPEND Number of user requests that were suspended waiting for asynchronous duplex operations to complete in the secondary structure. Suspend counts are summed up over all systems connected to the structure. SUSPEND TIME AVG Average accumulated suspend time for suspended requests waiting for asynchronous duplex operations to complete in the secondary structure, in microseconds. SUSPEND TIME STD_DEV Standard deviation of the average accumulated suspend time.
STORAGE SUMMARY
TOTAL CF STORAGE USED BY STRUCTURES	The total amount of coupling facility storage that is used by structures and the percentage of the total coupling facility storage allocated to these structures. These totals do not necessarily represent 100% of the facility activity for the interval. There is some amount of storage and request activity overhead that is not attributable to individual structures. For example, the total for # REQ will usually be less than the sum of the TOTAL REQ from the Subchannel Activity Report because the subchannel numbers include facility management command counts whereas the structure numbers do not.
TOTAL CF DUMP STORAGE	Amount and percentage of coupling facility space allocated as dump space.
DUMP SPACE	% IN USE The percentage of dump space in use at end of the interval. This amount is a sampled value so it is intended to show trends, not instantaneous peaks. MAX % REQUESTED The maximum percentage of dump space requested since the coupling facility dump storage was allocated. This high water mark is maintained by the coupling facility hardware so is reset only when dump space is reinitialized. If this percentage is over 100, it means at least one dump has been lost or truncated since the most recent allocation of dump space. If the percentage is close to or over 100, you should increase the dump space allocation by modifying the coupling facility policy for dump space and activating the modified policy.
TOTAL CF AUGMENTED SPACE	ALLOC SIZE Total amount of CF storage used by all structures as augmented space (in bytes). % OF CF STORAGE Percentage of CF storage used by all structures as augmented space.
TOTAL CF STORAGE AVAILABLE	The amount and percentage of coupling facility space that is not allocated to any structure, not allocated as dump space, and not allocated as augmented space.
TOTAL CF STORAGE SIZE	The total amount of storage in the coupling facility, including both allocated and available space. This value does not include the storage required by the coupling facility code itself, so that it differs from the storage assigned to the coupling facility on the HMC.
TOTAL CONTROL STORAGE DEFINED, TOTAL DATA STORAGE DEFINED, % ALLOCATED	The amount of coupling facility storage that is allowed to be occupied by control information (CONTROL STORAGE) or data (DATA STORAGE). For each structure, plus the dump area, a certain amount of control and data storage is allocated. The coupling facility defines an area called control storage; structure control information is restricted to that area. The remaining storage is called data storage and is used for structure data. If the data storage area becomes full, structure data can then be allocated from the control storage area. If TOTAL DATA STORAGE DEFINED is zero, it means control information can reside anywhere on the coupling facility and there are no allocation restrictions. If the % ALLOCATED field for control storage shows a percentage approaching 100, it means the control storage is close to being completely allocated even though the CF SPACE AVAILABLE field may still show an amount of total free space. Possible customer actions include: Changing structure preference lists in the coupling facility policy specification to direct some structures away from this facility. Adding another coupling facility to the sysplex.
TOTAL CF STORAGE CLASS MEMORY	ASSIGNED Total CF storage class memory. This is the amount of storage class memory that may be concurrently used as structure extensions. Storage is assigned in increments of 4K bytes. % IN USE Percentage of storage class memory that is in use by all structures of the coupling facility. SUM MAX SCM Sum of the storage class memory maxima defined for all structures of the coupling facility.
PROCESSOR SUMMARY
COUPLING FACILITY	Coupling facility processor type.
MODEL	Coupling facility processor model.
CFLEVEL	Coupling facility architected function level.
DYNDISP^{(See note 1)}	The dynamic CF dispatching status (ON, OFF, or THIN). THIN indicates that coupling thin interrupts are enabled for the coupling facility (only for CFLEVEL 19 or higher).
AVERAGE CF UTILIZATION (% BUSY)	Average value of CPU utilizations within the coupling facility. The utilization of the individual CPs in the coupling facility is recorded in the SMF 74, Subtype 4, Processor Data Section. In case of a stand-alone coupling facility, the utilization of the individual CPs should be approximately the same. In a PR/SM environment where this CP is shared with other partitions the utilization is the logical utilization of the CP (that is, only the utilization by the coupling facility). The CPU Activity report can be used to determine the total utilization of the CP. If the average utilization is high, you can take the following actions: In a PR/SM environment, you can dedicate the CP to the integrated coupling facility or assign additional CPs to the partition. Move structures to a coupling facility with lower utilization. Consider additional or larger coupling facilities.
LOGICAL PROCESSORS DEFINED^{(See note 1)}	Number of logical processors defined for the coupling facility.
LOGICAL PROCESSORS EFFECTIVE	Number of effective available logical processors in a shared environment. This value is only useful in CFCC environment. CFCC measures the time of real command execution as well as the time waiting for work. The reported value shows the ratio of the LPAR dispatch time (CFCC execute and wait time) to the RMF interval length. For example, if a CFCC CEC contains 6 LPs, and the measured CF LPAR has two logical processors and is limited at 5 % the number of effective LPs is 0.3 Please, refer to the CPU Activity report in case of an ICMF LPAR.
LOGICAL PROCESSORS SHARED	The number of shared processors defined for the coupling facility.
LOGICAL PROCESSORS AVG WEIGHT^{(See note 1)}	The average weight of shared processors, which is the sum of shared processor weights related to the number of shared processors.

Notes:

For CFLEVEL lower than 15, this field is not displayed.
SCM statistics are included in the SCM Structure Summary only for those structures that can make use of the SCM storage extension and have set a non-zero maximum SCM size. If none of the structures is configured to exploit SCM, the SCM Structure Summary displays message: NO STORAGE CLASS MEMORY DATA AVAILABLE.
If no structure is configured to exploit asynchronous duplexing, the Asynchronous CF Duplexing Summary includes an informational message NO ASYNCHRONOUS CF DUPLEXING DATA AVAILABLE.