Message Buffer Pool verwenden

#### Search Results

Search

# Message Buffer Pool verwenden

Dieser Teil beschreibt die Verwendung des Message Buffer Pool, der unter z/OS verwendet werden kann.

Die folgenden Themen werden behandelt:

- Zweck

- Voraussetzungen

- Betrieb des Message Buffer Pool

- Beispiele für NATMBPvr-Ausführungsjobs

- Message Buffer Pool-Betriebsfunktionen

- Funktionsparameter

- Meldungen

Siehe auch folgende Themen in der SYSBPM Utility-Dokumentation:

- Message Pool auswählen

- Message Pool-Statistiken anzeigen

Anmerkung
In der SYSBPM Utility wird der Message Buffer Pool häufig auch verkürzt als Message Pool bezeichnet.

## Zweck

Der Message Buffer Pool ist ein Cache-Speicher, in dem die Natural-Systemmeldungen und die Benutzertexte gespeichert werden.

Bevor eine Fehlermeldung ausgegeben wird, prüft Natural zunächst, ob der entsprechende Meldungstext im Message Buffer Pool vorhanden ist. Wenn ja, wird dieser Text ausgegeben. Andernfalls wird die Fehlermeldung aus der Datenbank gelesen und im Message Buffer Pool gespeichert.

Der Message Buffer Pool ist nur als globaler Buffer Pool verfügbar. Seine Verwendung ist optional und wird durch den Natural-Profilparameter `BPI` oder das entsprechende Makro `NTBPI` gesteuert.

Wenn ein Message Buffer Pool verwendet wird, wird er in einem Datenbereich zugeordnet.

## Voraussetzungen

Die folgenden Voraussetzungen müssen erfüllt sein, wenn Sie den Message Buffer Pool verwenden wollen:

1. Das Modul `NATMBPvr` muss in eine APF-Bibliothek (Authorized Program Facility) verlinkt worden sein. Siehe den entsprechenden Schritt in Installing Natural on z/OS in der Installation for z/OS-Dokumentation.

2. Der Message Buffer Pool muss angelegt und gestartet worden sein. Siehe den entsprechenden Schritt in Installing Natural on z/OS in der Installation for z/OS-Dokumentation.

3. Der Schlüsselwort-Subparameter `TYPE` des Profilparameters `BPI` oder des Makros `NTBPI` muss auf `MSG` gesetzt sein.

## Betrieb des Message Buffer Pool

Der Message Buffer Pool wird unter Verwendung des Programms `NATMBPvr` betrieben, das in einer APF-Bibliothek (Authorized Program Facility) ausgeführt werden muss.

Die folgenden Themen werden behandelt:

- Message Buffer Pool einrichten

- Message Buffer Pool-Betriebsprogramm starten

- Message Buffer Pool-Betriebsprogramm stoppen

Anmerkung
In diesem Dokument steht die Schreibweise vrs oder vr für die jeweilige Produktversion (siehe auch Version im Glossar).

### Message Buffer Pool einrichten

Die von `NATMBPvr` zur Verfügung gestellten Funktionen (siehe auch Funktionsparameter) werden dadurch aktiviert, dass sie

- durch eine Parameterkarte (`PARM=`) geliefert werden,

- aus einer Datei gelesen werden (siehe unten),

- oder durch das Operator-Kommando `MODIFY` geliefert werden, wenn `NATMBPvr` noch nicht beendet wurde.

`NATMBPvr` erwartet das erste Kommando im Parameterfeld (`PARM=`) des `EXEC`-Statements.

Sie können Folgendes eingeben:

- eine der im Abschnitt Message Buffer Pool-Betriebsfunktionen beschriebenen Funktionen,

