The
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
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).To invoke
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.
This function displays addresses and statistics regarding the activity of the BP cache.
To invoke
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:
|
|||||
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. |
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.
To invoke
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 |
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. |
This function displays statistics about hash table slots and collisions per slot. The statistics determine the efficiency of the hash algorithm used.
To invoke
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.
|
Number of Slots | The number of slots grouped by their number of collisions.
For example, if the number of collisions is |
Number of Slots Totaled | The same values as Number of Slots, but the values are totaled. |
See Performance Hints in the section Buffer Pool Statistics.
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 |
DISPLAY
CLOAD |
Only applies to the General BP Cache
Statistics screen.
Displays the BP Cache Call Statistics screen. |
PF8 |
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. |