Dieses Kapitel beschreibt das Aufrufen des Dienstprogramms SYSBPM und die Benutzung des SYSBPM-Hauptmenüs (Main Menu) einschließlich der relevanten Felder, Funktionen und Kommandos. Darüber enthält es Informationen zum Aufrufen der Online-Hilfe und zur Verwendung von SYSBPM in einer z/OS Parallel Sysplex-Umgebung.

In diesem Kapitel werden die folgenden Themen behandelt:

• SYSBPM aufrufen und beenden

• Online-Hilfe

• SYSBPM Hauptmenü - Felder, Funktionen und Kommandos

• SYSBPM in einer z/OS-Parallel-Sysplex-Umgebung

---

SYSBPM aufrufen und beenden

Um das Dienstprogramm SYSBPM aufzurufen:

• Geben Sie das folgende Natural-Systemkommando ein:

  SYSBPM

  Es erscheint das SYSBPM-Hauptmenü (Main Menu, Beispiel):

  10:02:50 ***** NATURAL SYSBPM UTILITY ***** 2023-05-23 BPNAME QA92GBP - Main Menu - Type Global Nat BPPROP OFF Loc DAEF QA92 Preload QA92GBPL Object Functions Object Pool Statistics L List Objects A Buffer Pool D Delete Objects C BP Cache I Directory Information M Message Buffer Pool H Hexadecimal Display W Write to Work File Other Functions X Display Sorted Extract ? Help S Select Buffer Pool . Exit B Blacklist Maintenance P Preload List Maintenance Code .. _ Library ... *_______ Object .... *_______________________________________ DBID ...... 0____ FNR .. 0____ Object Pool ... * (B,C,*) (M) Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Last Flip Canc

Um Auswahlfelder für Meldungsobjekte anzuzeigen:

• Geben Sie den Funktionscode L in das Eingabefeld Code .. und M in das Auswahlfeld Object Pool ein.

  Ein Fenster zur Angabe von Message Pool-Parametern wird angezeigt (Beispiel):

  10:20:54 ***** NATURAL SYSBPM UTILITY ***** 2023-05-23 BPNAME QA92GBP - Main Menu - Type Global Nat BPPROP OFF Loc DAEF QA92 Preload QA92GBPL +--------------Specify Message Pool Parameter--------------+ ! Message number .. 1___ - 9999 Library .. *_______ ! ! Language code ... 0_ DBID ..... 0____ ! ! Codepage ........ *_______ FNR ...... 0___ ! ! ! +----------------------------------------------------------+ W Write to Work File Other Functions X Display Sorted Extract ? Help S Select Buffer Pool . Exit B Blacklist Maintenance P Preload List Maintenance Code .. L Library ... *_______ Object .... *_______________________________________ DBID ...... 0____ FNR .. 0____ Object Pool ... M (B,C,*) (M) Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Last Flip Canc

Um die Anzeige des Fensters abzubrechen:

• Drücken Sie PF3 oder PF12.

Um das Dienstprogramm SYSBPM zu beenden:

• Drücken Sie PF3 oder PF12.

  Oder:
  Geben Sie in der Kommandozeile einen Punkt (.) oder EXIT ein.

Nachdem Sie das SYSBPM-Hauptmenü (Main Menu) aufgerufen haben, können Sie einen Funktionscode oder eine PF-Taste aus einem SYSBPM-Menü auswählen, um eine SYSBPM-Funktion auszuführen. Alternativ können Sie auch ein SYSBPM-Direktkommando verwenden, wie im entsprechenden Abschnitt beschrieben.

Die im SYSBPM-Hauptmenü angebotenen Funktionen sind in drei Abschnitte unterteilt:

• Der Abschnitt Object Functions enthält Funktionen zur Anzeige oder Bearbeitung von Natural-Objekten im Buffer Pool oder BP Cache und Natural-System- oder benutzerspezifische Meldungen im Message Pool.

• Der Abschnitt Object Pool Statistics enthält Funktionen zum Abrufen objektunabhängiger statistischer Daten über den Buffer Pool oder BP Cache, einschließlich Hash-Tabellen, und den Message Pool. Objektunabhängige Daten enthalten keine individuellen Informationen über das Objekt, wie z.B. Objektname, Größe oder Adressen.

