CACHE_COUNTERS

Returns cache information.

Service:Server Environment
Defined In:nwfse.h

Structure

  typedef struct { 
     nuint32       readExistingBlockCount ; 
     nuint32       readExistingWriteWaitCount ; 
     nuint32       readExistingPartialReadCount ; 
     nuint32       readExistingReadErrorCount ; 
     nuint32       writeBlockCount ; 
     nuint32       writeEntireBlockCount ; 
     nuint32       getDiskCount ; 
     nuint32       getDiskNeedToAllocCount ; 
     nuint32       getDiskSomeoneBeatMeCount ; 
     nuint32       getDiskPartialReadCount ; 
     nuint32       getDiskReadErrorCount ; 
     nuint32       getAsyncDiskCount ; 
     nuint32       getAsyncDiskNeedToAlloc ; 
     nuint32       getAsyncDiskSomeoneBeatMe ; 
     nuint32       errorDoingAsyncReadCount ; 
     nuint32       getDiskNoReadCount ; 
     nuint32       getDiskNoReadAllocCount ; 
     nuint32       getDiskNoReadSomeoneBeatMeCount ; 
     nuint32       diskWriteCount ; 
     nuint32       diskWriteAllocCount ; 
     nuint32       diskWriteSomeoneBeatMeCount ; 
     nuint32       writeErrorCount ; 
     nuint32       waitOnSemaphoreCount ; 
     nuint32       allocBlockWaitForSomeoneCount ; 
     nuint32       allocBlockCount ; 
     nuint32       allocBlockWaitCount ; 
  } CACHE_COUNTERS; 
  

Delphi Structure

  uses calwin32 
   
    CACHE_COUNTERS = packed Record 
      readExistingBlockCount : nuint32;  
      readExistingWriteWaitCount : nuint32;  
      readExistingPartialReadCount : nuint32;  
      readExistingReadErrorCount : nuint32;  
      writeBlockCount : nuint32;  
      writeEntireBlockCount : nuint32;  
      getDiskCount : nuint32;  
      getDiskNeedToAllocCount : nuint32;  
      getDiskSomeoneBeatMeCount : nuint32;  
      getDiskPartialReadCount : nuint32;  
      getDiskReadErrorCount : nuint32;  
      getAsyncDiskCount : nuint32;  
      getAsyncDiskNeedToAlloc : nuint32;  
      getAsyncDiskSomeoneBeatMe : nuint32;  
      errorDoingAsyncReadCount : nuint32;  
      getDiskNoReadCount : nuint32;  
      getDiskNoReadAllocCount : nuint32;  
      getDiskNoReadSomeoneBeatMeCount : nuint32;  
      diskWriteCount : nuint32;  
      diskWriteAllocCount : nuint32;  
      diskWriteSomeoneBeatMeCount : nuint32;  
      writeErrorCount : nuint32;  
      waitOnSemaphoreCount : nuint32;  
      allocBlockWaitForSomeoneCount : nuint32;  
      allocBlockCount : nuint32;  
      allocBlockWaitCount : nuint32 
    End; 
  

Fields

readExistingBlockCount
Specifies the number of times an existing cache block has been read.
readExistingWriteWaitCount
Specifies the number of times an existing cache block was being read but had to wait until someone else was finished writing to it before it could be read completely.
readExistingPartialReadCount
Specifies the number cache blocks that were being read but encountered dirty sectors.
readExistingReadErrorCount
Specifies the number of cache blocks that experienced errors while trying to be read.
writeBlockCount
Specifies the number of cache buffers that were dirty and written to disk.
writeEntireBlockCount
Specifies the number of entire cache blocks that were dirty and written to disk.
getDiskCount
Specifies the number of times a block is obtained from disk to be compared against what is in a cache.
getDiskNeedToAllocCount
Specifies the number of times a cache control structure needs to be allocated because what is obtained from disk is not in a cache.
getDiskSomeoneBeatMeCount
Specifies the number of times a cache control structure is allocated to store new data from a disk but a recheck of a cache shows the new data is already stored indicating someone else beat the first attempt to store the data. (The newly allocated cache control structure is then returned to the available list.)
getDiskPartialReadCount
Specifies the number of times a disk was only partially read.
getDiskReadErrorCount
Specifies the number of times an error was encountered while reading data from a disk.
getAsyncDiskCount
Specifies the number of times a block is obtained from an asynchronous disk to be compared against what is in a cache.
getAsyncDiskNeedToAlloc
Specifies the number of times a cache control structure needs to be allocated because what is obtained from an asynchronous disk is not in a cache.
getAsyncDiskSomeoneBeatMe
Specifies the number of times a cache control structure is allocated to store new data from an asynchronous disk but a recheck of a cache shows the new data is already stored indicating someone else beat the first attempt to store the data. (The newly allocated cache control structure is then returned to the available list.)
errorDoingAsyncReadCount
Specifies the number of times an error occurred while reading from a disk. It is used to compare with what may or may not be in a cache.
getDiskNoReadCount
Specifies the number of times data is obtained from a disk and put into a cache without requesting a read on the data.
getDiskNoReadAllocCount
Specifies the number of times a new cache control structure has to be allocated during the time that data is obtained from disk to be put into a cache.
getDiskNoReadSomeoneBeatMeCount
Specifies the number of times a cache control structure has to be allocated during the time that data is obtained from disk to be put into a cache but a recheck of a cache shows the new data is already stored indicating someone else beat the first attempt to store the data. (The newly allocated cache control structure is then returned to the available list.)
diskWriteCount
Specifies the number of times a cache block has been written to disk.
diskWriteAllocCount
Specifies the number of times a cache control structure was allocated during the time that data is being written to disk.
diskWriteSomeoneBeatMeCount
Specifies the number of times a cache control structure has to be allocated during the time that a cache block is written to disk but a recheck of a cache shows the new data is already written to disk indicating someone else beat the first attempt to store the data. (The newly allocated cache control structure is then returned to the available list.)
writeErrorCount
Specifies the number of times an error was encountered while writing a cache to disk.
waitOnSemaphoreCount
Specifies the number of times a cache control blocks was waiting on a semaphore while cache and disk blocks were being checked
allocBlockWaitForSomeoneCount
Specifies the number of times that the allocate waiting count was set. You must set a semaphore and try again later.
allocBlockCount
Specifies the number of times a cache control block was allocated.
allocBlockWaitCount
Specifies the number of times the LRU and cache nodes were not available.