Dieses Dokument beschreibt die Schritte zur Installation von Natural for VSAM auf einer Adabas-Datenbank unter z/OS.
Der Installationsdatenträger enthält die folgenden Datasets, die für die Produktinstallation erforderlich sind:
| Dataset-Name | Inhalt |
|---|---|
NVSvrs.LOAD |
Lademodule |
NVSvrs.SRCE |
Quellcodemodule und Makros |
NVSvrs.JOBS |
Beispiel-Installationsjobs |
NVSvrs.EMPL |
Employees-Beispieldaten |
NVSvrs.EXPL |
Natural-Beispielobjekte |
Kopieren Sie die Datasets in Ihre Umgebung, wie unter Datasets auf eine z/OS-Platte kopieren im Kapitel Natural auf z/OS installieren beschrieben.
Bevor Sie mit der Installation beginnen, sollten Sie unbedingt die Abschnitte im Kapitel Installationsverfahren und wichtige Natural-Funktionen unter z/OS lesen.
Der Installationsvorgang umfasst die nachfolgend beschriebenen Schritte.
(Job I005)
Definieren Sie die CICS-RDO-Definitionen für die VSAM-Beispieldateien.
(Job I008, Steps 1403 - 1407)
Definieren Sie den VSAM-Cluster und die Dateien, die die Beispieldatei
EMPLOYEES (Beispieldaten einer Mitarbeiterverwaltung) enthalten
sollen.
Laden Sie den Dataset NVSvrs.EMPL in die
erste dieser Dateien (Suffix .EMPL).
Erstellen Sie einen sekundären Index davon in der zweiten Datei (Suffix
.EMPLX) und definieren Sie den Pfad dafür.
Assemblieren und verlinken Sie das Natural for VSAM-I/O-Modul:
Unter Com-plete:
(Job I055, Steps 1410, 1411, 1415, 1416)
Assemblieren Sie das I/O-Modul NVSMISC mit dem Parameter
SMARTS=YES (Steps 1415 und 1416). Ausführliche Informationen
siehe NVSMISC Modul und SMARTS in der
Datenbankmanagementsystem-Schnittstellen-Dokumentation.
Unter CICS:
(Job I070, Step 1400)
Verwenden Sie das I/O-Modul NVSCICS. Siehe NVSCICS
Modul in der
Datenbankmanagementsystem-Schnittstellen.
Anmerkung
Wenn Sie nicht die neueste CICS-Version verwenden, kann der
Precompile-Schritt zu einem Returncode ungleich Null führen (4 - 16, je nach
CICS-Version), weil CICS- Kommandos verwendet werden, die Ihrem CICS Translator
unbekannt sind. Dieser Rückgabewert kann ignoriert werden, solange der
nachfolgende Assemblierungsschritt mit einem Rückgabewert von 0 endet.
In einer anderen Umgebung:
Verwenden Sie das E/A-Modul NVSMISC. Siehe NVSMISC
Modul in der
Datenbankmanagementsystem-Schnittstellen-Dokumentation.
(Jobs I060, I080)
Erstellen Sie das Natural-Parametermodul:
Ändern Sie die entsprechenden Jobs entsprechend den Batch-Modulen oder TP-Monitoren, die Sie neu verlinken: Job I060 für Batch, Job I080 für Com-plete und Job I080 für CICS. Dies gilt auch für den Installationsschritt Nukleus verlinken.
Fügen Sie die folgenden Parameter- und Makroaufrufe in Ihr Natural-Parametermodul ein:
VSIZE=72 NTDB VSAM, vsam-dbid NTVSAM
Die Werte für VSIZE hängen von den im Makro
NTVSAM angegebenen Werten ab (siehe auch den Profilparameter VSIZE in der
Datenbankmanagementsystem-Schnittstellen-Dokumentation).
Assemblieren und verlinken Sie das Natural-Parametermodul.
(Jobs I060, I080)
Ändern Sie die JCL, die zum Linken Ihres umgebungsunabhängigen Nukleus
verwendet wird, indem Sie die folgende INCLUDE-Anweisung
hinzufügen:
INCLUDE NVSLIB(NVSNUC)
Ändern Sie die JCL, mit der Sie Ihren umgebungsabhängigen Nukleus für das Natural CICS Interface verlinken,
indem Sie die folgende INCLUDE-Anweisung hinzufügen:
INCLUDE SMALIB(NVSCICS)
Ändern Sie die JCL, mit der Sie Ihren umgebungsabhängigen Nukleus für andere
Natural-TP-Monitor-Schnittstellen als die Natural-CICS-Schnittstelle verlinken,
indem Sie die folgende INCLUDE-Anweisung hinzufügen:
INCLUDE SMALIB(NVSMISC)
Ändern Sie die JCL, die zur Verlinkung Ihres umgebungsabhängigen Nukleus für
Natural-TP-Monitorschnittstellen außer der Natural-CICS-Schnittstelle verwendet
wird, wenn RLS=CHECK im Makro NTVSAM des
VSAM-spezifischen Natural-Parametermoduls angegeben ist, indem Sie die folgende
INCLUDE-Anweisung hinzufügen:
INCLUDE CSSLIB(IGWARLS)
Die Routine IGWARLS ist ein aufrufbarer Dienst zur Unterstützung der
RLS-Verarbeitung. Sie befindet sich in der Systembibliothek
SYS1.CSSLIB. Fügen Sie die entsprechenden DD-Anweisungen
in den Link-Schritt für Natural ein.
Informationen zu den Komponenten und der Struktur von Natural for VSAM finden Sie auch unter Bestandteile von Natural für VSAM und Struktur der Natural-Schnittstelle zu VSAM in der Datenbankmanagementsystem-Schnittstellen-Dokumentation.
(Job I061, Step 1400)
Laden Sie mit dem Dienstprogramm Natural INPL die für Natural for VSAM spezifischen
Natural-Beispielobjekte aus dem Dataset NVSvrs.EXPL in die
Natural-Systemdatei.
Passen Sie Ihre TP-Monitor-Umgebung an:
| TP-Monitor | Anleitung |
|---|---|
| Com-plete | Katalogisieren Sie alle VSAM-Dateien mit der Funktion
CA des Com-plete-UFILE-Dienstprogramms nach Com-plete
(Beschreibung siehe Com-plete-Dokumentation).
Wenn
Sie in
|
| CICS | Fügen Sie die Einträge für die VSAM-spezifischen Beispieldateien
EMPLVS und EMPLVX zu Ihrer RDO-Definition hinzu,
wie in Installationsschritt CICS-RDO-Definitionen definieren
beschrieben. Sie finden die CICS-Tabellen im Dataset
NVSvrs.JOBS als NVSI005.
|
| TSO | Fügen Sie die folgenden Anweisungen in die zum Starten von Natural
verwendet CLIST ein:
ALLOCATE F(EMPLVS) DATASET('SAGLIB.VSAM.EMPL') SHR
ALLOCATE F(EMPLVX) DATASET('SAGLIB.VSAM.EMPLX.PATH') SHR
|
Sie können die erfolgreiche Installation von Natural for VSAM wie folgt überprüfen:
Melden Sie sich bei der Natural-Systembibliothek SYSEXNVS an und führen
Sie die folgenden Programme aus:
NVSINST1
NVSINST2
NVSINST3
NVSINST4
NVSINST5
NVSINST6
Wenn diese Programme alle erfolgreich ausgeführt werden können, ist die Installation von Natural for VSAM abgeschlossen und verifiziert.
Zur Überprüfung im Batch-Modus können Sie den Job I200 ausführen, der die oben genannten Programme ausführt.
