List structure parameter
The list structure parameter specifies the attribute that is used only for initial allocation of resources when the list structure is created for a named counter pool. Initial allocation occurs the first time a server is started for the named counter pool.
- POOLSIZE={0|number{K|M|G}}
- Specifies the initial amount of coupling facility storage to be
allocated for the pool list structure, expressed as kilobytes (n K),
megabytes (n M) or gigabytes (n G).
Usually, you can omit this parameter and specify the structure size by using the INITSIZE parameter in the coupling facility resource manager (CFRM) policy. However, this parameter can be useful if the structure is reallocated or reloaded but the CFRM policy has not been updated to reflect the required size.
- 0
- The special value 0 means that the server obtains an initial allocation using the parameters specified in the CFRM policy. If the CFRM policy specifies an INITSIZE value for the structure, this determines the initial allocation. Otherwise, the CFRM SIZE value (the maximum size of the structure) is allocated.
- number
- A non-zero value specifies an initial amount of storage to be
allocated, overriding the INITSIZE parameter
in the CFRM policy. This value is rounded up by MVS™ to the next storage increment for the coupling
facility level (CFLEVEL). For example, for CFLEVEL 16, the value is
rounded up to the nearest 1 MB.
The value must be less than the CFRM SIZE parameter, otherwise the value of POOLSIZE is ignored and the initial allocation uses the parameters specified in the CFRM policy.
The valid range is from 0 to 16777215M. However, you must specify a value that is less than the maximum size of a structure in z/OS, otherwise a z/OS error occurs. For example, in z/OS®, Version 1 Release 12, the maximum size of a structure is 1048576 MB (1 TB). For more details, see the information about CFRM parameters in z/OS MVS Setting Up a Sysplex.
This parameter is valid only at server initialization and is used only when the structure is first allocated.