Natural for Db2 for zIIP auf z/OS installieren

#### Search Results

Search

# Natural for Db2 for zIIP auf z/OS installieren

Dieses Dokument beschreibt zusätzliche Schritte zur Installation von Natural for Db2 for zIIP (Produktcode NDZ) auf z/OS.

- Installationsdatenträger

- Voraussetzungen

- Installationsvorgang

- NDZ-Server-Installationsschritte

- NDZ-Unterstützung zum Natural Batch-Nukleus hinzufügen

#### Verwandte Themen:

Informationen zur Verwendung von Natural for Db2 for zIIP finden Sie unter Natural for Db2 for zIIP in der Datenbankmanagementsystem-Schnittstellen-Dokumentation.

#### Notation vrs oder vr:

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

## Installationsdatenträger

Der Installationsdatenträger enthält die folgenden Datasets, die für die Produktinstallation erforderlich sind:

Dataset-Name | Inhalt
--- | ---
`NDZvrs.LOAD` | Lademodule
`NDZvrs.JOBS` | Beispieljobs für die statische Vorbereitung, das Erstellen von vertrauenswürdigem (trusted) Kontext usw.
`NDZvrs.TAR` | USS-Dateien (tar-Format für die Extraktion nach Unix-Systemdiensten)

Kopieren Sie die Datasets in Ihre Umgebung, wie unter Datasets auf eine z/OS-Platte kopieren im Kapitel Natural auf z/OS installieren beschrieben.

## Voraussetzungen

Bevor Sie Natural for Db2 for zIIP installieren können, muss bereits eine vollständige und funktionierende Installation des standardmäßig installierten Natural for Db2 (Produktcode NDB) in der Mainframe-Umgebung vorliegen, siehe Natural for Db2 auf z/OS installieren

Teile von Natural for Db2 for zIIP werden in der Unix Systems Services-Umgebung (USS) installiert, und bei USS muss die folgende Konfiguration und Software bereits installiert sein:

IBM Java 64-bit Dies ist ein Beispiel dafür, wie Sie die Java-Installation und -Version überprüfen können (Ihre Java-Version kann eine andere sein). |
    $ <JAVA_PATH>/bin/java â€“version

    java 17.0.7 2023-04-18
    IBM Semeru Runtime Certified Edition for z/OS 17.0.7.0 (build 17.0.7+7)
    IBM J9 VM 17.0.7.0 (build z/OS-Release-17.0.7.0-b01, JRE 17 z/OS
    s390x-64-Bit Compressed References 20230809_41 (JIT enabled, AOT enabled)
    OpenJ9   - bc2691d03c1
    OMR      - 49ecb822254
    IBM      - fae32e3
    JCL      - 8e3170b6410 based on jdk-17.0.7+7)
Db2 JDBC Driver Dies ist ein Beispiel dafür, wie Sie die Java-Installation und -Version überprüfen können (Ihre Java-Version kann eine andere sein). |
    $ <JAVA_PATH>/bin/java -cp <DB2_PATH>/jdbc/classes/db2jcc.jar
    com.ibm.db2.jcc.DB2Jcc  -version

    IBM DB2 JDBC Universal Driver Architecture 3.72.54
NDZ Installation Directory Es muss bereits ein Installationsverzeichnis für den NDZ erstellt worden sein. |
    $ pwd
    /DAXY/u/nat/ndzuser
    $ mkdir ndz923

Darüber hinaus muss auf z/OS Folgendes konfiguriert werden:

- Die NDZ-Ladebibliothek muss in die APF-Autorisierungsliste aufgenommen werden.

- RACF-Benutzer (in den folgenden Beispielen `ndzuser` genannt) mit:

  - Ein gestartetes RACF-Profil, das für die gestartete(n) NDZ-Task(s) definiert ist.

  - Eine Berechtigung für das RACF-Facility-Profil `ERBSDS.MON3DATA`.

  - Eine Berechtigung für das RACF-Facility-Profil `BPX.WLMSERVER`.

  - Schreibberechtigung für das NDZ-Installationsverzeichnis.

- Für den Zugriff auf Db2 über TCP/IP muss ein Db2-Benutzer (in den folgenden Beispielen `db2user` genannt) angelegt werden. Anstelle von `db2user` kann auch `ndzuser` verwendet werden.

## 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 folgenden Schritte:

- NDZ-Server-Installationsschritte

- Installationschritte für Batch-Modus

## NDZ-Server-Installationsschritte