- oder einen Verweis auf eine Eingabedatei mit `CF=<dd-name>`, wobei `<dd-name>` für einen in der JCL definierten DD-Namen steht.

  Es werden nur Card Image-Dateien unterstützt, d.h. `RECFM=F,LRECL=80`, und nur die ersten 72 Bytes des Eingabedatensatzes werden berücksichtigt.

  Jeder in der Eingabedatei enthaltene Satz stellt ein Kommando dar.

  Leere Sätze oder Sätze mit einem vorangestellten Stern (`*`) werden ignoriert.

  Eine Datei wird bis zum End-Of-File (EOF) verarbeitet.

  Beispiel: `PARM='CF=SYSIN1'`

Wenn das Parameterfeld nicht angegeben oder leer ist, werden die Kommandos standardmäßig aus der Datei `SYSIN` gelesen.

Es ist nur möglich, jeweils eine Funktion an der Konsole oder eine Funktion pro Zeile über die Kommandodatei einzugeben, andernfalls wird eine Fehlermeldung zurückgegeben.

Jedes Kommando, das von der Parameterkarte, per Dateieingabe oder per Eingabe über die Bedienerkonsole empfangen wird, wird auf der Bedienerkonsole angezeigt.

### Message Buffer Pool-Betriebsprogramm starten

Um das Programm `NATMBPvr` zu starten, können Sie entweder eine Started Task starten oder einen Job übergeben, der `NATMBPvr` ausführt.

### Message Buffer Pool-Betriebsprogramm stoppen

Das Programm `NATMBPvr` wird mit der Funktion `TERMINATE` (siehe Message Buffer Pool-Betriebsfunktionen) oder im Notfall mit dem Betriebsprogramm `CANCEL` beendet.

## Beispiele für NATMBPvr-Ausführungsjobs

Die folgenden Beispiele zeigen Beispiele für Batch-Jobs zur Erstellung und Beendigung eines globalen Pufferpools.

- Beispiel 1

- Beispiel 2

- Beispiel 3

Anmerkung
In den folgenden Beispielen steht die Schreibweise vrs oder vr für die jeweilige Produktversion (siehe auch Version im Glossar).

### Beispiel 1

    //MBPSTART JOB
    //*
    //* Starts a message buffer pool with the name NATvrMBP and
    //* a size of 10 MB.
    //* The subsystem used is NATv.
    //*
    //STEP EXEC PGM=NATMBPvr,PARM='BP=NATvrMBP,SI=10'
    //SETPLIB DD DISP=SHR,DSN=USER.APF.LINKLIB

### Beispiel 2

    //MBPRES JOB
    //*
    //* Starts a message buffer pool with the name MBP and a default size of
    //* 100 MB. The subsystem used is SAGS.
    //*
    //STEP EXEC PGM=NATMBPvr,PARM='BP=MBP,S=SAGS'

### Beispiel 3

    //MBPSTRT2
    //* Read commands from SYSIN1:
    //*
    //* Start 2 message buffer pools (subsystem ID Nvrs) with name
    //*   NATMBP1 - size=1000MB
    //*   NATMBP2 - size=2000MB
    //* If the buffer pools should shut down, send operator command MODIFY with
    //* parameter "CF=SYSIN2" to execute the corresponding FSHUTs.
    //*
    //STEP EXEC PGM=NATMBPvr,PARM='CF=SYSIN1'
    //SYSIN1  DD *
    CREATE,BP=NATMBP1,S=Nvrs,SI=1000M
    CREATE,BP=NATMBP2,S=Nvrs,SI=2000M
    SHOWBP S=Nvrs
    //SYSIN2 DD *
    FSHUT,BP=NATMBP1,S=Nvrs
    FSHUT,BP=NATMBP2,S=Nvrs
    //*

## Message Buffer Pool-Betriebsfunktionen

Die folgenden Funktionen sind verfügbar:

- HELP - Zeigt eine Übersicht über die verfügbare Syntax

- CREATE - Message Buffer Pool anlegen

- FSHUT - Message Buffer Pool außer Betrieb setzen

- TERMINATE oder STOP- Message Buffer Pool-Betriebsprogramm beenden

