Dieses Dokument beschreibt zusätzliche Schritte zur Installation von Natural for Db2 for zIIP (Produktcode NDZ) auf z/OS.
Informationen zur Verwendung von Natural for Db2 for zIIP finden Sie unter Natural for Db2 for zIIP in der Datenbankmanagementsystem-Schnittstellen-Dokumentation.
In diesem Dokument steht die Notation
vrs oder
vr für die jeweilige Produktversion
(siehe auch Version
im Glossar).
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.
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.
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:
Dieser Abschnitt beschreibt die Installationsschritte, die für alle Natural-Umgebungen gelten, in denen Natural for Db2 for zIIP installiert werden kann.
Schritt 3: NDZ-Installations-TAR-Datei kopieren und extrahieren
Schritt 6: Shell-Skript setenv.sh für die statische Vorbereitung aktualisieren
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.
(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.
(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.
(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.
Erstellen Sie die Datei <NDZ
installation directory>/etc/db2.properties anhand der
Beispieldatei <NDZ installation
directory>/etc/db2.properties.sample.
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.
(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.
Erstellen Sie die db2.properties-Datei
<NDZ installation
directory>/etc/ndz.properties anhand der Beispieldatei
<NDZ installation
directory>/etc/ndz.properties.sample.
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.
(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.
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.
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.
(Job I058 Step 9610)
Verlinken Sie den NDZ-Nukleus mit
NDZvrs.LOAD(NDZNUC),
MLCvrs.LOAD(LICMAIN)
und
MLCvrs.LOAD(LICCHECK).
(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.
(Job I060 Step 9625)
Verlinken Sie den Batch-Nukleus mit der NDZ-Unterstützung.
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) |