Directory Information

This function is used to display the full directory of a Natural object currently loaded in the buffer pool or BP cache.

Start of instruction set To invoke Directory Information

  • In the SYSBPM Main Menu, specify the following:

    Enter function code I.

    In the fields Object, Library, DBID and FNR, specify the object for which to display the directory: the valid input values are described in Invoking and Operating SYSBPM.

    In the Object Pool field, enter the code that corresponds to the object pool from which to read the object directory information:

    B or * (asterisk) Buffer pool
    C BP cache

    Or:
    Use either of the following SYSBPM direct commands: 

    • DISPLAY DIRECTORY library-name object-name dbid fnr

      (For the directory of the specified object loaded in the buffer pool.) 

    • DISPLAY CDIRECTORY library-name object-name dbid fnr

      (For the directory of the specified object loaded in the BP cache.)

    The Directory Information screen appears. Depending on the object pool (buffer pool or BP cache) selected, the screen provides different fields as described in the following section.

Fields for Buffer Pool Objects

For directories of objects loaded in the buffer pool, the Directory Information screen provides the following fields and information on a specified object:

Field Explanation
Directory of The type (for example, map) and name of the object.
Loaded from Library The name of the library from which the object was loaded into the buffer pool.
on DBID/FNR The database ID (DBID) and file number (FNR) of the system file FNAT or FUSER from which the object was loaded into the buffer pool.
on The date and time when the object was loaded into the buffer pool.
by User The ID of the user who executed the object.
Last Action on The date and time when the object was last used by an application.
BP Directory at Address The address of the directory of the object in the buffer pool.
Object at Address The address of the object in the buffer pool.
Allocated Size (KB) The size that has been allocated in the buffer pool for the object.
Object Size The size of the object.
Status (RLD)
The status of the object:
   
R       The object is resident in the buffer pool.
Resident means that the object is not deleted from the buffer pool, not even if its Current Use Count (see below) changes to 0 (zero).
   
L The object is currently locked.
   
D A Delete call for the object is pending. The object will be deleted from the buffer pool as soon as its Current Use Count (see below) changes to 0 (zero).
Current Use Count The number of applications currently executing the object.

A value of 0 (zero) denotes that the object is no longer used.

Maximum Use Count The maximum number of applications that have executed the object since it was loaded into the buffer pool.
BP Total Use The total number of times an object has been executed since it was loaded from the system file into the buffer pool.

If a BP cache is used, this value is not lost if the object is removed from the buffer pool and saved to the BP cache. Therefore, this value indicates the number of times the object has been used since it was loaded from the system file.

Cataloged The information displayed in the Cataloged section of the Directory Information screen is identical to the information provided with the Natural system command LIST DIRECTORY described in the System Commands documentation.

Fields for BP Cache Objects

For directories of objects loaded in the BP cache, the Directory Information screen provides the following fields and information on a specified object:

Field Explanation
object-type The type (for example, map) and name of the object.
Library The name of the library from which the object was loaded into the buffer pool.
DBID The database ID of the system file FNAT or FUSER from which the object was initially loaded into the buffer pool.
FNR The file number of the system file FNAT or FUSER from which the object was initially loaded into the buffer pool.
Last Put The date and time when the object was last loaded from the BP cache into the buffer pool.
BP Load Time The date and time when the object was first loaded into the buffer pool.
Cache Load Time The date and time when the object was first loaded into the BP cache.
Last Get The date and time when the object was last swapped from the buffer pool into the BP cache.
Position Index Serially numbered internal Natural position index of the objects in the BP cache.
First Data Block Offset The address of the directory of the object in the BP cache.
Allocated Size (KB) The size that has been allocated in the BP cache for the object.
Object Size The size of the object.
Status
The status of the object:
   
L Locked while load function is ongoing.
   
D Locked for delete.
Reuse Indicates how many times the object has been returned from the BP cache to the buffer pool.
BP Total Use The total number of times an object has been executed since it was initially loaded from the system file into the buffer pool and then into the BP cache.
Cataloged The information displayed in the Cataloged section of the Directory Information screen is identical to the information provided with the Natural system command LIST DIRECTORY described in the System Commands documentation.

PF Keys and Direct Commands

On the Directory Information screen, 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 help information on SYSBPM direct commands.
PF2 NEXT Only applies if a range of objects was selected.
Displays one object after the other and then redisplays the screen on which NEXT was entered.
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.
PF12 CANCEL Same as EXIT.
PF15 MENU Invokes the SYSBPM Main Menu.
  FDELETE Buffer pool only.

Deletes an object immediately from the buffer pool, regardless of its Use count.

  RESIDENT Buffer pool only.

Marks an object as resident. Resident means that the object is not deleted from the buffer pool, not even if its Use count is 0 (object no longer used).

  CLEAR Buffer pool only.

Releases an object marked as resident.
  DELETE Marks an object for deletion. See Status D of the buffer pool or BP cache mentioned in a previous section.