Dieser Abschnitt beschreibt die Installationsschritte, die für alle Natural-Umgebungen gelten, in denen Natural for Db2 for zIIP installiert werden kann.

- Schritt 1: Lizenzschlüssel vorbereiten

- Schritt 2: Trusted Context erstellen

- Schritt 3: NDZ-Installations-TAR-Datei kopieren und extrahieren

- Schritt 4: Die db2.properties-Datei generieren

- Schritt 5: Die db2.properties-Datei generieren

- Schritt 6: Shell-Skript setenv.sh für die statische Vorbereitung aktualisieren

- Schritt 7: Db2-Passwort verschlüsseln (optionaler Schritt)

- Schritt 8: NDZ-Nukleus verlinken

- Schritt 9: Prozedur(en) für gestartete NDZ-Tasks erstellen

### Schritt 1: Lizenzschlüssel vorbereiten

Kopieren Sie die Lizenzdatei von dem mitgelieferten Installationsdatenträger auf die Platte. Wenn die Lizenzdatei auf dem PC als `.xml`-Datei geliefert wird, weisen Sie einen Dataset namens `NDZvrs.LICS` mit den folgenden Attributen zu:

    ORGANIZATION   :  PS
    RECORD FORMAT  :  FB
    RECORD LENGTH  :  80
    BLOCK SIZE     :  27920
    ALLOCATION TYPE:  TRK
    1ST EXTENT     :  0       CYL 1   TRK

Benutzen Sie dann FTP im binären Übertragungsmodus, um die `.xml`-Datei vom PC in den Dataset zu übertragen.

### Schritt 2: Trusted Context erstellen

(Job I010 Step 9610)

Erstellen Sie das Trusted Context-Objekt in einem Db2-Server und verwenden Sie den Db2-Benutzer, um eine vertrauenswürdige Verbindung (trusted connection) herzustellen.

- Ersetzen Sie die Variable `UID` durch `db2user`. Zum Beispiel:

      BASED UPON CONNECTION USING SYSTEM AUTHID db2user

- Übergeben Sie den Job.

### Schritt 3: NDZ-Installations-TAR-Datei kopieren und extrahieren

(Job I020 Step 9610 + 9615 + 9620)

- Step 9610 (Alte .tar- und Java jar-Dateien in USS löschen, falls vorhanden)

- Step 9615 (Die `.tar`-Datei in den USS kopieren)

- Step 9620 (Die `.tar`-Datei im USS entpacken)

- Bearbeiten Sie `NDZvrs.MVSJOBS(NDZI020)` und ersetzen Sie alle Vorkommen von `/U/SAG/NAT/NDZ` mit Ihrem tatsächlichen Installationsverzeichnis.

- Übergeben Sie den Job.

### Schritt 4: Die db2.properties-Datei generieren

(Job I022 Step 9615)

Erstellen Sie die db2.properties-Datei im NDZ-Konfigurationsverzeichnis (`<NDZ installation directory>/etc/db2.properties`) mit den spezifischen Db2-Verbindungs- und Konfigurationseigenschaften.

#### Oder:

1. Erstellen Sie die Datei `<NDZ installation directory>/etc/db2.properties` anhand der Beispieldatei `<NDZ installation directory>/etc/db2.properties.sample`.

2. Setzen Sie die Variablen entsprechend den Anweisungen in der Beispieldatei.

Weitere Informationen finden Sie in der Datenbankmanagementsystem-Schnittstellen-Dokumentation unter Natural for Db2 for zIIP im Kapitel Konfiguration und Parameter für NDZ im Abschnitt Parameter für NDZ.

### Schritt 5: Die db2.properties-Datei generieren

(Job I022 Step 9620)

Erstellen Sie die db2.properties-Datei im NDZ-Konfigurationsverzeichnis (`<NDZ installation directory>/etc/ndz.properties`) mit den Parametern für den NDZ-Server.

#### Oder:

1. Erstellen Sie die db2.properties-Datei `<NDZ installation directory>/etc/ndz.properties` anhand der Beispieldatei `<NDZ installation directory>/etc/ndz.properties.sample`.

2. Setzen Sie die Variablen gemäß den Anweisungen in der Beispieldatei.

Weitere Informationen finden Sie in der Datenbankmanagementsystem-Schnittstellen-Dokumentation unter Natural for Db2 for zIIP im Kapitel Konfiguration und Parameter für NDZ im Abschnitt Parameter für NDZ.

### Schritt 6: Shell-Skript setenv.sh für die statische Vorbereitung aktualisieren

(Job I022 Step 9625)

