SYSBPM aufrufen und benutzen

#### Search Results

Search

# SYSBPM aufrufen und benutzen

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.

## 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. The location. Displays the host ID (in the example screen above: `DAEF`) and the subsystem ID (in the example screen above: `QA41`).
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.

### On this page

- SYSBPM aufrufen und beenden
- Online-Hilfe
- SYSBPM Hauptmenü - Felder, Funktionen und Kommandos
- SYSBPM in einer z/OS-Parallel-Sysplex-Umgebung