Natural für VSAM anpassen

#### Search Results

Search

# Natural für VSAM anpassen

Die Natural-Parameter in einer VSAM-Umgebung werden an einer einzigen Stelle definiert:

- die Natural-Standardparameter, die im Natural-Parametermodul enthalten sind; siehe Generierung eines Natural-Parametermoduls in der Operations-Dokumentation,

- die VSAM-spezifischen Natural-Parameter, die ebenfalls im Natural-Parametermodul enthalten sind; siehe Parametermakro `NTVSAM` in der Parameter-Referenz-Dokumentation.

Das Natural-Parametermodul kann editiert werden, damit es den Standards Ihres Standorts entspricht, und dann mit den entsprechenden Jobs assembliert und verlinkt werden (siehe Installing Natural for VSAM Installation for z/OS-Dokumentation).

In diesem Kapitel werden die folgenden Themen behandelt:

- Anpassung des Natural-Parametermoduls

- Assemblierung des VSAM-spezifischen Natural-Parametermoduls

- Natural-Eingabe-/Ausgabe-Modul für VSAM

## Anpassung des Natural-Parametermoduls

Um Natural in einer VSAM-Umgebung ausführen zu können, müssen Sie den Profilparameter `VSIZE`, das `NTDB`-Makro und das `NTVSAM`-Makro in Ihr Natural-Parametermodul aufnehmen.

Siehe Abschnitt Installing Natural for VSAM in der Installation for z/OS-Dokumentation).

#### Für eine Adabas-Systemdatei:

    VSIZE=72,
    NTDB VSAM,vsam-dbid
    NTVSAM

#### Für eine VSAM-Systemdatei:

    VSIZE=160,

    FNAT=(vsam-dbid,fnr,dd-name),
    FUSER=(vsam-dbid,fnr,dd-name),
    FDIC=(vsam-dbid,fnr,dd-name),
    FSPOOL=(vsam-dbid,fnr,dd-name),
    FSEC=(vsam-dbid,fnr,dd-name)

    NTDB VSAM,vsam-dbid
    NTVSAM ... SFILE=ON,...

`dd-name` ist der logische Name (DD oder DLBL) der Systemdatei; siehe auch Installing Natural for VSAM in der Installation for z/OS-Dokumentation

Anmerkung
Wenn Sie VSAM-Systemdateien mit Natural ISPF verwenden, lesen Sie auch die Natural ISPF-Dokumentation.

Nachfolgend finden Sie Informationen zu:

- Profilparameter VSIZE

- NTDB-Makro

- NTVSAM-Makro

### Profilparameter VSIZE

`VSIZE` ist ein Natural-Profilparameter, der auch dynamisch angegeben werden kann. Er gibt die Größe des Natural-Pufferbereichs für VSAM an und definiert den maximalen Speicherplatzbedarf für die internen Tabellen der Natural-Schnittstelle zu VSAM. Die tatsächliche Größe dieser Tabellen hängt von den im Natural-Parametermodul angegebenen Werten ab (siehe Assemblierung des VSAM-spezifischen Natural-Parametermoduls).

Mögliche Werte `0`, `1` - `32767` KB.

Wenn Sie die im Natural-Parametermodul angegebenen Standardwerte verwenden, muss der Wert des Parameters `VSIZE` mindestens 72 KB betragen

Wenn `VSIZE` auf `0` gesetzt ist, steht Natural for VSAM nicht zur Verfügung und beim Versuch, auf VSAM-Dateien zuzugreifen, wird eine entsprechende Fehlermeldung ausgegeben. Die Deaktivierung von Natural für VSAM führt zu leichten Leistungsverbesserungen, da die Initialisierung, die Verlagerung und der Aus-/Einlagerungsaufwand der Natural-Schnittstelle zu VSAM entfällt.

### NTDB-Makro

Mit dem `NTDB`-Makro werden die Datenbanknummern angegeben, die sich auf VSAM-Dateien beziehen, d.h. die für Natural verfügbaren logischen Zuordnungen.

Die möglichen Werte der Optionen des NTDB-Makros sind in der Natural Parameter-Referenz-Dokumentation beschrieben.

Anmerkung
Vergewissern Sie sich, dass die im `NTDB`-Makro für VSAM ausgewählten Datenbankkennungen (DBIDs) nicht mit DBIDs kollidieren, die für andere Datenbankmanagementsysteme ausgewählt wurden.

