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