Konfiguration und Parameter für NDZ

#### Search Results

Search

# Konfiguration und Parameter für NDZ

- Konfiguration

- Parameter für NDZ

## Konfiguration

- Allgemeine Produktkonfiguration

- Db2-Konfiguration

- Db2-Passwortverschlüsselung

### Allgemeine Produktkonfiguration

Im Folgenden finden Sie die Komponenten, mit denen Sie den NDZ nach Ihren Vorgaben konfigurieren können.

#### NDZ Started Task

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.

#### NDZ-Konfiguration

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

#### Umgebungsvariablen setzen

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

### Db2-Konfiguration

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.

### Db2-Passwortverschlüsselung

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:

1. Wenn Ihr Db2- Verbindungspasswort verschlüsselt ist, wird der Passwortparameter in der db2.properties ignoriert.
2. Wenn Ihr Db2-Verbindungspasswort nicht verschlüsselt ist, erhalten Sie eine Warnmeldung, wenn Sie den NDZ-Server starten.

Meldung:

`WARNING - Db2 encrypted password is not available at <NDZ home directory/var>. Using password from db2.properties`

## Parameter für NDZ

- NDZ Started Task-Prozedur

- Db2-Konfigurationsdatei (db2.properties)

- NDZ-Konfigurationsdatei (ndz.properties)

- NDZ USS-Umgebungskonfigurationsdatei (setenv.sh)

### NDZ Started Task-Prozedur

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

### Db2-Konfigurationsdatei (db2.properties)

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: `DAEFDB2D` Dies ist eine Pflichtangabe.
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=1` Wenn `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" (`statementConcentrator=1`) zu setzen. Siehe auch Einschränkungen in Bezug auf die dynamische Ausführung. Weitere Informationen finden Sie im Handbuch Db2 for z/OS Application Programming Guide and Reference for Java.
useRowsetCursor / enableRowsetSupport | Nein (empfohlen) | Empfohlene Einstellung: `useRowsetCursor=false` Um Statements mit der `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 der `WHERE 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.

### NDZ-Konfigurationsdatei (ndz.properties)

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

### NDZ USS-Umgebungskonfigurationsdatei (setenv.sh)

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.

### On this page

- Konfiguration
- Parameter für NDZ