### NTVSAM-Makro

Das `NTVSAM`-Makro wird zur Angabe der VSAM-spezifischen Parameter verwendet.

Der Wertebereich der Schlüsselwort-Subparameter des `NTVSAM`-Makros wird in der Natural Parameter-Referenz-Dokumentation beschrieben.

## Assemblierung des VSAM-spezifischen Natural-Parametermoduls

Wenn die im Natural-Parametermodul ausgelieferten Standardwerte Ihren Anforderungen nicht genügen, können Sie die Parameterwerte an Ihre Umgebung anpassen. Die einzelnen VSAM-spezifischen Parameter, die im Natural-Parametermodul enthalten sind, werden im folgenden Abschnitt beschrieben.

Das VSAM-spezifische Natural-Parametermodul wird durch Assemblieren des Makros erstellt:

- `NTVSAM`

und optional eines oder mehrere der folgenden Makros:

- `NTVEXIT`

- `NTVLSR`

- `NTVTVSD`

Wenn mehr als ein Makro angegeben wird, muss das `NTVSAM`-Makro zuerst angegeben werden. Weitere Makros nach dem Makro `NTVSAM` können in beliebiger Reihenfolge angegeben werden.

## Natural-Eingabe-/Ausgabe-Modul für VSAM

Das Natural E/A-Modul für VSAM hängt von der jeweiligen Umgebung ab, in der Sie arbeiten.

Alle verfügbaren E/A-Module werden im Quellcode geliefert, so dass Sie standortspezifische Änderungen vornehmen und umgebungsspezifische Makros und/oder Precompiler verwenden können. Das E/A-Modul muss mit dem Natural-Parameter-Modul verlinkt werden.

Folgende E/A-Module sind verfügbar:

- NVSCICS-Modul

- NVSMISC-Modul

### NVSCICS-Modul

Das `NVSCICS`-Modul ist für CICS unter z/OS erforderlich. Das Modul enthält die folgenden Parameter:

#### &FCTRELI - Indikator für Reliable Remote FCT Entries

Der Parameter `&FCTRELI` zeigt an, ob die Schlüssellänge und Satzgröße einer entfernten Datei im FCT-Eintrag der Application Owning Region (AOR) korrekt definiert sind.

Mögliche Werte:

Wert | Erklärung
--- | ---
`0` | `NVSCICS` gibt Dummy-Kommandos aus, um das Öffnen der Datei in der File Owning Region (FOR) Region zu erzwingen, und wiederholt dann die Abfrage der tatsächlichen Werte. Dies ist die Standardeinstellung.
`1` | `NVSCICS` geht von einem korrekten FCT-Eintrag aus.

Wenn der FCT-Eintrag keine Definition der Schlüssellänge enthält, verwendet `NVSCICS` die Schlüssellänge des entsprechenden VSAM-DDM.

### NVSMISC-Modul

Das `NVSMISC`-Modul ist in allen Umgebungen mit Ausnahme von CICS erforderlich. Das Modul besteht hauptsächlich aus dem `NVMMISC`-Makro, mit dem die `NVSMISC`-E/A-Schnittstelle je nach Betriebssystem und/oder TP-Monitor-Umgebung generiert wird.

`NVSMISC` wird wie folgt angegeben:

name `NVMMISC` `NONRLS=value` `TIMEOUT=value` `DSECTS=value` `DEFER=value` `COMMIT=value` `ERROR=value` `HFACTOR=value` `READINT=value` `SMARTS=value` `TVS=value`

Der Name `name` des verschiebbaren Moduls muss 8 Zeichen lang sein.

Die einzelnen Parameter werden im folgenden Abschnitt beschrieben. Geben Sie diese Parameter entsprechend Ihren Erfordernissen an.

#### NONRLS - Wechsel vom RLS- zum Nicht-RLS-Modus

Wenn Natural for VSAM ein `RLS-OPEN` für eine RLS-Datei ausgibt und diese Datei in dieser z/OS-Sitzung bereits im Nicht-RLS-Modus geöffnet wurde, gibt dieser Parameter an, ob Natural for VSAM einen erneuten Öffnungsversuch in einem Nicht-RLS-Modus ausgibt oder ob ein Öffnungsfehler auftritt.

