This function invokes the List Objects screen where you can obtain statistical data on the directories of Natural objects currently loaded in the buffer pool or the BP cache (if used). If applied to the message pool, a list of all Natural system or user messages currently loaded in the message pool is displayed.
This document provides information on the statistical data displayed on the List Objects screen and the commands and functions available for selecting an object or a range of objects, manipulating their current status or navigating in the List Objects screen.
Because the List Objects screen for Natural objects differs from the screen for messages, each screen is described in a separate chapter:
This section covers the following topics:
To invoke the List Objects screen for Natural objects
In the SYSBPM Main Menu, enter function code L
in the Code .. input field, and B
,C
or *
in the Object Pool selection field and
specify the objects, see valid field input
values described in the section Invoking and Operating
SYSBPM.
Or:
Go directly to the list of objects in the buffer pool by entering the following
SYSBPM direct command:
DISPLAY LIST library-name object-name dbid fnr
Or:
Go directly to the list of objects in the BP cache by entering the following
SYSBPM direct command:
DISPLAY CLIST library-name object-name dbid fnr
A List Objects screen similar to the example below appears:
17:13:17 ***** NATURAL SYSBPM UTILITY ***** 2002-09-16 BPNAME QA41GBP - List Objects - Type Global Nat BPPROP OFF Loc DAEF QA41 C Library Object DBID FNR Loc RLD Use Max Reuse TotalUC ObjSize Sto *_______ *_______ _____ ____ ___ ___ ___ ___ ______ ___________ _______ ___ __ SYSBPM BPMCALL 10 1640 B 1 1 5 8,516 12 __ SYSBPM BPMNSC 10 410 B 1 4 3,380 4 __ SYSDLINP PCNDL02 255 253 B R 1 19 292 4 __ SYSLIBS NAT00017 10 410 B 1 1 5,000 8 __ SYSLIB ATEST 10 1640 B R 1 340 16,148 16 __ SYSLIB CATALL10 10 410 B 1 1 4,256 8 __ SYSBPM BPM141-M 10 1640 B 1 1 5,944 8 __ SYSDLINS U246005 255 253 B R 1 14 52 4 __ SYSBPM MENU 10 1640 B 1 5 10,392 12 __ SYSLIBS NAT00040 10 410 B 1 1 2,816 4 __ SYSLIBS NAT00034 10 410 B 1 1 2,672 4 __ SYSDLIND DNDL01 255 253 B R 3 42 552 4 __ SYSLIB ACATALL 10 410 B 1 3 55,728 56 __ SYSDLINS U246004 255 253 B R 2 28 172 4 Top of List Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Last Cache -- - + ++ > Canc |
See also the function for a sorted display of objects.
The List Objects screen lists all individual objects
currently loaded in the buffer pool (first part of the display) and
currently loaded in the BP cache (second part of the display).
The statistics displayed are snapshots of the contents of the buffer pool which are refreshed every time you press ENTER.
On the List Objects screen, two entries may be displayed for a GDA (global data area) or LDA (local data area): one entry contains the GDA/LDA data itself and the other entry contains the internal Natural symbol table for this GDA/LDA. This can happen if a program has been cataloged that references this GDA/LDA.
This section describes the columns of the List Objects screen for Natural objects, including the associated input fields and selection criteria to shorten the list of objects displayed.
The following topics are covered:
This section covers the following topics:
To specify selection criteria for the objects to be displayed
In the input fields underneath the column titles, enter a valid value or range as described for the relevant fields.
The default value is a blank character or asterisk (*) which selects all objects.
Column | Explanation | ||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
C | In this column, you can enter a line command to perform a function for the object. See also Line Commands. | ||||||||||||||||||||||||||||||||||
Library | The library from which the object was loaded.
To specify selection criteria, see Name and Range Specification. |
||||||||||||||||||||||||||||||||||
Object | The name of the object.
To specify selection criteria, see Name and Range Specification. |
||||||||||||||||||||||||||||||||||
DBID | The database ID of the Natural system file from which the object was
loaded.
To select objects of a specific database, enter a valid numeric value. |
||||||||||||||||||||||||||||||||||
FNR | The file number of the Natural system file from which the object was
loaded.
To select objects of a specific file, enter a valid numeric value. |
||||||||||||||||||||||||||||||||||
Loc |
|
||||||||||||||||||||||||||||||||||
RLD |
|
||||||||||||||||||||||||||||||||||
Use |
|
||||||||||||||||||||||||||||||||||
Max | Buffer pool only.
The maximum number of applications that have executed the object since it was loaded into the buffer pool. To select objects, see the valid input values in Use above. |
||||||||||||||||||||||||||||||||||
Reuse | BP cache only.
Indicates how many time the object has been loaded (reused) from the BP cache into the buffer pool. To select objects, see the valid input values in Use above. |
||||||||||||||||||||||||||||||||||
TotalUC |
|
||||||||||||||||||||||||||||||||||
ObjSize | The size of the object.
To select objects, see the valid input values in TotalUC above. |
||||||||||||||||||||||||||||||||||
Sto | Storage that has to be allocated for the object in the buffer pool or BP
cache. The text record size of the buffer pool is defined at buffer pool
initialization.
To select objects, see the valid input values in Use above. |
||||||||||||||||||||||||||||||||||
BP Load Time* | The date and time when the object was first loaded into the buffer pool.
This date and time will be kept until the object has been removed from both the buffer pool and BP cache (deletion from the BP cache only will not remove the display of date and time). To select objects, see Date Specification and Time Specification. |
||||||||||||||||||||||||||||||||||
BP Last Action* | Buffer pool only.
The date and time when the object was last used by an application. To select objects, see Date Specification and Time Specification. |
||||||||||||||||||||||||||||||||||
BPC Load Time* | BP cache (BPC) only.
The date and time when the object was first loaded into the BP cache. This date and time will be kept until the object has been removed from the BP cache. To select objects, see Date Specification and Time Specification. |
||||||||||||||||||||||||||||||||||
BPC Last Get* | BP cache (BPC) only.
The date and time when the object was last swapped from the buffer pool into the BP cache. This time stamp is also updated if the object was already available in the BP cache and had therefore not been written to the BP cache again. To select objects, see Date Specification and Time Specification. |
||||||||||||||||||||||||||||||||||
BPC Last Put* | BP cache (BPC) only.
The date and time when the object was last loaded from the BP cache into the buffer pool. To select objects, see Date Specification and Time Specification. |
||||||||||||||||||||||||||||||||||
1.BPperiod* | BP cache (BPC) only.
The time frame the object has been available in
the buffer pool starting with the time the object was first loaded and
ending with the time the object was first swapped from the buffer pool into
the BP cache. After 24 hours, the display of the time frame is canceled and
replaced by this sign: |
||||||||||||||||||||||||||||||||||
NatVers* | The Natural version number an object is cataloged with. |
* press PF11 to display these columns as described in PF Keys and Direct Commands
This section covers rules on how to specify selection criteria in terms of ranges for the columns Library and Object:
You can shorten the list of objects displayed on the List Objects screen by entering a name or a range of names in the input fields for Library and/or Object.
In the list of options below, value is any combination of one or more characters:
Input Value | Selected Libraries/Objects |
---|---|
* | All libraries/objects.
This is the default. |
value | All libraries/objects with a name equal to value. |
value* | All libraries/objects with a name that starts with
value.
Example: |
value? | All libraries/objects with a name that starts with
value and ends with any single character for each
question mark (?) entered.
Example: |
value?value? | All items that match value
combined with asterisk (*) and question mark (?) in any order.
Example: |
value*value? | |
*value?value* | |
value> | All libraries/objects with a name greater than or equal to
value.
Example: |
value< | All libraries/objects with a name less than or equal to
value.
Example: |
You can shorten the list of objects displayed on the List Objects screen by entering a date, a range of dates, a special date or a range of special dates in the input fields for dates.
A date must be specified in the format YYYYMMDD (YYYY = year, MM = month, DD = day).
In the list of options below, value is any combination of one or more digits:
You can shorten the list of objects displayed on the List Objects screen by entering a time or a range of times in the input fields for times.
The time must be specified in the format HH:II:SS (HH = hours, II = minutes, SS = seconds).
In the list of options below, value can be any combination of one or more digits:
Input Value | Selected Objects |
---|---|
HH:II:SS | All objects with a time equal to
HH:II:SS.
Example: |
value* | All objects with a time that starts with
value.
Example: |
value> | All objects with a time greater than or equal to
value.
Example: |
value< | All objects with a time less than value.
Example: |
On the List Objects 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 SYSBPM help information. If chosen with the cursor on the input fields underneath the column titles: lists all possible input values for object selection. |
|
PF3 |
EXIT |
Leaves the current function/screen and displays the previous screen. |
PF4 | LAST |
Displays the SYSBPM direct command entered most recently. |
PF5 |
CACHE |
Only applicable if BP cache data exists.
Scrolls to the top of the list with statistical data on BP cache objects. |
PF6 | - |
Scrolls to the top of the list with statistical data on buffer pool objects. |
PF7 | - |
Scrolls one page up in a list. |
PF8 | + |
Scrolls one page down in a list. |
PF9 | ++ |
Scrolls to the end of the list. |
PF10 | < |
Scrolls left in the list.
Press PF11 to scroll to the right. |
LEFT |
||
PF11 | > |
Scrolls right in the list and displays the additional screen
columns: BP Load Time, BP Last Action,
BPC Load Time, BPC Last Get,
BPC Last Put and 1.BPperiod.
Press PF10 to scroll to the left. |
RIGHT |
||
PF12 |
CANCEL |
Same as EXIT .
|
PF15 | MENU |
Return to the SYSBPM Main Menu. |
On the List Objects screen, in column C, for each object displayed, you can enter one of the line commands listed below:
Command | Function |
---|---|
CL |
Buffer pool only.
Releases an object marked as resident. |
DE |
Marks an object to be deleted from the buffer pool or BP cache.
The
object is deleted as soon as the relevant Use count
changes to |
HD |
Buffer pool only.
Displays in hexadecimal format the directory information of an object. |
HE |
Buffer pool only.
Corresponds to the function as described in the relevant section. |
FO |
Buffer pool only.
Deletes an object immediately from the buffer pool, regardless of the relevant Use count. |
LD |
Corresponds to the function as described in the relevant section. |
RE |
Buffer pool only.
Marks an object as resident. |
ZO |
Zooms in the fields Object,
Use, Max,
Reuse, TotalUC,
ObjSize and Sto and displays
them in full length. |
For each command entered, a confirmation message appears for the relevant line overwriting text of rows displayed on the screen. Possible messages are:
Failed
(in response to any function that has not been
executed successfully),
Deleted
(in response to the command
DE
or FO
),
Released
(in response to the command
CL
) and
Resident
(in response to the command
RE
).
This section covers the following topics:
To invoke the List Objects screen for system and user messages
In the SYSBPM Main Menu, enter function code L
in the Code.. field and selection criterion M
in
the Object Pool selection field and specify the messages, see
valid field input values
described in the section Invoking and Operating SYSBPM.
Or:
Go directly to the list of objects in the buffer pool by entering the following
SYSBPM direct command:
DISPLAY MLIST start-number end-number library-name language dbid fnr codepage
A List Objects screen similar to the example below appears:
17:13:17 ***** NATURAL SYSBPM UTILITY ***** 2002-09-16 BPNAME QA41GBP - List Objects - Type Global Nat BPPROP OFF Loc DAEF QA41 C Library Nmbr DBID FNR Code Page LC Message Text *_______ ____ _____ ____ *_______ __ __ XXXLIB 25 177 8 CPAGE02 2 U0025 TEST TEST TEST __ <NATSYS> 80 10 2430 IBM01141 1 Command / program name must start wi __ <NATSYS> 82 10 2430 IBM01141 1 Invalid command, or :1: :2: does not __ XXXLIB 102 177 8 CPAGE02 2 U0102 TEST TEST TEST __ GGSLIB 296 177 7 CPAGE22 34 U0296 TEST TEST TEST __ <NATSYS> 631 10 2430 IBM01141 1 Invalid index specified in arithmeti __ <NATSYS> 660 10 2430 IBM01141 1 Time-stamp inconsistency for segment __ XXXLIB 759 177 8 CPAGE02 2 U0759 TEST TEST TEST __ XXXLIB 789 177 8 CPAGE02 2 U0789 TEST TEST TEST __ XXXLIB 806 177 8 CPAGE02 2 U0806 TEST TEST TEST __ XXXLIB 853 177 8 CPAGE02 2 U0853 TEST TEST TEST __ <NATSYS> 932 10 2430 IBM01141 1 Program version error. __ <NATSYS> 933 10 2430 IBM01141 1 GDA time-stamp conflict. __ <NATSYS> 933 10 2430 IBM01140 1 GDA time-stamp conflict. Top of List Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit -- - + ++ Canc |
The List Objects screen lists all individual messages currently
loaded in the message pool. It will be refreshed every time you press
ENTER
.
This section describes the columns of the List Objects screen for messages, including the associated input fields and selection criteria to shorten the list of objects displayed.
To specify selection criteria for the objects to be displayed
In the input fields underneath the column titles, enter a valid value or range as described for the relevant fields.
The default value is a blank character or asterisk (*) which selects all objects.
This section gives a tabular overview on Fields of the List Object menue.
Column | Explanation |
---|---|
C | In this column, you can enter a line command to perform a function for the corresponding message. See also Line Commands. |
Library | The library from which the message was loaded.
To specify selection criteria, see Name and Range Specification. |
Nmbr | The number of the message.
To select messages of a specific number, enter a valid numeric value. |
DBID | The database ID of the Natural system file from which the message was
loaded.
To select a message of a specific database, enter a valid numeric value. |
FNR | The file number of the Natural system file from which the message was
loaded.
To select messages of a specific file, enter a valid numeric value. |
Code Page | The code page under which the message has been saved. |
LC | The language code under which the message has been saved. |
Message Text | The beginning of a message short text. |
* press PF11 to display these columns as described in PF Keys and Direct Commands
See the Name and Range Specification section in the List Natural Objects chapter.
On the List Objects 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 SYSBPM help information. If chosen with the cursor on the input fields underneath the column titles: lists all possible input values for object selection. |
|
PF3 |
EXIT |
Leaves the current function/screen and displays the previous screen. |
PF6 | - |
Navigates to the top of the list of messages in the message pool. |
PF7 | - |
Scrolls one page up in a list. |
PF8 | + |
Scrolls one page down in the list. |
PF9 | ++ |
Navigates to the end of the list. |
PF12 |
CANCEL |
Same as EXIT .
|
PF15 | MENU |
Returns to the SYSBPM Main Menu. |
On the List Objects screen, in column C, for each object displayed, you can enter one of the line commands listed below:
Command | Function |
---|---|
DE |
Deletes a message from the message pool. The entry is replaced by the confirmation "deleted". |