LSRPOOL resource definitions

The LSRPOOL resource defines the size and characteristics of the local shared resources (LSR) pool. The LSR pool is a reserve of data buffers, strings, and Hiperspace buffers that VSAM uses when processing access requests for certain files.

A Hiperspace buffer may be used by VSAM to provide additional buffer capacity. For more information about MVS Hiperspace, see Creating and using hiperspaces in the z/OS MVS Programming: Extended Addressability Guide.

Up to 255 LSR pools can be defined concurrently in the system, each identified by its LSRPOOLNUM. This LSRPOOLNUM is used to associate a FILE with an LSR pool if that file is to use shared resources.

When the LSRPOOL definition is installed in the active system, its information is stored and used when the pool with the specified ID is next built. A pool is built when the first file that uses a particular LSR pool is opened, and is dynamically deallocated only when no files are currently open against that pool. This means that when an LSRPOOL definition is installed into the system it might not take effect immediately.

CICS® sets default attributes if an LSRPOOL is not defined, but you are advised to define the LSRPOOL anyway, for reasons of performance. In a production system, for example, delay might be incurred while pool requirements are being calculated by CICS. Another possible problem is that if files are not allocated at the time the pool is built, the data set names are not known to CICS. In this case, the pool is built based on the information available, but the subsequent performance of the system can suffer or files might fail to open.

You can associate the CSD file with a particular LSRPOOL by specifying the CSDLSRNO system initialization parameter. The default is pool 1; ensure that sufficient buffers of an appropriate size are provided to permit the CSD file to be used by CICS. See Setting up shared data sets, CSD and SYSIN for further information about CSDLSRNO and for details about calculating the buffer requirements for the CSD file.

For information about working with BAS, see Working with BAS LSR pool resource definitions.

Syntax

Read syntax diagramSkip visual syntax diagramLSRPOOL( name)GROUP( groupname)DESCRIPTION( text)Data buffersIndex buffersLSRPOOLNUM(1)LSRPOOLNUM( number)MAXKEYLENGTH( number)SHARELIMIT( number)STRINGS( number)
Data buffers
Read syntax diagramSkip visual syntax diagramDATA512( number)DATA1K( number)DATA2K( number)DATA4K( number)HSDATA4K( number)DATA8K( number)HSDATA8K( number)DATA12K( number)HSDATA12K( number)DATA16K( number)HSDATA16K( number)DATA20K( number)HSDATA20K( number)DATA24K( number)HSDATA24K( number)DATA28K( number)HSDATA28K( number)DATA32K( number)HSDATA32K( number)

Attributes

DATA BUFFERS
Specify the number of data buffers of each size that you require, in the range 3 through 32767. These attributes do not have default values.
DATA512(number)
Specifies the number, in the range 3 through 32767, of 512 byte data buffers you require.
DATA1K(number)
Specifies the number, in the range 3 through 32767, of 1 KB data buffers you require.
DATA2K(number)
Specifies the number, in the range 3 through 32767, of 2 KB data buffers you require.
DATA4K(number)
Specifies the number, in the range 3 through 32767, of 4 KB data buffers you require.
DATA8K(number)
Specifies the number, in the range 3 through 32767, of 8 KB data buffers you require.
DATA12K(number)
Specifies the number, in the range 3 through 32767, of 12 KB data buffers you require.
DATA16K(number)
Specifies the number, in the range 3 through 32767, of 16 KB data buffers you require.
DATA20K(number)
Specifies the number, in the range 3 through 32767, of 20 KB data buffers you require.
DATA24K(number)
Specifies the number, in the range 3 through 32767, of 24 KB data buffers you require.
DATA28K(number)
Specifies the number, in the range 3 through 32767, of 28 KB data buffers you require.
DATA32K(number)
Specifies the number, in the range 3 through 32767, of 32 KB data buffers you require.
DESCRIPTION(text)
You can provide a description of the resource that you are defining in this field. The description text can be up to 58 characters in length. There are no restrictions on the characters that you can use. However, if you use parentheses, ensure that for each left parenthesis there is a matching right parenthesis. If you use the CREATE command, for each single apostrophe in the text, code two apostrophes.
GROUP(groupname)
Every resource definition must have a GROUP name. The resource definition becomes a member of the group and is installed in the CICS system when the group is installed.
Acceptable characters:

A-Z 0-9 $ @ #

Valid characters are listed as they render when the code page is IBM®-037. If a different EBCDIC code page is used, be aware of variant characters, as documented in Variant characters.

Any lowercase characters that you enter are converted to uppercase.

The GROUP name can be up to eight characters in length. Lowercase characters are treated as uppercase characters.

