Format of enhanced VSAM buffer subpool statistics

The enhanced VSAM buffer subpool statistics provide information on the total size of VSAM subpools in virtual storage and in hiperspace. All count fields are 10 digits.

Because there might be several buffer subpools for VSAM databases, the enhanced STAT call repeatedly requests these statistics. If more than one VSAM local shared resource pool is defined, statistics are retrieved for all VSAM local shared resource pools in the order in which they are defined. For each local shared resource pool, statistics are retrieved for each subpool according to buffer size.

The first time the call is issued, the statistics for the subpool with the smallest buffer size are provided. For each succeeding call (without intervening use of the PCB), the statistics for the subpool with the next-larger buffer size are provided.

If index subpools exist within the local shared resource pool, the index subpool statistics always follow the data subpools statistics. Index subpool statistics are also retrieved in ascending order based on the buffer size.

The final call for the series returns a GA status code in the PCB. The statistics returned are totals for all subpools in all local shared resource pools. If no VSAM buffer subpools are present, a GE status code is returned to the program.

VBESF

This function value provides the full VSAM database subpool statistics in a formatted form. The application program I/O area must be at least 600 bytes. For each shared resource pool ID, the first call returns five 120-byte records (formatted for printing). Three of the records are heading lines and two of the records are lines of subpool statistics.

The following shows the data format:

      B U F F E R   H A N D L E R   S T A T I S T I C S  /  V S A M   S T A T I S T I C S   FIXOPT=X/X/X   POOLID: xxxx
BSIZ NBUFFRS HS-NBUF  RETURN-RBA  RETURN-KEY  ESDS-INSRT  KSDS-INSRT  BUFFRS-ALT  BKGRND-WRT  SYNC-POINT  ERRORS
              VSAM-GETS  SCHED-BUFR  VSAM-FOUND  VSAM-READS  USER-WRITS   VSAM-WRITS  HSRDS-SUCC  HSWRT-SUCC HSR/W-FAIL
nn1K  nnnnnn nnnnnnn  nnnnnnnnnn  nnnnnnnnnn  nnnnnnnnnn  nnnnnnnnnn  nnnnnnnnnn  nnnnnnnnnn  nnnnnnnnnn  nnnnnn/nnnnnn
             nnnnnnnnnn  nnnnnnnnnn  nnnnnnnnnn  nnnnnnnnnn  nnnnnnnnnn   nnnnnnnnnn  nnnnnnnnnn  nnnnnnnnnn nnnnn/nnnnn

FIXOPT: Fixed options for this subpool. Y or N indicates whether the data buffer prefix, the index buffers, and the data buffers are fixed.
POOLID: ID of the local shared resource pool.
BSIZ: Size of the buffers in this subpool. Set to ALL for total line. For the summary totals (BSIZ=ALL), the FIXOPT and POOLID fields are replaced by a VS= field and a HS= field. The VS= field is the total size of the VSAM subpool in virtual storage. The HS= field is the total size of the VSAM subpool in hiperspace.
NBUFFRS: Number of buffers in this subpool. Total number of buffers in the VSAM pool that appears in the ALL line.
HS-NBUF: Number of hiperspace buffers defined for this subpool.
RETURN-RBA: Number of retrieve-by-RBA calls received by the buffer handler.
RETURN-KEY: Number of retrieve-by-key calls received by the buffer handler.
ESDS-INSRT: Number of logical records inserted into ESDSs.
KSDS-INSRT: Number of logical records inserted into KSDSs.
BUFFRS-ALT: Number of logical records altered in this subpool. Delete calls that result in erasing records from a KSDS are not counted.
BKGRND-WRT: Number of times the background write function was executed by the buffer handler.
SYNC-POINT: Number of Synchronization calls received by the buffer handler.
ERRORS: Number of write error buffers currently in the subpool or the largest number of write errors in the subpool during this execution.
VSAM-GETS: Number of VSAM Get calls issued by the buffer handler.
SCHED-BUFR: Number of VSAM Scheduled-Buffer calls issued by the buffer handler
VSAM-FOUND: Number of times VSAM found the control interval in the buffer pool.
VSAM-READS: Number of times VSAM read a control interval from external storage.
USER-WRITS: Number of VSAM writes initiated by IMS.
VSAM-WRITS: Number of VSAM writes initiated to make space in the subpool.
HSRDS-SUCC: Number of successful VSAM reads from hiperspace buffers.
HSWRT-SUCC: Number of successful VSAM writes from hiperspace buffers.
HSR/W-FAIL: Number of failed VSAM reads from hiperspace buffers/number of failed VSAM writes to hiperspace buffers. This indicates the number of times a VSAM READ/WRITE request from or to hiperspace resulted in DASD I/O.

VBESU

This function value provides full VSAM statistics in an unformatted form. The application program I/O area must be at least 104 bytes. Twenty-five fullwords of binary data are provided for each subpool.

Word

Contents

1

A count of the number of words that follow.

2-23

The statistics provided in the same sequence as presented by the VBESF function value.

24

The POOLID provided at the time the subpool is defined.

25

The first byte contains the subpool type, and the third byte contains the following fixed options for this subpool:

X'08' = INDEX BUFFERS fixed
X'04' = DATA BUFFER PREFIX fixed
X'02' = DATA BUFFERS fixed

The summary totals (word 2=ALL) for word 25 and word 26 contain the virtual and hiperspace pool sizes.

VBESS

This function value provides a summary of the VSAM database subpool statistics in a formatted form. The application program I/O area must be at least 360 bytes. For each shared resource pool ID, the first call provides six 60-byte records (formatted for printing).

The following shows the data format:

VSAM DB BUFFER POOL:ID xxxx   BSIZE nnnnnnK   TYPE x   FX=X/X/X
  RRBA  nnnnnnnnnn    RKEY       nnnnnnnnnn   BFALT  nnnnnnnnnn
  NREC  nnnnnnnnnn    SYNC PT    nnnnnnnnnn   NBUFS  nnnnnnnnnn
  VRDS  nnnnnnnnnn    FOUND      nnnnnnnnnn   VWTS   nnnnnnnnnn
  HSR-S nnnnnnnnnn    HSW-S      nnnnnnnnnn   HS NBUFS nnnnnnnn
  HS-R/W-FAIL   nnnnn/nnnnn       ERRORS    nnnnnn/nnnnnn

POOLID: ID of the local shared resource pool.
BSIZE: Size of the buffers in this VSAM subpool.
TYPE: Indicates a data (D) subpool or an index (I) subpool.
FX: Fixed options for this subpool. Y or N indicates whether the data buffer prefix, the index buffers, and the data buffers are fixed.
RRBA: Number of retrieve-by-RBA calls received by the buffer handler.
RKEY: Number of retrieve-by-key calls received by the buffer handler.
BFALT: Number of logical records altered.
NREC: Number of new VSAM logical records created.
SYNC PT: Number of sync point requests.
NBUFS: Number of buffers in this VSAM subpool.
VRDS: Number of VSAM control interval reads.
FOUND: Number of times VSAM found the requested control interval already in the subpool.
VWTS: Number of VSAM control interval writes.
HSR-S: Number of successful VSAM reads from hiperspace buffers.
HSW-S: Number of successful VSAM writes to hiperspace buffers.
HS NBUFS: Number of VSAM hiperspace buffers defined for this subpool.
HS-R/W-FAIL: Number of failed VSAM reads from hiperspace buffers and number of failed VSAM writes to hiperspace buffers. This indicates the number of times a VSAM READ/WRITE request to or from hiperspace resulted in DASD I/O.
ERRORS: Number of permanent write errors now in the subpool or the largest number of errors in this execution.