BP Cache Statistics

The BP Cache function only applies to a buffer pool of the type Natural.

This function invokes the BP Cache Statistics menu which is used to obtain statistical information on the BP cache.

Note that the BP Cache function can only be executed if a BP cache has been installed when initializing a global buffer pool (no BP cache support for local buffer pools).

Start of instruction set To invoke BP Cache Statistics

  • In the SYSBPM Main Menu, enter the following function code:

    C

    Or:
    Enter the following SYSBPM direct command:

    DISPLAY CSTATISTICS

    The BP Cache Statistics menu appears.

The functions available in the BP Cache Statistics menu and the commands provided on the screens that are invoked by these functions are explained in this section.


General BP Cache Statistics

This function displays addresses and statistics regarding the activity of the BP cache.

Start of instruction set To invoke General BP Cache Statistics

  • In the BP Cache Statistics menu, enter the following function code:

    G

    Or:
    Enter the following SYSBPM direct command:

    DISPLAY CGENERAL

    The General BP Cache Statistics screen appears.

The statistics displayed on the General BP Cache Statistics screen are snapshots of the buffer pool, which are refreshed each time you press ENTER. The following information is displayed:

Field Explanation
Dataspace - Name The name of the dataspace where the BP cache resides.
Dataspace - SToken The term SToken (for Space Token) identifies a dataspace.
Dataspace - ALET The term ALET (for Address List Entry Token) identifies an index for accessing the dataspace.
Dataspace - Size (MB) The size of the BP cache in MB.
Dataspace - Current state The status of the BP cache:
not initialized
locked for init
closed
free for operation
undefined
Dataspace - Initialization The date and time when the BP cache was initialized.
Internal buffer offsets - Header buffer The header of the BP cache which contains general BP cache information.
Internal buffer offsets - Hash buffer Contains the hash table (see also BP Cache Hash Table Statistics).
Internal buffer offsets - Directory buffer The address of the BP cache directory section relative to the beginning of the BP cache.

Each Natural object loaded in the BP cache requires a directory entry that contains information on this object. The space for these directory entries is acquired from the BP cache itself.

Internal buffer offsets - Text buffer The address of the text buffer relative to the beginning of the BP cache.

After allocating the space for all other buffers, the remaining space is divided into text records with a size of 4 KB.

An object can occupy one or more text records, depending on its size.

Tot. Text Records The total number of text records in the BP cache.

The number of text records depends on the BP cache size. The text record size for the BP cache is 4 KB.

Insert position The index number of the text record into which the next object will be inserted.

Objects will be inserted into the BP cache when they have to be removed from the buffer pool.

Reuse cycles The number of times the BP cache has been completely reused.

Every time the BP cache is full, the BP cache manager reuses the BP cache from the start and overwrites the object(s) from there. The objects will remain in the BP cache until the BP cache is used again.

Objects - Max Loaded The maximum number of objects currently loaded in the BP cache.
Objects - Loaded The number of objects currently loaded in the BP cache.

BP Cache Call Statistics

This function provides statistical information on the loading (put), retrieving (get) and deleting of objects into/from the BP cache. This information also serves as an indicator of BP cache performance.

Start of instruction set To invoke BP Cache Call Statistics

  • In the BP Cache Statistics menu, enter the following function code:

    L

    Or:
    Enter the following SYSBPM direct command:

    DISPLAY CLOAD

    The BP Cache Call Statistics screen appears.

The statistics displayed on the BP Cache Call Statistics screen are snapshots of the buffer pool which are refreshed each time you press ENTER. The following information is displayed:

Field Explanation
Search calls The number of Search calls the buffer pool sent to the BP cache while attempting to find an object in the BP cache.

If an object is found, a Search call results in a Get call.

Get calls (from BP cache) The number of Get calls the buffer pool sent to the BP cache while attempting to load an object from the BP cache into the buffer pool.
Get calls - successful The number of successful Get calls the BP cache performed, that is, the number of objects the BP cache swapped into the buffer pool.

A Get call is successful if an object the buffer pool attempted to load is actually loaded from the BP cache into the buffer pool.

A Get call is unsuccessful, for example, if an object was deleted after it was found by the Search call.

Put calls (to BP cache) The number of Put calls the buffer pool sent to the BP cache while attempting to swap an object from the buffer pool into the BP cache.
Put calls - successful The number of Put calls that resulted in an object to swapped from the buffer pool into the BP cache.
Put calls - obj. already cached The number of Put calls the buffer pool sent to the BP cache for objects that were already loaded in the BP cache.
Delete calls The number of Delete calls the buffer pool sent to the BP cache while attempting to delete an object from the BP cache.

