LSRPOOL definition attributes

Read syntax diagramSkip visual syntax diagram
>>-LSRPOOL(name)--GROUP(groupname)--+-------------------+------->
                                    '-DESCRIPTION(text)-'   

>--+-------------------------------------+---------------------->
   '-| Data buffers |--| Index buffers |-'   

   .-LSRPOOLID(1)-------.                         
>--+--------------------+--MAXKEYLENGTH(number)----------------->
   '-LSRPOOLID(lsrpool)-'                         

>--+--------------------+--STRINGS(number)---------------------><
   '-SHARELIMIT(number)-'                    

Data buffers

   .--------------------------------------------.   
   V                                            |   
|----+----------------------------------------+-+---------------|
     +-DATA512(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)-'       

Read syntax diagramSkip visual syntax diagram
Index buffers

   .----------------------------------------------.   
   V                                              |   
|----+------------------------------------------+-+-------------|
     +-INDEX512(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. If you leave this field blank, there are no 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 1KB data buffers you require.
DATA2K(number)
specifies the number, in the range 3 through 32767, of 2KB data buffers you require.
DATA4K(number)
specifies the number, in the range 3 through 32767, of 4KB data buffers you require.
DATA8K(number)
specifies the number, in the range 3 through 32767, of 8KB data buffers you require.
DATA12K(number)
specifies the number, in the range 3 through 32767, of 12KB data buffers you require.
DATA16K(number)
specifies the number, in the range 3 through 32767, of 16KB data buffers you require.
DATA20K(number)
specifies the number, in the range 3 through 32767, of 20KB data buffers you require.
DATA24K(number)
specifies the number, in the range 3 through 32767, of 24KB data buffers you require.
DATA28K(number)
specifies the number, in the range 3 through 32767, of 28KB data buffers you require.
DATA32K(number)
specifies the number, in the range 3 through 32767, of 32KB data buffers you require.
DESCRIPTION(text)
You can provide a description of the resource 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 one. 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 lower case characters you enter are converted to upper case.

The GROUP name can be up to eight characters in length. Lowercase characters are treated as uppercase characters. Do not use group names beginning with DFH, because these characters are reserved for use by CICS.

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 4KB Hiperspace data buffers you require.
HSDATA8K(number)
specifies the number, in the range 0 through 16777215, of 8KB Hiperspace data buffers you require.
HSDATA12K(number)
specifies the number, in the range 0 through 16777215, of 12KB Hiperspace data buffers you require.
HSDATA16K(number)
specifies the number, in the range 0 through 16777215, of 16KB Hiperspace data buffers you require.
HSDATA20K(number)
specifies the number, in the range 0 through 16777215, of 20KB Hiperspace data buffers you require.
HSDATA24K(number)
specifies the number, in the range 0 through 16777215, of 24KB Hiperspace data buffers you require.
HSDATA28K(number)
specifies the number, in the range 0 through 16777215, of 28KB Hiperspace data buffers you require.
HSDATA32K(number)
specifies the number, in the range 0 through 16777215, of 32KB 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 4KB Hiperspace index buffers you require.
HSINDEX8K(number)
specifies the number, in the range 0 through 16777215, of 8KB Hiperspace index buffers you require.
HSINDEX12K(number)
specifies the number, in the range 0 through 16777215, of 12KB Hiperspace index buffers you require.
HSINDEX16K(number)
specifies the number, in the range 0 through 16777215, of 16KB Hiperspace index buffers you require.
HSINDEX20K(number)
specifies the number, in the range 0 through 16777215, of 20KB Hiperspace index buffers you require.
HSINDEX24K(number)
specifies the number, in the range 0 through 16777215, of 24KB Hiperspace index buffers you require.
HSINDEX28K(number)
specifies the number, in the range 0 through 16777215, of 28KB Hiperspace index buffers you require.
HSINDEX32K(number)
specifies the number, in the range 0 through 16777215, of 32KB Hiperspace index buffers you require.
INDEX BUFFERS
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 1KB index buffers you require.
INDEX2K(number)
specifies the number, in the range 3 through 32767, of 2KB index buffers you require.
INDEX4K(number)
specifies the number, in the range 3 through 32767, of 4KB index buffers you require.
INDEX8K(number)
specifies the number, in the range 3 through 32767, of 8KB index buffers you require.
INDEX12K(number)
specifies the number, in the range 3 through 32767, of 12KB index buffers you require.
INDEX16K(number)
specifies the number, in the range 3 through 32767, of 16KB index buffers you require.
INDEX20K(number)
specifies the number, in the range 3 through 32767, of 20KB index buffers you require.
INDEX24K(number)
specifies the number, in the range 3 through 32767, of 24KB index buffers you require.
INDEX28K(number)
specifies the number, in the range 3 through 32767, of 28KB index buffers you require.
INDEX32K(number)
specifies the number, in the range 3 through 32767, of 32KB index buffers you require.
LSRPOOL(name)
specifies the name of the local shared resource pool being defined. The name may be up to eight 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})
specifies the identifier of the local shared resource pool being defined. The value must be in the range 1 through 8.
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, Start of changerecalculating it each time the LSR is rebuiltEnd of change.
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 this 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.