Mögliche Werte | Standardwert
--- | ---
`YES`/`NO` | `YES`

#### TIMEOUT - Timeout in Sekunden für eine RLS-Anfrage

Dieser Parameter gibt die Zeit in Sekunden an, die Natural for VSAM wartet, um eine Sperre für einen Natural for VSAM-Datensatz zu erhalten, wenn eine Sperre für den Datensatz bereits von einem anderen Benutzer gehalten wird. Weitere Einzelheiten finden Sie in der aktuellen Version des IBM-Handbuchs z/OS DFSMS, Macro Instructions for Data Sets.

Mögliche Werte | Standardwert
--- | ---
`0` - `10` | `0`

#### DEFER - Schreibvorgänge in LSR-Pools aufschieben

Dieser Parameter gilt nur im Batch-Modus und unter TSO.

Dieser Parameter gibt an, ob Schreibvorgänge auf die Platte im LSR-Pool aufgeschoben werden sollen. Wenn dies der Fall ist und der LSR-Pool voll wird, schreibt Natural die 5% des Poolbereichs auf die Platte, die am längsten nicht benutzt wurden.

Mögliche Werte | Standardwert
--- | ---
`YES`/`NO` | `NO`

#### DSECTS - List VSAM System DSECTs

Der Parameter `DSECTS` gibt an, ob die VSAM-System-DSECTs aufgelistet werden sollen oder nicht.

Mögliche Werte | Standardwert
--- | ---
`YES`/`NO` | `NO`

#### COMMIT - Unterstützung von Buffer Flush für LSR Pools

Dieser Parameter gilt nur im Batch-Modus und unter TSO.

Der `COMMIT`-Parameter gibt an, ob bei jedem `END TRANSACTION`-Statement eines Anwenderprogramms alle nicht festgeschriebenen Aktualisierungen in einem beliebigen LSR-Pool auf Platte geschrieben werden sollen.

Mögliche Werte | Standardwert
--- | ---
`YES`/`NO` | NO

Anmerkung
Die Angabe von `COMMIT=YES` bewirkt eine erhebliche Erhöhung der E/A-Rate.

#### ERROR - Initialisierungsfehler ausgeben

Dieser Parameter gibt einen Natural-Initialisierungsfehler aus, wenn eine DD- oder DLBL-Karte in der Laufzeit-JCL ausgelassen wird (siehe auch das Makro `NTVLSR`).

Mögliche Werte | Standardwert
--- | ---
`YES`/`NO` | `YES`

Wenn der Wert `NO` gesetzt ist, wird die Verarbeitung fortgesetzt und Natural for VSAM wird initialisiert.

#### HFACTOR - Faktor für Hiperspace-Puffer

Der Parameter `HFACTOR` gibt einen Faktor für die Erstellung von ESO-Hiperspace-Puffern an. Wenn ein solcher Hiperspace initialisiert wird, kann die entsprechende `BLDVRP`-Anforderung zu einer Natural-Fehlermeldung führen. In diesem Fall muss der Wert von `HFACTOR` verringert werden.

Mögliche Werte | Standardwert
--- | ---
`0` - ein Wert, bei dem eine entsprechende Natural-Fehlermeldung zurückgegeben wird. | `100`

#### READINT - Leseintegrität für Upgrade-Set

Der Parameter `READINT` gibt an, ob die Leseintegrität für ein Upgrade-Set gewährt werden soll oder nicht.

Mögliche Werte | Standardwert
--- | ---
`YES`/`NO` | `NO`

#### SMARTS - Unterstützung von SMARTS und Com-plete

Der Parameter `SMARTS` ist erforderlich, wenn Natural for VSAM unter SMARTS und/oder in einer Com-plete-Umgebung installiert wird.

Mögliche Werte | Standardwert
--- | ---
`YES`/`NO` | `NO`

#### TVS - Unterstützung von DFSMS Transactional VSAM Services (DFSMStvs)

Der Parameter `TVS` gibt die Unterstützung von DFSMStvs in einer z/OS-Umgebung an.

Mögliche Werte | Standardwert
--- | ---
`YES`/`NO` | `NO`

### On this page

- Anpassung des Natural-Parametermoduls
- Assemblierung des VSAM-spezifischen Natural-Parametermoduls
- Natural-Eingabe-/Ausgabe-Modul für VSAM