Coupling facility storage management
The type of coupling facility structure that CICS® uses for its temporary storage data sharing pools, coupling facility data table pools, and named counter pools is a keyed list structure.
A coupling facility list structure contains an array of numbered lists that contain entries with 16-byte keys. Each list is like a keyed file. Each entry has a fixed prefix area that contains its key and other control information, which includes an adjunct area of 64 bytes for program use. The prefix is followed by a chain of up to 128 256-byte data elements. The maximum data size is 32K bytes.
For named counters, the structure contains a single list, each entry uses only the prefix area, and there are no data elements.
Storage for entry prefixes, known as entry controls, and data elements is allocated from two storage pools within the structure, which are shared between all lists in the structure.
- Fixed controls.
Storage for fixed controls is preallocated at a fixed size for the life of the structure. This storage contains structure control information, including data buffer space, and an array of list headers, up to the maximum number of lists defined when the structure was created. For CICS, this number is the small number of lists used for CICS internal purposes, and the value specified for the parameters MAXQUEUES or MAXTABLES.
The fixed controls include enough internal control areas to manage the maximum number of elements and entries that can exist in the structure, given the maximum structure size and the range of possible ratios of entries to elements, and an array of list headers to handle the maximum number of lists that can exist in the structure.
You cannot increase the maximum size or the maximum number of lists without reallocating the structure, so you must be careful to specify large enough values when the structure is first allocated. However, if you specify a relatively large maximum size or number of lists, a large amount of storage is preallocated for fixed controls, so the initial size of the structure needed to store a given amount of data will be significantly larger than it would be with less generous allowance for expansion.
- Variable controls.
Variable controls are partitioned into storage areas for entry controls (one per entry) and for data elements. You can adjust this partitioning dynamically by altering the ratio of entries to elements, converting storage for one type to the other type. CICS automatically issues a request to alter the ratio when one type of variable storage is running out but there is enough storage of the other type. You can alter the total size of the storage for variable controls dynamically by changing the size of the structure. This size must be within the range of sizes that are defined for the structure in the active coupling facility resource management (CFRM) policy, which are set at the time that the structure is created. You can change the structure size by using the system operator command SETXCF ALTER,SIZE. Alternatively, the operating system can change the structure size, depending on the automatic alter options that are specified in the CFRM policy when the structure is allocated.
In the CICS pool structures, each queue item, data table record, or named counter normally occupies one entry in the structure, together with the appropriate number of data elements. CICS uses additional entries for internal control purposes to maintain the index of currently defined queues or data tables, and to track which lists are currently in use and which previously used lists are now free and available for reuse. Even after all queues or data tables in a pool have been deleted, some entries in the control lists might remain in use.
The amount of storage required for internal control information depends on the level of functionality and performance of the coupling facility control code for the current coupling facility level (CFLEVEL). The storage requirements can increase for a higher CFLEVEL.
- It prompts for parameters that describe the amount of information to be stored in the structure.
- It converts this information to numbers of lists, entries, and elements.
- It communicates with a coupling facility at a current CFLEVEL to determine the amount of storage required to store the information with the specified amount of free space and room for expansion.
For information about the CPC support for different CFLEVELs and the function in each CFLEVEL, see CF levels.