Named counter list structure storage
You can use thez Systems™ Coupling Facility Structure Sizer (CFSizer) tool to calculate storage requirements for named counter list structures in a coupling facility. If you increase or decrease the structure size, consider whether you need to update other parameters.
A coupling facility structure contains both stored data and the information needed to manage and access that data, in a similar way to a key-sequenced data set. The amount of internal control information depends on the level of functionality and performance of the coupling facility control code for the current coupling facility level (CFLEVEL), and might increase for a higher CFLEVEL. For more information, see Coupling facility storage management.
CFSizer is a web-based application that takes these factors into account and communicates with a coupling facility at a current CFLEVEL to calculate storage requirements. See CFSizer.
If you enter the number of counters you require, the CFSizer tool calculates the size of a structure that can contain at least that number of counters. However, for practical operation, some free space must be available so that the structure does not become full, and to avoid warning messages about low space. It is advisable to use no more than approximately 75% of the structure size. Estimate the maximum number of counters that you require, then increase that number by a third to include the free space in the calculation.
The space required for a named counter pool depends on the number of different named counters that you need, but the minimum size can be enough for most needs. For example, for CFLEVEL 16, a 1 MB structure can hold up to 1000 named counters.
All structure sizes are rounded up to the next storage increment for the coupling facility level (CFLEVEL) at allocation time. For example, sizes are rounded up to the nearest 1 MB for CFLEVEL 16.
Provided that space is available in the coupling facility, you can use the MVS™ SETXCF command to increase the structure size dynamically from its initial size towards its maximum size, making the new space available immediately to any currently active servers. If too much space is allocated, you can reduce the structure size to free up coupling facility storage for other purposes. However, this could take some time if the coupling facility has to move existing data out of the storage that is being freed. If you alter the size in this way, update the INITSIZE parameter in the coupling facility resource management (CFRM) policy to reflect the new size, so that the structure does not revert to its original size if it is subsequently re-created or reloaded.