HIPERSPACE DATA BUFFERS
Specify the number of Hiperspace data buffers of each size that you require, in the range 0 through 16777215. If you leave these fields blank, there are no default values.
Note: If you specify a value for a Hiperspace data buffer of a given size, you must also specify a value for the data buffer of the same size.
HSDATA4K(number)
Specifies the number, in the range 0 through 16777215, of 4 KB Hiperspace data buffers you require.
HSDATA8K(number)
Specifies the number, in the range 0 through 16777215, of 8 KB Hiperspace data buffers you require.
HSDATA12K(number)
Specifies the number, in the range 0 through 16777215, of 12 KB Hiperspace data buffers you require.
HSDATA16K(number)
Specifies the number, in the range 0 through 16777215, of 16 KB Hiperspace data buffers you require.
HSDATA20K(number)
Specifies the number, in the range 0 through 16777215, of 20 KB Hiperspace data buffers you require.
HSDATA24K(number)
Specifies the number, in the range 0 through 16777215, of 24 KB Hiperspace data buffers you require.
HSDATA28K(number)
Specifies the number, in the range 0 through 16777215, of 28 KB Hiperspace data buffers you require.
HSDATA32K(number)
Specifies the number, in the range 0 through 16777215, of 32 KB Hiperspace data buffers you require.
HIPERSPACE INDEX BUFFERS
Specify the number of Hiperspace index buffers of each size that you require, in the range 0 through 16777215. If you leave these fields blank, there are no default values.
Note: If you specify a value for a Hiperspace index buffer of a given size, you must also specify a value for the index buffer of the same size.
HSINDEX4K(number)
Specifies the number, in the range 0 through 16777215, of 4 KB Hiperspace index buffers you require.
HSINDEX8K(number)
Specifies the number, in the range 0 through 16777215, of 8 KB Hiperspace index buffers you require.
HSINDEX12K(number)
Specifies the number, in the range 0 through 16777215, of 12 KB Hiperspace index buffers you require.
HSINDEX16K(number)
Specifies the number, in the range 0 through 16777215, of 16 KB Hiperspace index buffers you require.
HSINDEX20K(number)
Specifies the number, in the range 0 through 16777215, of 20 KB Hiperspace index buffers you require.
HSINDEX24K(number)
Specifies the number, in the range 0 through 16777215, of 24 KB Hiperspace index buffers you require.
HSINDEX28K(number)
Specifies the number, in the range 0 through 16777215, of 28 KB Hiperspace index buffers you require.
HSINDEX32K(number)
Specifies the number, in the range 0 through 16777215, of 32 KB Hiperspace index buffers you require.
INDEX BUFFERS
Specify the number of index buffers of each size that you require, in the range 3 through 32767. If you leave these fields blank, there are no default values.
INDEX512(number)
Specifies the number, in the range 3 through 32767, of 512 byte index buffers you require.
INDEX1K(number)
Specifies the number, in the range 3 through 32767, of 1 KB index buffers you require.
INDEX2K(number)
Specifies the number, in the range 3 through 32767, of 2 KB index buffers you require.
INDEX4K(number)
Specifies the number, in the range 3 through 32767, of 4 KB index buffers you require.
INDEX8K(number)
Specifies the number, in the range 3 through 32767, of 8 KB index buffers you require.
INDEX12K(number)
Specifies the number, in the range 3 through 32767, of 12 KB index buffers you require.
INDEX16K(number)
Specifies the number, in the range 3 through 32767, of 16 KB index buffers you require.
INDEX20K(number)
Specifies the number, in the range 3 through 32767, of 20 KB index buffers you require.
INDEX24K(number)
Specifies the number, in the range 3 through 32767, of 24 KB index buffers you require.
INDEX28K(number)
Specifies the number, in the range 3 through 32767, of 28 KB index buffers you require.
INDEX32K(number)
Specifies the number, in the range 3 through 32767, of 32 KB index buffers you require.
LSRPOOL(name)
Specifies the name of the local shared resource pool being defined. The name can be up to 8 characters in length.

If only DATA BUFFERS is specified, one set of buffers is built for the pool to be used for both the index and the data components of a VSAM KSDS data set.

If no data buffers are specified, CICS calculates the buffers required for both data and index components, both components sharing the same set of buffers.

If INDEX BUFFERS is specified, two parts of the pool are built, one for data and the other for index buffers. If you specify INDEX BUFFERS, you must also specify DATA BUFFERS.

LSRPOOLID({1|lsrpool})
This attribute is obsolete, but is supported to provide compatibility with earlier releases of CICS.

The value specified for LSRPOOLID in existing definitions is transferred to the new option LSRPOOLNUM.

LSRPOOLNUM({1|number})
Specifies the identifier of the local shared resource pool that is being defined. The value must be in the range 1 through 255.
MAXKEYLENGTH(number)
Specifies the maximum key length of any of the files that are to share resources. The value must be in the range 0 through 255. This value overrides part of the CICS resource calculation. If you do not specify it, CICS determines the maximum key length, recalculating it each time the LSR is rebuilt.
SHARELIMIT(number)
Specifies, as an integer, the percentage of the maximum amount of VSAM resources to be allocated. The number can be any value from 1 through 100.

Specify SHARELIMIT if CICS is to calculate the maximum amount of resources required by the VSAM files that are to share resources. Because these resources are to be shared, some percentage of this maximum amount of resources must be allocated. If this attribute is omitted, 50 percent of the maximum amount of resources is allocated.

If both the STRINGS and SIZE attributes are specified, SHARELIMIT has no effect.

STRINGS(number)
Specifies the limit, in the range 1 through 255, of all the strings of the files in the pool. For more information, see Number of buffers and strings for LSR and NSR pools.