Natural for VSAM auf Adabas-Systemdateien auf z/OS installieren

#### Search Results

Search

# Natural for VSAM auf Adabas-Systemdateien auf z/OS installieren

Dieses Dokument beschreibt die Schritte zur Installation von Natural for VSAM auf einer Adabas-Datenbank unter z/OS.

- Installationsdatenträger

- Installationsvorgang

- Installation überprüfen

## Installationsdatenträger

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.

## Installationsvorgang

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.

- Schritt 1: CICS-RDO-Definitionen definieren

- Schritt 2: Employees-Beispieldaten laden

- Schritt 3: Natural for VSAM I/O-Modul erstellen

- Schritt 4: Natural-Parametermodul für VSAM erstellen

- Schritt 5: Nukleus verlinken

- Schritt 6: Natural-Beispielobjekte laden

- Schritt 7: Ihren TP-Monitor anpassen

### Schritt 1: CICS-RDO-Definitionen definieren

(Job I005)

- Definieren Sie die CICS-RDO-Definitionen für die VSAM-Beispieldateien.

### Schritt 2: Employees-Beispieldaten laden

(Job I008, Steps 1403 - 1407)

1. Definieren Sie den VSAM-Cluster und die Dateien, die die Beispieldatei `EMPLOYEES` (Beispieldaten einer Mitarbeiterverwaltung) enthalten sollen.

2. Laden Sie den Dataset `NVSvrs.EMPL` in die erste dieser Dateien (Suffix `.EMPL`).

3. Erstellen Sie einen sekundären Index davon in der zweiten Datei (Suffix `.EMPLX`) und definieren Sie den Pfad dafür.

### Schritt 3: Natural for VSAM I/O-Modul erstellen

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

### Schritt 4: Natural-Parametermodul für VSAM erstellen

(Jobs I060, I080)

Erstellen Sie das Natural-Parametermodul:

1. Ä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).

2. Assemblieren und verlinken Sie das Natural-Parametermodul.

### Schritt 5: Nukleus verlinken

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

### Schritt 6: Natural-Beispielobjekte laden

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

### Schritt 7: Ihren TP-Monitor anpassen

- 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 `NTVSAM` `PATH=CHECK` angegeben haben: Katalogisieren Sie Ihr Frontprogramm mit der `CA`-Funktion des Com-plete-Dienstprogramms ULIB mit einer Regionsgröße von 40 KB nach Com-plete, wenn Sie den ersten Standardwert des Parameters `WPSIZE` im Natural-Parametermodul nicht geändert haben. Laden Sie die IBM-Routine `IGG0CLA0` entweder im LPA oder als residentes Programm mit dem Com-plete-Dienstprogramm UCTRL.
  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

## Installation überprüfen

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.

#### Hinweis für den Batch-Modus:

Zur Überprüfung im Batch-Modus können Sie den Job I200 ausführen, der die oben genannten Programme ausführt.

### On this page

- Installationsdatenträger
- Installationsvorgang
- Installation überprüfen