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