• Der Abschnitt Other Functions enthält Funktionen zur Auswahl eines Buffer Pool im aktiven Subsystem (Subsid) und zur Angabe von Objekten, die in den Buffer Pool oder den Message Pool geladen werden sollen bzw. nicht geladen werden sollen.

Eine Beschreibung der verfügbaren Funktionen finden Sie unter Funktionen.

Zusätzlich zur Auswahl einer Funktion können Sie auch die Natural-Objekte oder Meldungen auswählen, auf die die Funktion angewendet werden soll, indem Sie eine der folgenden Optionen wählen:

• Füllen Sie die Eingabefelder (entweder für Natural-Objekte oder Meldungen) aus, wie in SYSBPM Hauptmenü - Felder, Funktionen und Kommandos beschrieben.

• Oder: Geben Sie in der Kommandozeile ein SYSBPM-Direktkommando ein, wie in SYSBPM-Direktkommandos beschrieben.

Online-Hilfe

Die Online-Hilfe des Dienstprogramms SYSBPM bietet Informationen zu den SYSBPM-Direktkommandos oder zu gültigen Eingabewerten für Felder, die auf SYSBPM-Bildschirmen vorhanden sind.

Um die Online-Hilfe für SYSBPM-Direktkommandos aufzurufen:

• Positionieren Sie auf einem SYSBPM-Bildschirm den Cursor in der Kommandozeile und drücken Sie PF1 oder geben Sie ein Fragezeichen (?) ein.

  Es erscheint das Help-Fenster mit einer Liste aller verfügbaren SYSBPM Direktkommandos.

Um die Online-Hilfe für ein SYSBPM-Eingabefeld aufzurufen:

• Positionieren Sie auf einem SYSBPM-Bildschirm den Cursor in dem betreffenden Eingabefeld und drücken Sie PF1 oder geben Sie ein Fragezeichen (?) ein.

  Es erscheint das Help-Fenster für das entsprechende Feld mit einer Liste aller gültigen Eingabewerte.

SYSBPM Hauptmenü - Felder, Funktionen und Kommandos

In diesem Abschnitt werden die folgenden Themen behandelt:

• Felder

• Funktionen

• PF-Tasten und Direktkommandos

Felder

Die folgende Tabelle beschreibt die Felder des SYSBPM-Hauptmenüs (Main Menu). Außerdem wird angegeben, ob ein Feld nur für einen Object Pool-Typ spezifisch ist (Buffer Pool und BP Cache bzw. Message Pool).

