LSR pool: Resource statistics for each LSR pool

You can retrieve LSR pool resource statistics by using the EXEC CICS EXTRACT STATISTICS LSRPOOL system command. They are mapped by the DFHA08DS DSECT.

The following information describes the size and characteristics of the pool, and shows the data collected for the use of strings and buffers.
Table 1. LSR pool: Resource statistics for each LSR pool
DFHSTUP name Field name Description
Pool Number A08SRPID The identifying number of the pool. This value must be in the range 1 through 255.

Reset characteristic: not reset

 

NOT IN THE DFHSTUP REPORT A08FLAGS A flag set to value X'80' if separate data and index pools are used, or set to value X'00' if data and index buffers share the same pool.

Reset characteristic: not reset

 

Time Created A08LKCTD The time when this LSR pool was created. The DFHSTUP report expresses this time as hours:minutes:seconds.decimals in local time.

Reset characteristic: not reset

 

Time Deleted A08LKDTD The local time (STCK) when this LSR pool was deleted. This field is printed only if the pool has been deleted (that is, if all the files using the pool have been closed). If no value is set, the DSECT field contains the packed hexadecimal value X'00000000 00000000'.

This field is only printed for unsolicited statistics when the pool is deleted.

The process of deleting an LSR pool results in the output of unsolicited statistics for the pool. Information for the deleted pool is not printed in subsequent statistics output. For this reason, the “time pool deleted” field is normally printed only in this unsolicited statistics output.

Reset characteristic: not reset

 

NOT IN DFHSTUP REPORT A08GBKCD The time when this LSR pool was created. The DFHSTUP report expresses this time as hours:minutes:seconds.decimals in GMT.

Reset characteristic: not reset

 

NOT IN DFHSTUP REPORT A08GBKDD The time when this LSR pool was deleted expressed in GMT. This field is printed only if the pool has been deleted (that is, if all the files using the pool have been closed). If no value is set, the DSECT field contains the packed hexadecimal value X'00000000 00000000'

This field is only printed for unsolicited statistics when the pool is deleted.

The process of deleting an LSR pool results in the output of unsolicited statistics for the pool. Information for the deleted pool is not printed in subsequent statistics output. For this reason, the “time pool deleted” field is normally printed only in this unsolicited statistics output.

Reset characteristic: not reset

 

Maximum key length A08BKKYL The length of the largest key of a VSAM data set that can use the LSR pool. The value is obtained from one of the following sources:
  • The MAXKEYLENGTH option of the DEFINE LSRPOOL command in resource definition online, if it has been coded
  • A CICS® calculation at the time the LSR pool is built.

Reset characteristic: not reset

 

Total number of strings A08BKSTN The value obtained from one of the following sources:
  • The STRINGS option of the DEFINE LSR command in resource definition online, if it has been coded
  • A CICS calculation at the time the LSR pool is built.

Reset characteristic: not reset

 

Peak requests that waited for string A08BKHSW The highest number of requests that were queued at one time because all the strings in the pool were in use.

Reset characteristic: reset to current value

 

Total requests that waited for string A08BKTSW The number of requests that were queued because all the strings in the pool were in use. This number reflects the number of requests that were delayed during CICS execution due to a restriction in LSR pool string resources.

Reset characteristic: reset to zero

 

Peak concurrently active strings A08BKHAS The maximum number of strings that were active during CICS execution. If you have coded a value for the number of strings the pool is to use, this statistic is always less than or equal to the value you have coded. If your coded value for string numbers is consistently higher than this value in the statistics, you could consider reducing it so that your pool of VSAM strings is not bigger than you need.

Reset characteristic: reset to current value

 

Note that if separate data and index pools are not being used, all the statistics for the totals are obtained from the A08TOxxx_DATA variables, the index totals being unused.