Logical record cache summary report

This report includes the following information about the logical record cache to help you determine the most effective cache size for your installation:
  • Cache Name

    The name of the cache.

  • Cache Size

    The number of entries in the cache.

  • Timeout Value

    The amount of time, in seconds, that an entry resides in the cache before it is removed.

  • Read Calls Per Second

    The number of calls to read an entry from the cache.

  • Read Misses Per Second

    The number of calls that were not satisfied by the cache because the entry either was not in the cache or had timed out and was not valid.

  • Castouts Per Second

    The number of valid entries that had to be removed from the cache to make room for a new entry.

  • Hit Ratio

    The ratio of read calls to read misses.

  • Update Invalidates Per Second

    The number of times the cache will request the coupling facility (CF) to invalidate the cache entries for other processors for the same hash name because of an updateCacheEntry call by the application. This count will be zero for processor unique caches.

  • Read Buffer Invalidates Per Second

    The number of times a CF notifies an application to invalidate an entry in the cache. This count will be zero for processor unique caches.

  • Duplicate Hash Refused

    The number of times a cache entry was not added to the cache because its 16-byte name was the same as an entry already in the cache.

The following shows an example of a z/TPF Logical Record Cache Summary report.

Figure 1. Logical record cache summary report
 TPF LOGICAL RECORD CACHE SUMMARY
        11 OBSERVATIONS

CACHE NAME    CACHE SIZE   TIMEOUT   READ CALLS   READ MISSES  CASTOUTS    HIT RATIO   UPDATE        READ BUFFER   DUPLICATE
              (ENTRIES)     VALUE    PER SECOND   PER SECOND   PER SECOND              INVALIDATES   INVALIDATES   HASH
                          (SECONDS)                                                    PER SECOND    PER SECOND    REFUSED

IDNSHOSTADDR          10       3600        0.00          0.00        0.00      0.00%          0.00          0.00           0
IDNSHOSTNAME          10       3600        0.00          0.00        0.00      0.00%          0.00          0.00           0
MAIL_CACHES           10       3600        0.00          0.00        0.00      0.00%          0.00          0.00           0
TPF_FS_DIR           200         60        0.35          0.24        0.00     30.76%          0.00          0.00           0
TPF_FS_INODE         200         60        0.53          0.01        0.00     98.30%          0.11          0.01           0
CASH                  16          3      683.22          1.20        0.00     99.82%          1.04          1.17           0
MONEY                 16          3      970.67          2.72        0.00     99.71%          2.97          2.65           0
GOLDBARS              16          3      701.56          0.88        0.00     99.87%          1.57          0.86           0
INGOTS                16          3     1201.32          2.50        0.00     99.84%          1.19          0.82           0
DOLLARS               16          3      664.93          1.00        0.00     99.86%          1.29          1.03           0
ANDCENTS              16          3      769.09          1.04        0.00     99.84%          0.92          1.31           0
PENNIES               16          3      850.94          1.33        0.00     99.81%          2.51          2.15           0
CACH2                 16          3     1157.65          2.19        0.00     99.86%          1.47          0.96           0
CACH4                 16          3      734.97          0.97        0.00     99.70%          1.49          1.20           0
CACH6                 16          3      411.13          1.21        0.00     99.84%          1.19          0.82           0
LOCALC                16          3        0.00          0.00        0.00      0.00%          0.00          0.00           0