Felder	Erläuterung
BPNAME	Der Name des globalen Buffer Pools, wie mit dem Profilparameter BPNAME angegeben. Bei einem lokalen Buffer Pool wird kein Name, sondern ein leeres BPNAME-Feld angezeigt. Siehe auch BPNAME - Name des globalen Natural Buffer Pool in der Parameter-Referenz-Dokumentation.
BPPROP	Die Einstellung des Profilparameters BPPROP zur Steuerung der Weitergabe von Änderungen an einem Objekt in einem Buffer Pool. Siehe auch BPPROP - Global Buffer Pool-Weiterleitung in der Parameter-Referenz-Dokumentation.
Type	Der Typ des Buffer Pool, z.B. Global Nat, Local Nat, Global Sort oder Global DL/I.
Loc	Der Standort. Zeigt die Host-ID (im der obigen Beispielabbildung: DAEF) und die Subsystem-ID (im obigen Beispiel: QA41) an.
Preload	Der Name einer Preload-Liste, falls geladen. Siehe auch Preload-Liste verwalten.
Library	Der Name der Library, in der das ausgeführte Objekt (entweder aus dem Buffer Pool oder dem Message Pool) gespeichert ist. Sie können einen Namen angeben oder Stern-Notation (*) verwenden. Der standardmäßig vorhandene Stern (*) dient zur Auswahl aller Libraries. Dieses Feld gilt auch für Message Pools.
Object	Der Name des ausgeführten Objekts, das in den Buffer Pool geladen wurde. Sie können einen Namen angeben oder Stern-Notation (*) verwenden. Der standardmäßig vorhandene Stern (*) dient zur Auswahl aller Objekte.
DBID	Die Datenbankkennung (DBID) der Systemdatei FNAT oder FUSER, in der das ausgeführte Objekt aus dem Buffer Pool oder Message Pool gespeichert ist und aus der es geladen wird. Wenn Sie 0 (Null; dies ist der Standardwert) als DBID angeben, wird/werden das/die angegebene(n) Objekt(e) unabhängig von ihrer DBID ausgewählt. Jeder andere Wert als 0 steht für eine bestimmte DBID-Angabe. Dieses Feld gilt auch für Message Pools.
FNR	Die Dateinummer (FNR) der Systemdatei FNAT oder FUSER, in der das ausgeführte Objekt aus dem Buffer Pool oder Message Pool gespeichert ist und aus der es geladen wird. Wenn Sie 0 (Null; dies ist der Standardwert) als FNR angeben, wird/werden das/die angegebene(n) Objekt(e) unabhängig von ihrer FNR ausgewählt. Jeder andere Wert als 0 steht für eine bestimmte FNR-Angabe. Dieses Feld gilt auch für Message Pools.
Object Pool	Wählt den Typ des/der zu verwendenden Object Pool(s) aus.     B Buffer Pool C BP Cache. * Sowohl Buffer Pool als auch BP Cache. Dies ist die Standardeinstellung. M Message Pool Anmerkungen: Wenn Sie den Message Pool (M) gewählt haben, können Sie nur die Funktionen List Objects, Delete Objects, Select Buffer Pool und Preload List Maintenance ausführen, siehe Funktionen. Der angegebene Object Pool-Typ bestimmt den Teil der Objektliste, der zuerst angezeigt wird. Wenn Sie z.B. das Auswahlkriterium C eingeben, enthält der Teil die im BP Cache geladenen Objekte. Wenn Sie nach oben blättern, werden die im Buffer Pool geladenen Objekte angezeigt. Wenn kein Objekt im BP Cache gefunden wird, werden nur die Objekte des Buffer Pool angezeigt. Wenn die Funktion List Objects auf den Buffer Pool und den BP Cache angewendet wird (durch Auswahl von *), werden alle Objekte angezeigt, die entweder in den Buffer Pool oder in den BP Cache geladen sind. Im Buffer Pool geladene Objekte werden zuoberst angezeigt.

Spezifische Felder für Meldungen

Die folgenden Felder sind nur für die Auswahl von Meldungen verfügbar:

Felder	Erläuterung
Message Number	Die Nummer der Meldung.
Language Code	Der Sprachcode, unter dem die Meldung gespeichert wurde.
Codepage	Die Codepage, unter der die Meldung gespeichert wurde.

Funktionen

Im Folgenden sind die einzelnen Funktionen aufgeführt.

Sie rufen eine Funktion auf, indem Sie den einbuchstabigen Code, der der gewünschten Funktion entspricht, in das Feld Code.. eingeben, z.B. L für List Objects. Beachten Sie, dass Sie für den Message Pool nur die Funktionen List Objects, Delete Objects, Select Buffer Pool und Preload List Maintenance angeben können.