- ZAPS - Anzeige der auf den Message Buffer Pool angewendeten Zaps

Anmerkung
Die Funktionsnamen können abgekürzt werden. Es genügt, wenn Sie nur das erste Zeichen verwenden, z.B. `T` für `TERMINATE`.

### HELP - Zeigt eine Übersicht über die verfügbare Syntax

Diese Funktion gibt eine Liste der verfügbaren Syntax-Kommandos und ggf. die Standardwerte der Funktionsparameter aus.

### CREATE - Message Buffer Pool anlegen

Mit dieser Funktion wird ein Message Buffer Pool mit den angegebenen Parametern angelegt.

### FSHUT - Message Buffer Pool außer Betrieb setzen

Der Message Buffer Pool mit den angegebenen Parametern wird freigegeben.

### TERMINATE oder STOP- Message Buffer Pool-Betriebsprogramm beenden

Das Betriebsprogramm des Message Buffer Pool wird beendet. Zuvor werden alle aktiven Message Buffer Pools freigegeben.

### ZAPS - Anzeige der auf den Message Buffer Pool angewendeten Zaps

Zeigt alle auf das Message Buffer Pool-Betriebsprogramm angewendeten Zaps an.

## Funktionsparameter

Die Funktionen des Betriebsprogramms des Message Buffer Pool können mit Hilfe von Parametern gesteuert werden. Diese Parameter können in beliebiger Reihenfolge angegeben und dürfen abgekürzt werden.

Die folgenden Parameter sind verfügbar:

`BPNAME` | Name des Message Buffer Pool.
`BPLIST` | Name der Preload-Liste (optional).
`SUBSID` | Natural-Subsystemkennung (ID).
`SIZE` | Größe des Message Buffer Pool.

Anmerkung
Der unterstrichene Teil des Parameternamens markiert die kürzest mögliche Abkürzung.

### BPNAME - Name des Message Buffer Pool

`BPNAME=value` gibt den Namen des anzulegenden Message Buffer Pool an.

Wert | Erläuterung
--- | ---
8 Bytes | Der Name des Message Buffer Pool. Anmerkung Wenn der angegebene Name kürzer als 8 Byte ist, werden Leerzeichen angehängt.
`MTBP` | Dies ist der Standardwert.

### BPLIST - Name der Preload-Liste (optional)

`BPLIST=value` gibt den Namen der optionalen Preload-Liste an.

Wert | Erläuterung
--- | ---
8 Bytes | Der Name der Preload-Liste. Anmerkung Wenn der angegebene Name kürzer als 8 Byte ist, werden Leerzeichen angehängt. Es gibt keinen Standardwert.

### SUBSID - Natural-Subsystemkennung

`SUBSID=value` gibt die Kennung (ID) des Natural-Subsystems an.

Wert | Erläuterung
--- | ---
4 Bytes | Die Kennung des Natural-Subsystems. Anmerkung Wenn der angegebene Name kürzer als 8 Byte ist, werden Leerzeichen angehängt.
`NATv` | Dies ist der Standardwert, wobei `v` die erste Ziffer der aktuellen Natural-Version ist.

### SIZE - Größe des Message Buffer Pool

`SIZE=value` gibt die Größe des Message Buffer Pool an.

Wert | Erläuterung
--- | ---
1 - 2000 MB | Die Größe des Message Buffer Pool.
`1` | Dies ist der Standardwert.

Anmerkung
Ein Message Buffer Pool der Größe 1 MB kann bis zu 7000 Fehlermeldungen aufnehmen.

## Meldungen

Siehe Message Buffer Pool Messages in der Messages and Codes-Dokumentation.

### On this page

- Zweck
- Voraussetzungen
- Betrieb des Message Buffer Pool
- Beispiele für NATMBPvr-Ausführungsjobs
- Message Buffer Pool-Betriebsfunktionen
- Funktionsparameter
- Meldungen