Understanding CF space usage


In addition to the structure slots, you must have enough storage space in your CF to support the maximum size that you specify for the XBM structures.

Processing environments are unique and vary widely, and no formula exists to determine the CF size that fits your environment. BMC recommends that you use the CF sizes that are specified in the samples in Updating-the-policy-data-set as a good, initial starting point. Over time, you should monitor the CF structures and tailor them to your specific processing load.

The amount that you define will be allocated, but MVS determines how much is actually acquired when the PSS component is initialized. When approximately 75 percent of the acquired CF resource has been used, XBM invokes MVS IXLALTER expansion services. At this point, the structure attempts to expand a set amount and processing continues until the 75 percent threshold is again reached. XBM repeats this process until the acquired resource can no longer expand due to the defined SIZE parameter. Because XBM does not acquire all of the defined CF cache until the cache is actually needed, defining a larger SIZE should not be a major concern. Coordinate with the person responsible for MVS/CF resource configuration at your site to determine a suitable starting SIZE for XBM in your environment.

Use the XBM CF monitor to verify actual resource usage, as described in Displaying-XBM-subsystem-information-and-PSS-performance-statistics. Additionally, CF statistics are displayed in the XBM SYSPRINT when one of the following events occur:

  • You issue the DISPLAY COMPONENT PSS or DISPLAY COMPONENT * command

    The following figure shows an example of the CF information contained in SYSPRINT when you issue one of these commands.

    BMC73055I  09.24.36 XOSM PSS component active for Snapshot
    BMC73059I  09.24.36 XOSM Snapshot support for component PSS enabled
    BMC73800I* 09.24.36 XOSM Joined XBM group XBMQA as member BMCXBM@XOSM on
               system SYSM at 09:23:53 on Jul 15,2011
    BMC73833I* 09.24.36 XOSM CF Structure XBMQA_CACHE1
               storage: used = 2 K, HWM = 2 K, total allocation = 4932 K
  • You issue the DISPLAY COMPONENT XBM command

    The following figure shows an example of the CF information contained in SYSPRINT when you issue the DISPLAY COMPONENT XBM command.

    BMC73150I* 09.24.49 XOSM XBM Version 6.1.00 initialization complete
               at 09:23:59...
    BMC73059I  09.24.49 XOSM Snapshot support for component PSS enabled
    BMC73800I* 09.24.49 XOSM Joined XBM group XBMQA as member BMCXBM@XOSM on
               system
    BMC73833I* 09.24.49 XOSM CF Structure XBMQA_CACHE1
               storage: used = 2 K, HWM = 2 K, total allocation = 4932 K
  • You stop the PSS component
  • XBM shuts down

If CF resources are exhausted, snapshot jobs can fail. Initial workload monitoring and tailoring can prevent an inadequate CF resource definition in your CFRM policy from causing snapshot failures.

To change CF size (if you allocated too much or too little initially), you must first stop the PSS component on all XBM subsystems in the data sharing group to deallocate the CF structures. Make the appropriate policy change and then restart the PSS component on each XBM subsystem.

Important

MVS uses an undetermined portion of the CF structure to maintain its own control blocks. Therefore, the  high-water mark (HWM) for CF usage will never reach the defined SIZE value, and CF write failures can occur when the HWM is seen to be less than the defined SIZE.

If your coupling facility does not have the storage space that the examples indicate, try specifying structures with a smaller maximum size. To check available coupling facility storage space from the MVS console, enter the following command:

DISPLAY CF

The following figure shows an example of the display. The FREE SPACE statistic shows the current storage available in each partition of the coupling facility.

D CF
IXL150I  10.35.43  DISPLAY CF 906
COUPLING FACILITY 009674.IBM.02.000000040087
 PARTITION: 2  CPCID: 00
 CONTROL UNIT ID: FFF9
NAMED CFPART02
COUPLING FACILITY SPACE UTILIZATION
 ALLOCATED SPACE                 DUMP SPACE UTILIZATION
 STRUCTURES:     602368 K        STRUCTURE DUMP TABLES:        0 K
 DUMP SPACE:       2048 K                  TABLE COUNT:        0
 FREE SPACE:      411648 K       FREE DUMP SPACE:            2048 K
TOTAL SPACE:     1016064 K      TOTAL DUMP SPACE:            2048 K
 MAX REQUESTED DUMP SPACE:        0 K
 VOLATILE:         YES         STORAGE INCREMENT SIZE:      256 K
 CFLEVEL:           3

COUPLING FACILITY SPACE CONFIGURATION
                          IN USE          FREE         TOTAL
CONTROL SPACE:          604416 K      411648 K     1016064 K
NON-CONTROL SPACE:           0 K           0 K           0 K

SENDER PATH        PHYSICAL     LOGICAL     STATUS
 68                ONLINE       ONLINE      VALID
 69                OFFLINE      ONLINE      NOT OPERATIONAL

COUPLING FACILITY DEVICE     SUBCHANNEL     STATUS
 FFF0                         0DE0        OPERATIONAL/NOT IN USE
 FFF1                         0DE1        OPERATIONAL/NOT IN USE
 FFF2                         0DE2        OPERATIONAL/IN USE
 FFF3                         0DE3        OPERATIONAL/IN USE

COUPLING FACILITY 009674.IBM.02.000000040087
 PARTITION: 1  CPCID: 00
 CONTROL UNIT ID: FFFE

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*