Code	Funktion	Erläuterung
L	List Objects	Zeigt Informationen zu den Objekten an, die entweder in den Buffer Pool und/oder den BP Cache (falls verwendet) oder den Message Pool (falls aktiviert) geladen sind. Auf jedes Listenelement kann einzeln zugegriffen werden, und auf jedes Objekt können verschiedene Zeilenkommandos ausgeführt werden.
D	Delete Objects	Löscht ein oder mehrere Objekte aus dem Buffer Pool, BP Cache oder Message Pool.
I	Directory Information	Zeigt die vollständigen Verzeichnisinformationen eines bestimmten Objekts an, das in den Buffer Pool oder den BP Cache geladen wurde.
H	Hexadecimal Display	Zeigt ein angegebenes, in den Buffer Pool geladenes Objekt im hexadezimalen Format an.
W	Write to Work File	Schreibt die Objektverzeichnisinformationen, die sich im Buffer Pool und/oder im BP Cache befinden, in eine lokale Datei oder eine PC-Textdatei.
X	Display Sorted Extract	Zeigt eine sortierte Liste von 50 Objektverzeichnissen an, die sich im Buffer Pool oder BP Cache befinden. Die Listenelemente können nach einem der angegebenen Sortierkriterien geordnet werden.
A	Buffer Pool	Ruft das Menü Buffer Pool Statistics auf. Von diesem Menü aus können Sie objektunabhängige Statistikfunktionen für den Buffer Pool aufrufen, einschließlich Hash-Tabellen-Statistiken.
C	BP Cache	BP Cache erforderlich. Ruft das Menü BP Cache auf. Von diesem Menü aus können Sie objektunabhängige Statistikfunktionen für den BP Cache aufrufen, einschließlich Hash-Tabellen-Statistiken.
M	Message Pool Statistics	Message Pool erforderlich. Ruft das objektunabhängige Menü Message Pool Statistics auf.
S	Select Buffer Pool	Zeigt eine Auswahlliste aller verfügbaren Buffer Pools an.
S und Object Pool M	Select Message Pool	Zeigt eine Auswahlliste aller verfügbaren Message Pools an.
B	Blacklist Maintenance	Ruft das Menü Blacklist Maintenance auf, das zur Pflege einer Sperrliste von Objekten dient, die nicht ausgeführt werden sollen.
P	Preload List Maintenance	Ruft das Menü Preload List Maintenance für den Buffer Pool oder den Message Pool (falls aktiviert) auf. In einer Preload-Liste können Sie die Namen von Objekten angeben, die vorab in den Buffer Pool oder den Message Pool geladen werden sollen.

PF-Tasten und Direktkommandos

Im SYSBPM-Hauptmenü (Main Menu) können Sie die PF-Tasten oder SYSBPM-Direktkommandos verwenden, die in der folgenden Tabelle aufgeführt sind. Ein unterstrichener Teil eines Kommandos stellt dessen Mindestabkürzung dar. Weitere Kommandos finden Sie unter SYSBPM-Direktkommandos.

PF Key	Kommando	Funktion
PF1		Liefert SYSBPM-Hilfeinformationen: siehe auch Online-Hilfe.
PF3	EXIT	Die aktuelle Funktion/der aktuelle Bildschirm wird verlassen und der vorherige Bildschirm angezeigt.
PF4	LAST	Zeigt das zuletzt eingegebene SYSBPM-Direktkommando an.
PF6	FLIP	Schaltet die PF-Tastenzeile um: Wechsel zwischen der Anzeige von PF1 bis PF12 und PF13 bis PF24.
PF12	CANCEL	Wie EXIT.
PF15	MENU	Rückkehr zum SYSBPM-Hauptmenü (Main Menu).

SYSBPM in einer z/OS-Parallel-Sysplex-Umgebung

Wenn Natural zu einem anderen Betriebssystem-Image (Host) wechselt, dann wechselt Natural auch die Buffer Pools. Ein Wechsel der Buffer Pools wird durch eine andere Host-ID angezeigt, die im Feld Loc eines SYSBPM-Bildschirms angezeigt wird.

Der Wechsel kann nach jeder Terminal-Ein-/Ausgabe erfolgen, d.h. nach der Wahl einer beliebigen Funktionstaste oder durch Drücken von ENTER. Nach dem Wechsel der Buffer Pools werden die Kommandos zum Blättern und Positionieren (TOP, BOTTOM, +, -, LEFT, RIGHT). nicht ausgeführt. Stattdessen beginnt die Liste mit dem Anfang des neuen Buffer Pools.

Wenn der Profilparameter BPPROP (siehe BPPROP - Global Buffer Pool-Weiterleitung in der Parameter-Referenz-Dokumentation) auf PLEX oder GPLEX gesetzt ist, werden SYSBPM-Kommandos, die Sperrlisten verändern, Objekte löschen oder den Buffer Pool initialisieren, zunächst wie üblich ausgeführt und dann an andere Buffer Pools weitergegeben, die im selben Subsystem verfügbar sind. Wenn ein BP-Wechsel dazu führt, dass eine Funktion abgebrochen oder weitergegeben wird, wird eine entsprechende Meldung angezeigt. Eine entsprechende Meldung wird auch angezeigt, wenn Natural erfolgreich zu einem anderen Host gewechselt und die Buffer Pools gewechselt hat.