Format of OSAM buffer pool statistics

For OSAM buffer pool statistics, the values are possible for the stat-function parameter and for the format of the data that is returned to the application program. If no OSAM buffer pool is present, a GE status code is returned to the program.

DBASF

This function value provides the full OSAM database buffer pool statistics in a formatted form. The application program I/O area must be at least 360 bytes. Three 120-byte records (formatted for printing) are provided as two heading lines and one line of statistics. The following diagram shows the data format.

  BLOCK    FOUND    READS     BUFF     OSAM   BLOCKS     NEW   CHAIN
    REQ  IN POOL   ISSUED     ALTS   WRITES  WRITTEN  BLOCKS  WRITES
nnnnnnn  nnnnnnn    nnnnn  nnnnnnn  nnnnnnn  nnnnnnn   nnnnn   nnnnn
 
WRITTEN  LOGICAL    PURGE  RELEASE
 AS NEW      CYL      REQ      REQ  ERRORS
          FORMAT
nnnnnnn  nnnnnnn  nnnnnnn  nnnnnnn  nn/nn

BLOCK REQ: Number of block requests received.
FOUND IN POOL: Number of times the block requested was found in the buffer pool.
READS ISSUED: Number of OSAM reads issued.
BUFF ALTS: Number of buffers altered in the pool.
OSAM WRITES: Number of OSAM writes issued.
BLOCKS WRITTEN: Number of blocks written from the pool.
NEW BLOCKS: Number of new blocks created in the pool.
CHAIN WRITES: Number of chained OSAM writes issued.
WRITTEN AS NEW: Number of blocks created.
LOGICAL CYL FORMAT: Number of format logical cylinder requests issued.
PURGE REQ: Number of purge user requests.
RELEASE REQ: Number of release ownership requests.
ERRORS: Number of write error buffers currently in the pool or the largest number of errors in the pool during this execution.

DBASU

This function value provides the full OSAM database buffer pool statistics in an unformatted form. The application program I/O area must be at least 72 bytes. Eighteen fullwords of binary data are provided:

Word: Contents
1: A count of the number of words that follow.
2-18: The statistic values in the same sequence as presented by the DBASF function value.

DBASS

This function value provides a summary of the OSAM database buffer pool statistics in a formatted form. The application program I/O area must be at least 180 bytes. Three 60-byte records (formatted for printing) are provided. The following diagram shows the data format.

DATA BASE BUFFER POOL:  SIZE nnnnnnn
  REQ1 nnnnn REQ2 nnnnn READ nnnnn WRITES nnnnn LCYL nnnnn
  PURG nnnnn OWNRR nnnnn ERRORS nn/nn

SIZE: Buffer pool size.
REQ1: Number of block requests.
REQ2: Number of block requests satisfied in the pool plus new blocks created.
READ: Number of read requests issued.
WRITES: Number of OSAM writes issued.
LCYL: Number of format logical cylinder requests.
PURG: Number of purge user requests.
OWNRR: Number of release ownership requests.
ERRORS: Number of permanent errors now in the pool or the largest number of permanent errors during this execution.