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 Building a Natural Parameter Module 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

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- bzw. Installation for z/VSE-Dokumentation

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

Nachfolgend finden Sie Informationen zu:

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:

und optional eines oder mehrere der folgenden Makros:

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

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

" bzw. z/VSE" entfällt ab NAT921.

&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.

Der Standardname ist NVSMISCD (nur bei z/VSE).

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

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

Nur bei NAT828/912: Dieser Parameter wird unter z/VSE ignoriert.

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 im IBM-Handbuch z/OS DFSMS Version 1.6 oder höher, 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