This function is used to display the full directory of a Natural object currently loaded in the buffer pool or BP cache.
To invoke
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.
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) |
|
|||||||||||||||
Current Use Count | The number of applications currently executing
the object.
A value of |
|||||||||||||||
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.
|
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 |
|
||||||||||
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.
|
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
|
|
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.
|