A Delete call requests either a single object or a range of objects (see also the section Delete Objects).

Delete calls - successful The number of successful Delete calls the buffer pool sent to the BP cache.

A Delete call is successful if at least one object is actually deleted from the BP cache.

A Delete call is unsuccessful if the object requested was not loaded in the BP cache and hence could not be deleted.

Compared with the total number of Delete calls, the number of successful Delete calls can be very low. This happens, for example, if several Natural objects are cataloged with the CATALL command. In this case, for every object cataloged successfully, Natural sends a Delete call to the BP cache. However, at the time the Delete call is sent, most of the cataloged objects are usually not loaded in the BP cache and the delete attempt fails.

Nbr objects deleted - by roll-over The number of Natural objects which have been deleted due to a full cache before new objects could be loaded.
Nbr objects deleted - by command The number of Natural objects, which have been deleted by the SYSBPM function all or by Natural commands or utilities such as CAT, STOW, CATALL or SYSMAIN.

Note:
You can delete multiple objects with Delete call.

Initialization The date and time when the BP cache was initialized.
Last reuse cycle The load date and time of the object that was most recently overwritten.

An object is overwritten in the BP cache when its space has to be reused in order to load another object. The object that was loaded first in the BP cache will be swapped first. This means the load date and time of the object that has been in the BP cache longest corresponds to the date and time in Last reuse cycle.

Last access The date and time when the buffer pool last accessed the BP cache.
Last Put (to BP cache) The date and time when the buffer pool last sent a Put call to the BP cache.
Last Get (from BP cache) The date and time when the buffer pool last sent a Get call to the BP cache.
Last Delete The date and time when the buffer pool last sent a Delete call to the BP cache.

BP Cache Hash Table Statistics

This function displays statistics about hash table slots and collisions per slot. The statistics determine the efficiency of the hash algorithm used.

Start of instruction setTo invoke BP Cache Hash Table Statistics

  1. In the BP Cache Statistics menu, enter the following function code:

    H

    Or:
    Enter the following SYSBPM direct command:

    DISPLAY CHASH

    The Cache Hash Table Collisions screen appears.

The statistics displayed on the Cache Hash Table Collisions screen are snapshots of the hash table which are refreshed every time you press ENTER. The following information is displayed:

Field Explanation
Total Number of Slots The total number of hash table slots; that is, the total possible entries that link the object name with the location of the object.

The number of slots, that is, the size of the hash table will be calculated internally depending on the number of text records.

Number of Slots used The number of slots that have one or more entries.
Number of Slots free The number of slots that have no entry.
Max. Collisions per Slot The maximum number of collisions of all slots.

The maximum number of collisions is the longest possible search path for an object.

Collisions The number of possible collisions.

0 (zero) means no collision or one entry. When there are more than 5 collisions, the number of collisions will be specified in ranges (for example, 6 - 10).

Number of Slots The number of slots grouped by their number of collisions.

For example, if the number of collisions is 3, the search algorithm must side step a maximum of 3 times to find an object. In addition, the percentage of these slots related to all slots used is displayed.

Number of Slots Totaled The same values as Number of Slots, but the values are totaled.

Performance Hints

See Performance Hints in the section Buffer Pool Statistics.

PF Keys and Direct Commands

On BP cache statistics screens, you can use the PF keys or SYSBPM direct commands listed in the table below. An underlined portion of a command represents its minimum abbreviation. For further commands, see SYSBPM Direct Commands.

PF Key Command Function
PF1   Provides SYSBPM help information: see also Online Help.
PF3 EXIT Leaves the current function/screen and displays the previous screen.
PF4 LAST Displays the SYSBPM direct command entered most recently.
PF6 FLIP Switches the PF-key line: toggles between the display of PF1 to PF12 and PF13 to PF24.

PF8
(CLoad)

DISPLAY CLOAD Only applies to the General BP Cache Statistics screen.

Displays the BP Cache Call Statistics screen.

PF8
(CGen)

DISPLAY CGENERAL Only applies to the BP Cache Call Statistics screen.

Displays the General BP Cache Statistics screen.

PF12 CANCEL Same as EXIT.
PF15 MENU Invokes the SYSBPM Main Menu.