Im Folgenden finden Sie die Komponenten, mit denen Sie den NDZ nach Ihren Vorgaben konfigurieren können.
Die NDZ Started Task optimiert die Db2-Anfragen und führt sie per Fernzugriff über JDBC- und SQLJ-Treiber aus. Weitere Informationen und ein Jobbeispiel für die Erstellung einer NDZ Started Task finden Sie in der NDZ-Installation, siehe Installing Natural for Db2 for zIIP. Ausführliche Informationen zu den Parametern der NDZ-Server Started Task finden Sie im Abschnitt NDZ Started Task-Prozedur.
Um den NDZ zu konfigurieren, geben Sie NDZ-Parameter in der Datei ndz.properties im Verzeichnis /etc an. Diese Parameter steuern die Eigenschaften der vom NDZ gestarteten Task und die clientbezogenen Konfigurationen des NDZ. Ausführliche Informationen über die NDZ-Parameter finden Sie im Abschnitt NDZ-Konfigurationsdatei (ndz.properties).
Das Skript <NDZ-directory>/bin/setenv.sh wird in anderen Skripten und Batch-Jobs
zur statischen Vorbereitung verwendet, um die erforderlichen Umgebungsvariablen zu
setzen. NDZ erstellt die Umgebungsvariablen, z.B.
CLASS_PATH und LIB_PATH. auf
der Grundlage der von Ihnen übergebenen Parameter. Ausführliche Informationen zu den
Parametern, die im Skript setenv.sh angegeben werden müssen, finden Sie im Abschnitt
NDZ-Konfigurationsdatei (ndz.properties).
Natural for Db2 for zIIP benötigt Db2-bezogene Informationen, um eine Verbindung zu Db2 herzustellen und die Eigenschaften von Db2-, JDBC- und SQLJ-Treibern zu ändern. Sie können diese Parameter in db2.properties hinzufügen. Weitere Informationen zu den Parametern, die für die Db2-Konfiguration erforderlich sind, finden Sie im Abschnitt Db2-Konfigurationsdatei (db2.properties). Neben den in diesem Abschnitt genannten Parametern können Sie in der Db2-Konfigurationsdatei auch JDBC- und SQLJ-Eigenschaften angeben.
Natural for Db2 for zIIP bietet einen Mechanismus zur Passwortverschlüsselung, mit dem Sie Ihr Passwort mithilfe von Chiffrierschlüsseln sicher verschlüsseln können.
Sie müssen einen Chiffrierschlüssel generieren, der zur Verschlüsselung des Passworts verwendet wird. Mit dem Skript <NDZ home directory>/bin/ndz-db2-pass.sh können Sie den Schlüssel generieren und das Passwort verschlüsseln.
Führen Sie das folgende Skript aus und geben Sie das Passwort für die Db2-Verbindung ein, wenn Sie dazu aufgefordert werden:
<NDZ home directory>/bin/ndz-db2-pass.sh
Optionen:
-g |
Benutzen Sie diese Option, um den Schlüssel zu generieren oder den existierenden Chiffrierschlüssel zu ändern. |
Beispiel:
ndz-db2-pass.sh -g
Die Option -g sollte verwendet werden, wenn Sie das Skript
zum ersten Mal ausführen, um eine Chiffrierschlüsseldatei zu generieren.
Wenn Sie jedoch das Passwort ändern möchten, ohne die Schlüsseldatei zu ändern, müssen
Sie das Skript ohne die Option -g ausführen.
Beispiel:
ndz-db2-pass.sh
Anmerkungen:
Meldung:
WARNING - Db2 encrypted password is not available at <NDZ home
directory/var>. Using password from db2.properties
Geben Sie die folgenden Parameter für die Prozedur der NDZ-Started Task an.
| Parametername | Pflichtangabe | Beschreibung |
|---|---|---|
PATH |
Ja | Das Home-Verzeichnis, in dem die NDZ-Dateien in den Unix System Services (USS) installiert wurden. |
Beispiel:
//NDZ11 EXEC PGM=NDZNUC11,REGION=0M,
//PARM=('PATH=/u/nat/ndz/dev/ndz11')
Geben Sie die folgenden Parameter für Natural for Db2 for zIIP (NDZ) an, um eine Verbindung zu Db2 herzustellen und SQL-Operationen durchzuführen.
| Parametername | Pflichtangabe | Beschreibung |
|---|---|---|
| user | Ja | Benutzerkennung für die Verbindung zu Db2.
Beachten Sie, dass der Benutzer über den erforderlichen Zugriff auf Db2 verfügen sollte, um die erforderlichen SQL-Operationen durchzuführen. Dies ist eine Pflichtangabe. |
| password | Ja | Passwort für den oben genannten Db2-Benutzer.
Beachten Sie, dass Sie das Passwort mit der NDZ Db2 Passwortverschlüsselung verschlüsseln können. Wenn Sie kein verschlüsseltes Passwort haben, können Sie das Passwort hier angeben. Es wird jedoch empfohlen, Ihr Passwort mit der NDZ Db2-Passwortverschlüsselung zu verschlüsseln. |
| databaseName | Ja | Name des Standorts der Db2-Datenbank, um eine Verbindung zu einem
bestimmten Db2-System herzustellen.
Beispiel: |
| serverName | Ja | Vollständig qualifizierte Domänenadresse des z/OS-Systems, mit dem Sie eine
Verbindung herstellen möchten.
Dies ist eine Pflichtangabe. |
| portNumber | Ja | TCP/IP-Portnummer, die das spezifische Db2-Subsystem identifiziert. |
| statementConcentrator | Nein (empfohlen) | Empfohlene Einstellung:
statementConcentrator nicht gesetzt
(statementConcentrator=0) oder aktiviert
(statementConcentrator=2) ist, schlägt ein
MERGE-Statement mit der FOR n
ROWS-Klausel mit dem SQLCODE -20186 fehl.
Daher wird dringend
empfohlen, diesen Parameter auf "aus"
( Weitere Informationen finden Sie im Handbuch Db2 for z/OS Application Programming Guide and Reference for Java. |
| useRowsetCursor / enableRowsetSupport | Nein (empfohlen) | Empfohlene Einstellung:
WHERE CURRENT OF-Klausel auszuführen, muss die
Rowset-Unterstützung deaktiviert sein. Dies kann durch Setzen der Eigenschaften
useRowSetCursor=false und/oder enableRowsetSupport=1
erreicht werden. Es kann eine oder beide Eigenschaften verwendet werden.
Siehe auch Einschränkungen bei der dynamischen Ausführung. Wenn die Rowset-Unterstützung aktiviert ist und ein Statement mit derWHERE CURRENT OF-Klausel ausgeführt
wird, gibt NDZ den Fehler 606 zurück. Weitere Informationen finden Sie unter
Fehlercodes bei Natural for Db2
for zIIP.
|
Sie können außerdem die IBM JDBC- und SQLJ-Eigenschaften festlegen, indem Sie die Eigenschaften in der Datei db2.properties angeben. Siehe Application Programming Guide and Reference for Java bezüglich der verschiedenen JDBC- und SQLJ-Eigenschaften.
Geben Sie die folgenden Parameter an, um die NDZ-Serverinstanz zu konfigurieren.
| Parametername | Pflichtangabe | Beschreibung |
|---|---|---|
| java.home | Ja | Das Java JDK-Installationsverzeichnis. |
| db2.home | Ja | Das Db2-Installationsverzeichnis, das die Lizenzen, JDBC- und SQLJ-Treiber enthält. |
| ndz.maxClients | Ja | Die maximale Anzahl an Clients, die sich gleichzeitig mit dem NDZ-Server verbinden können, um Db2-Anfragen auszuführen. Mögliche Werte: 1-999. |
| ndz.initDb2Connection | Ja | Anzahl der Erstverbindungen zu Db2. |
| ndz.bufferLentgh | Länge des Client-Puffers in MB. Mögliche Werte: 1 -
5000.
|
|
| ndz.staticPath | Ja | Pfad(e) für die statischen Profile. Bei der statischen Vorbereitung werden serialisierte Profile in dem in diesem Parameter genannten Verzeichnis generiert. Die Profile im statischen Pfad werden während der Laufzeit verwendet, um die SQL- Statements statisch auszuführen. |
| ndz.automaticProfileReload | Nein | Gibt an, ob der Cache für statische Profile neu geladen wird, wenn
Änderungen in dem in ndz.staticPath angegebenen
Verzeichnis auftreten. Mögliche Werte: true/false. Der
Standardwert ist false. Wenn der Wert auf true gesetzt ist, wird
zusätzlich CPU-Leistung verbraucht, um das Verzeichnis auf Änderungen zu
überwachen und die statischen Profile neu zu laden. Wenn der Wert auf
false gesetzt ist, können Sie die statischen Profile mit dem
Ändern-Kommando R neu laden.
|
| ndz.retryCount | Nein | Gibt die Anzahl der Versuche an, nach neuen Anforderungen zu suchen, bevor
NDZ-Client-Tasks in den Wartezustand wechseln. Die Leistung von
NDZ-Client-Anwendungen kann verbessert werden, wenn die Task, die die
Anforderungen verarbeitet, kontinuierlich ausgeführt wird, wodurch
Kontextwechsel vermieden werden. Dieses Verhalten wird nur wirksam, wenn diese
Eigenschaft auf einen Wert ungleich Null gesetzt ist. Der Standardwert ist
0.
|
| ndz.redispatchCount | Nein | Gibt an, nach wie vielen Wiederholungsversuchen (Eigenschaft
ndz.retryCount) die NDZ-Client-Task die Nutzung des Prozessors an
andere Tasks übergibt. Durch Festlegen dieser Eigenschaft kann die Leistung von
NDZ verbessert und eine Überlastung der CPU vermieden werden. Dieses Verhalten
wird nur wirksam, wenn diese Eigenschaft und ndz.retryCount auf
Werte ungleich Null festgelegt sind. Der Standardwert ist
0.
|
Die folgenden Parameter werden zum Setzen der Umgebungsvariablen für Natural for Db2 for zIIP (NDZ) benötigt.
| Parametername | Pflichtangabe | Beschreibung |
|---|---|---|
DB2_HOME |
Ja | Aktualisieren Sie das Db2-Installationsverzeichnis, das Lizenzen, JDBC- und SQLJ-Treiber enthält. (Ex - /usr/lpp/db2vrs) |
JAVA_HOME |
Ja | Aktualisieren Sie das Java JDK-Installationsverzeichnis (Ex - /usr/lpp/java/Jvrs) |
NDZ_HOME |
Ja | Pfad des NDZ-Installationsverzeichnisses, in dem sich die NDZ-Dateien befinden. |