Aktualisieren Sie das Shell-Skript, das für das Setzen der Db2-, Java- und NDZ-Startpfadvariablen (`<NDZ installation directory>/bin/setenv.sh`) für den NDZ-Server verantwortlich ist.

#### Oder:

Erstellen Sie die Datei `<NDZ installation directory>/bin/setenv.sh` anhand der Beispieldatei `<NDZ installation directory>/bin/setenv.sh.sample` Aktualisieren Sie die Db2-, Java- und NDZ-Startpfadvariablen in der Datei `setenv.sh`.

Weitere Informationen finden Sie in der Datenbankmanagementsystem-Schnittstellen-Dokumentation unter Natural for Db2 for zIIP im Kapitel Konfiguration und Parameter für NDZ im Abschnitt Parameter für NDZ.

### Schritt 7: Db2-Passwort verschlüsseln (optionaler Schritt)

Sie können Ihr Db2- Verbindungspasswort mit der Db2-Passwortverschlüsselung sichern. Dieser Schritt ist optional, wird aber dringend empfohlen. Die Anweisungen sind in der Datenbankmanagementsystem-Schnittstellen-Dokumentation unter Natural for Db2 for zIIP im Kapitel Konfiguration und Parameter für NDZ im Abschnitt Db2-Passwortverschlüsselung beschrieben.

Wenn Sie das Dienstprogramm für verschlüsselte Db2-Passwörter verwenden, können Sie den Passwort-Parameter aus der Datei db2.properties löschen, da dieser Parameter ignoriert wird.

### Schritt 8: NDZ-Nukleus verlinken

(Job I058 Step 9610)

Verlinken Sie den NDZ-Nukleus mit `NDZvrs.LOAD`(`NDZNUC`), `MLCvrs.LOAD`(`LICMAIN`) und `MLCvrs.LOAD`(`LICCHECK`).

### Schritt 9: Prozedur(en) für gestartete NDZ-Tasks erstellen

(Job I200 Step 9610)

Erstellen Sie die Prozedur(en) für die vom NDZ gestarteten Tasks (oder Daemons) unter Verwendung der folgenden Vorlage:

    //NAME   PROC
    //*
    //NDZ11    EXEC  PGM=NDZNUC11,REGION=0M,TIME=NOLIMIT,
    //  PARM=('PATH=<NDZ INSTALLATION DIRECTORY>')
    //*--------------------------------------------------------------------*
    //LICNDZBT DD DISP=SHR,DSN=<LICENSE DATASET>
    //STEPLIB  DD DISP=SHR,DSN=<LOAD DATASET>
    //SYSPRINT DD SYSOUT=X
    //SYSOUT   DD SYSOUT=X
    //SYSUDUMP DD SYSOUT=X
    //STDOUT   DD SYSOUT=X
    //STDERR   DD SYSOUT=X

- Ersetzen Sie die hervorgehobenen Teile gemäß den folgenden Anweisungen:

  - `NAME` - Der Name der gestarteten Task.

  - `NDZ INSTALLATION PATH` - Der Pfad zum NDZ-Home-Verzeichnis.

  - `LICENSE DATASET` - Der Dataset, der die Lizenzdatei enthält.

  - `LOAD DATASET` Der autorisierte APF-Dataset, in dem sich der NDZ-Nukleus befindet.

- Übergeben Sie den Job.

## NDZ-Unterstützung zum Natural Batch-Nukleus hinzufügen

(Job I060 Step 9625)

1. Verlinken Sie den Batch-Nukleus mit der NDZ-Unterstützung.

2. Fügen Sie die folgenden `INCLUDE`-Anweisungen und die entsprechenden `DD`-Anweisungen zu den Verlinkungsanweisungen für den Linkage-Editor hinzu. Geben Sie dasselbe Db2-Schnittstellenmodul an, das bei der NDB-Installation verwendet wurde, siehe Natural for Db2 auf z/OS installieren

   `INCLUDE NDBLIB(NDBNDZ)` | NDB-Unterstützung für NDZ
   `CHANGE DSNHLI(DB2HLI)` | Db2 Interface-Modul
   `INCLUDE DB2LIB(DSNALI)` Oder: `INCLUDE DB2LIB(DSNELI)` | Db2 Interface-Modul (CAF) Oder: Db2 Interface-Modul (TSO)

### On this page

- Installationsdatenträger
- Voraussetzungen
- Installationsvorgang
- NDZ-Server-Installationsschritte
- NDZ-Unterstützung zum Natural Batch-Nukleus hinzufügen