LSRPOOL attributes

Describes the syntax and attributes of the LSRPOOL resource.

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)
Index buffers
Read syntax diagramSkip visual syntax diagramINDEX512( number)INDEX1K( number)INDEX2K( number)INDEX4K( number)HSINDEX4K( number)INDEX8K( number)HSINDEX8K( number)INDEX12K( number)HSINDEX12K( number)INDEX16K( number)HSINDEX16K( number)INDEX20K( number)HSINDEX20K( number)INDEX24K( number)HSINDEX24K( number)INDEX28K( number)HSINDEX28K( number)INDEX32K( number)HSINDEX32K( number)
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 $ @ #
Any lowercase characters 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.