CLI0111E Numerischer Wert liegt außerhalb des Bereichs.

Erläuterung

Eine Übergabe der numerischen Daten hätte bewirkt, dass der gesamte numerische Wert abgeschnitten worden wäre.

SQLPutData wurde für einen Parameter mehrmals aufgerufen und die Eingabedaten hatten nicht den Datentyp SQL_C_CHAR oder SQL_C_BINARY.

Benutzeraktion

Umgebungskennung
Verbindungskennung
Anweisungskennung
Deskriptorkennung

Diese Nachricht wird zurückgegeben, wenn alle zuordnungsbaren Kennungen zugeordnet wurden und versucht wurde, über eine der folgenden Funktionen einer Kennung zuzuordnen:

SQLAllocEnv
SQLAllocConnect
SQLAllocStmt
SQLAllocHandle
SQLExecute
SQLExecDirect

Benutzeraktion

Rufen Sie SQLFreeEnv, SQLFreeConnect, SQLFreeStmt oder SQLFreeHandle auf, um Kennungen freizugeben, die in der Anwendung nicht mehr verwendet werden.

Führen Sie eine oder beide der folgenden Aktionen aus, um die Häufigkeit des Auftretens dieses Fehlers zu verringern:

Modifizieren Sie die Anwendung so, dass sie Kennungen häufiger freigibt.
Erhöhen Sie den Wert des CLI/ODBC-Konfigurationsparameters CLIPkg mit dem Befehl BIND, um die Anzahl der Anweisungskennungen zu erhöhen, die zugeordnet werden können.

Der Treiber hat nicht versucht, eine Verbindung zur Datenquelle herstellen.

Benutzeraktion

Geben Sie einen gültigen Standardsubsystemnamen an und wiederholen Sie den Vorgang.

CLI0201E Ungültiger Datenbankwert.

Erläuterung

Der in der Verbindungszeichenfolge oder der Verbindungs-API verwendete Datenbankname oder der Aliasname der Datenbank ist ungültig.

Der Treiber hat nicht versucht, eine Verbindung zur Datenquelle herstellen.

Benutzeraktion

Geben Sie einen gültigen Datenbanknamen an und wiederholen Sie den Vorgang.

CLI0202E Fehler beim Öffnen der Capture-Datei der CLI-Clientoptimierungsfunktion.

Erläuterung

Die CLI-Clientoptimierungsfunktion kann die im pureQueryXML-CLI-Parameterwert angegebene Datei nicht öffnen. Entweder weist die Datei nicht die entsprechenden Berechtigungen auf oder die Datei wird von einem anderen Prozess exklusiv verwendet.

Die CLI-Clientoptimierungsfunktion wird durch die Angabe des CLI-Schlüsselworts "captureMode" oder "executionMode" aktiviert.

Das pureQueryXML CLI-Schlüsselwort gibt die Speicherposition der Capture-Datei entweder über einen absoluten oder über einen relativen Pfad zu der Verzeichnisposition an, an der die CLI-Anwendung ausgeführt wird.

Während der Erfassungsphase der Clientoptimierungsfunktion kann die Capture-Datei an der angegebenen Speicherposition vorhanden sein, sie muss jedoch nicht vorhanden sein. Wenn die Datei vorhanden ist, muss die Clientoptimierungsfunktion über Lese- und Schreibberechtigung für die Capture-Datei verfügen. Wenn die Datei nicht vorhanden ist, muss die Clientoptimierungsfunktion über Schreibberechtigung für das Verzeichnis verfügen, um die Datei zu erstellen.

Während der Abgleichsphase der Clientoptimierungsfunktion muss die Capture-Datei vorhanden sein und die Clientoptimierungsfunktion muss über Leseberechtigung für die angegebene Datei verfügen.

CLI gibt einen Fehler zurück, wenn eine dieser Berechtigungen nicht verfügbar ist.

Benutzeraktion

Geben Sie den Namen einer Capture-Datei mit den entsprechenden Berechtigungen für das pureQueryXML CLI-Schlüsselwort an oder inaktivieren Sie die Clientoptimierungsfunktion.

CLI0203E Die Clientoptimierungsfunktion wird nicht unterstützt, wenn die Erstellung statischer Profile im DB2-CLI-Treiber aktiviert ist.

Erläuterung

Der Funktion zur Erstellung statischer Profile des DB2-CLI-Treibers kann nicht mit der Clientoptimierungsfunktion verwendet werden. CLI lässt die gleichzeitige Aktivierung der Clientoptimierung und der Funktion zur Erstellung statischer Profile für eine bestimmte Datenbankverbindung nicht zu.

Benutzeraktion

Verwenden Sie entweder die Clientoptimierungsfunktion oder die Funktion zur Erstellung statischer Profile des DB2-CLI-Treibers. Die Clientoptimierung kann durch Entfernen der CLI-Schlüsselwörter "captureMode" und "executionMode" inaktiviert werden. Die Erstellung statischer Profile des DB2-CLI-Treibers kann durch Entfernen des CLI-Schlüsselworts "StaticMode" inaktiviert werden.

CLI0204E Die dynamische Ausführung einer SQL-Anweisung ist nicht zulässig.

Erläuterung

Die Clientoptimierungsfunktion kann keine übereinstimmende SQL-Anweisung in der pureQueryXml-Capture-Datei finden, wenn das CLI-Schlüsselwort "executionMode" auf STATIC und der Wert des CLI-Schlüsselworts "allowDynamicSQL" auf FALSE gesetzt ist. Die dynamische Ausführung ist mit dieser Konfiguration nicht zulässig.

Wenn eine CLI-Anwendung SQL-Anweisungen dynamisch ausführen soll, ermöglicht die Angabe des Werts TRUE für das Schlüsselwort "allowDynamicSQL" die dynamische Ausführung einer SQL-Anweisung, wenn keine übereinstimmende Anweisung in der pureQueryXml-Capture-Datei gefunden wird.

Alternativ kann die pureQueryXml-Capture-Datei während einer inkrementellen Erfassungsphase aktualisiert werden, sodass eine fehlende SQL-Anweisung eingefügt wird. Nach dieser Erfassungsphase muss eine Konfigurationsphase und eine StaticBinder-Phase der Clientoptimierungsfunktion folgen, bevor die Anwendung mit dem Wert STATIC für das Schlüsselwort "executionMode" ausgeführt werden kann.

Benutzeraktion

Geben Sie für das Schlüsselwort "allowDynamicSQL" den Wert TRUE an oder aktualisieren Sie die pureQueryXml-Capture-Datei, sodass die SQL-Anweisung eingefügt wird.

CLI0205E Bibliothek db2clixml4c kann nicht gefunden werden.

Erläuterung

db2clixml4c kann nicht im Bibliothekspfad gefunden werden.

Der Bibliothekspfad wird durch die Umgebungsvariable für die folgenden Betriebssysteme definiert:

AIX (Java 1.1): LD_LIBRARY_PATH
AIX (Java 1.2 oder höher): LIBPATH
HP-UX: SHLIB_PATH
Linux: LD_LIBRARY_PATH
Silicon Graphics IRIX: LD_LIBRARY_PATH
Solaris-Betriebsumgebung: LD_LIBRARY_PATH
Windows-Betriebssysteme: PATH

Die Bibliothek db2clixml4c wird dynamisch geladen, wenn eine CLI-Anwendung die Verwendung der Clientoptimierungsfunktion angefordert hat. CLI versucht, diese Bibliothek im Bibliothekspfad zu lokalisieren. Die DB2-CLI-Treiber enthalten diese Bibliothek im Standardbibliothekspfad, sofern sie installiert ist. Kann die Bibliothek db2clixml4c nicht gefunden werden, kann die Clientoptimierungsfunktion durch Entfernen der CLI-Schlüsselwörter "captureMode" und "executionMode" inaktiviert werden.

Benutzeraktion

CLI0206E Ein Element pureQueryXml-Capture-Datei kann nicht gelesen werden.

Erläuterung

Die Clientoptimierungsfunktion liest die pureQueryXml-Capture-Datei. Wenn mindestens ein Eintrag in dieser Datei fehlerhaft oder ungültig ist, kann die Clientoptimierungsfunktion nicht fortgesetzt werden.

Dieser Fehler kann durch manuelle Änderungen an der pureQueryXml-Capture-Datei verursacht werden. Wenn die Datei nicht geändert wurde und vollständig vom CLI-Treiber oder dem Konfigurationstool generiert wurde, wenden Sie an die technische Unterstützung von IBM.

Benutzeraktion

Stellen Sie sicher, dass die pureQueryXml-Capture-Datei korrekt ist oder erfassen Sie die pureQueryXml-Capture-Datei erneut.

CLI0207E Ungültige Dateierweiterung für die pureQueryXml-Capture-Datei.

Erläuterung

Die pureQueryXml-Capture-Datei muss die Dateierweiterung "xml" oder "pdqxml" haben.

Benutzeraktion

Geben Sie eine Datei mit einer unterstützten Dateierweiterung für das pureQueryXml CLI-Schlüsselwort an.

CLI0208E Die Codepage konnte für diese Verbindung nicht festgelegt werden, da die Verbindung zu einer XA-Umgebung gehört.

Erläuterung

Das Festlegen der Codepage auf Verbindungsebene wird in einer XA-Umgebung nicht unterstützt.

Diese Nachricht wird zurückgegeben, wenn eine Anwendung versucht, das Verbindungsattribut SQL_ATTR_CLIENT_CODEPAGE nach einem Aufruf von xa_open festzulegen.

Die Codepage wurde nicht geändert.

Benutzeraktion

Reagieren Sie auf diese Nachricht wie folgt: Soll die Verbindung ohne Änderung der Codepage geöffnet werden, öffnen Sie die Verbindung erneut, ohne das Verbindungsattribut SQL_ATTR_CLIENT_CODEPAGE anzugeben. Soll die Codepage geändert werden, verwenden Sie die Umgebungsvariable DB2CODEPAGE.

CLI0209E Die Anwendung konnte die Abfrage nicht ausführen, da das Schlüsselwort capturedOnly zwar auf TRUE gesetzt ist, die Clientoptimierung aber keine entsprechenden Anweisungen in der pureQueryXML-Capture-Datei gefunden hat.

Erläuterung

Sie können die SQL- und XQuery-Leistung verbessern, indem Sie SQL- und XQuery-Anweisungen in den pureQueryXML-Capture-Dateien erfassen.

Sollen nur die entsprechenden Anweisungen in den pureQueryXML-Dateien ausgeführt werden, können Sie das Schlüsselwort capturedOnly auf TRUE setzen. SQL-Anweisungen, die nicht in der pureQueryXM-Datei enthalten sind, werden nicht ausgeführt, wenn das Schlüsselwort capturedOnly auf TRUE gesetzt ist.

Diese Nachricht wird zurückgegeben, wenn das Schlüsselwort capturedOnly zwar auf TRUE gesetzt ist, in der pureQueryXML-Datei aber keine entsprechenden Anweisungen enthalten sind.

Benutzeraktion

Führen Sie zur Verwendung der Clientoptimierung mit einer pureQueryXML-Datei die folgenden Schritte aus:

Erfassen Sie SQL- und XQuery-Anweisungen in einer pureQueryXML-Datei. Gehen Sie dazu wie folgt vor:
1. Starten Sie den Erfassungsmodus, indem Sie die Eigenschaft captureMode auf ON setzen.
2. Führen Sie alle logischen Pfade aus, die die SQL- oder XQuery-Anweisungen enthalten, die Sie erfassen wollen.
3. Beenden Sie den Erfassungsmodus indem Sie die Eigenschaft captureMode auf OFF setzen.
Führen Sie die Anwendung erneut aus.

CLI0210E Die Anweisung konnte nicht ausgeführt werden, da die Codepage der Parametermarken oder Ergebnismengenspalten nicht mit der Codepage übereinstimmt, die zurzeit im Verbindungsattribut SQL_ATTR_OVERRIDE_CHARACTER_CODEPAGE angegeben ist.

Erläuterung

Normalerweise findet die Zeichenkonvertierung beim Einfügen oder Abrufen von Daten automatisch statt, wenn sich die Codepage einer Clientanwendung von der Codepage des Datenbankservers unterscheidet, mit dem die Anwendung verbunden ist.

Sie können dieses automatische Verhalten für Einfüge- und Aktualisierungsoperationen mit Parameterangabe sowie zum Abrufen von Abfrageergebnissen mithilfe des Verbindungsattributs SQL_ATTR_OVERRIDE_CHARACTER_CODEPAGE überschreiben. Wenn die Codepage der Parametermarken oder Ergebnismengenspalten der Anweisung mit dem Wert SQL_ATTR_OVERRIDE_CHARACTER_CODEPAGE übereinstimmen, findet während der Ausführen der Anweisung keine Zeichenkonvertierung statt.

Diese Nachricht wird zurückgegeben, wenn versucht wird, eine Anweisung auszuführen, deren Beschreibungsinformationen für Parametermarken oder Ergebnismengenspalten nicht mit der Codepage übereinstimmen, auf die das Verbindungsattribut SQL_ATTR_OVERRIDE_CHARACTER_CODEPAGE gesetzt ist.

Benutzeraktion

Führen Sie die folgenden Schritte aus, um Daten ohne Zeichenkonvertierung einzufügen oder abzurufen:

Ermitteln Sie die Codepage, die in den Beschreibungsinformationen für Parametermarken oder Ergebnismengenspalten der aktuellen Anweisung angegeben ist.
Geben Sie alle Anweisungskennungen frei, die der aktuellen Verbindung zugeordnet sind.
Setzen Sie das Verbindungsattribut SQL_ATTR_OVERRIDE_CHARACTER_CODEPAGE auf dieselbe Codepage wie die in den Beschreibungsinformationen für Parametermarken oder Ergebnismengenspalten der aktuellen Anweisung angegebene Codepage.
Ordnen Sie die aktuelle Anweisungskennung erneut zu.
Führen Sie die Anweisung erneut aus.

CLI0211E Das Konfigurieren der angegebenen Eigenschaft ist fehlgeschlagen, da der angegebene Wert nicht mit vorhandenen Eigenschaftseinstellungen kompatibel ist.

Erläuterung

Sie können die Leistung Ihrer Datenbankanwendung mithilfe der pureQuery-Clientoptimierung verbessern. Sie können beispielsweise mithilfe der pureQuery-Clientoptimierung eine SQL-Anweisung, die langsam ausgeführt wird, durch eine schnell ablaufende SQL-Anweisung ersetzen, ohne Ihre Anwendung umzuschreiben.

Das Verhalten der pureQuery-Clientoptimierungsfunktion wird über eine Reihe von Eigenschaften gesteuert. Sie können beispielsweise die Eigenschaft enableDynamicSQLReplacement auf TRUE setzen, um das Ersetzen von SQL-Anweisungen zu ermöglichen. Diese Nachricht wird zurückgegeben, wenn versucht wurde, eine dieser Eigenschaften auf einen Wert zu setzen, der nicht mit anderen, bereits vorhandenen Eigenschaftswerten kompatibel ist.

Diese Nachricht wird zurückgegeben, wenn beim Versuch, die pureQuery-Clientoptimierung zu konfigurieren, eine der folgenden inkompatiblen Kombinationen angegeben wurde:

Es wurde versucht, sowohl das dynamische Ersetzen von SQL-Anweisungen als auch den Aufzeichnungsmodus zu aktivieren.
Das dynamische Ersetzen von SQL-Anweisungen wird nicht unterstützt, wenn pureQuery sich im Aufzeichnungsmodus befindet. Insbesondere kann enableDynamicSQLReplacement nicht auf TRUE gesetzt werden, wenn captureMode auf ON gesetzt ist, und captureMode kann nicht auf ON gesetzt werden, wenn enableDynamicSQLReplacement auf TRUE gesetzt ist.
Es wurde versucht, sowohl den statischen Ausführungsmodus als auch den Aufzeichnungsmodus zu aktivieren.
Der statische Ausführungsmodus wird nicht unterstützt, wenn pureQuery sich im Aufzeichnungsmodus befindet. Insbesondere kann executionMode nicht auf STATIC gesetzt werden, wenn captureMode auf ON gesetzt ist, und captureMode kann nicht auf ON gesetzt werden, wenn executionMode auf STATIC gesetzt ist.

Benutzeraktion

Reagieren Sie auf eine der folgenden Weisen auf diese Nachricht:

Wenn der Einsatz der pureQuery-Clientoptimierungsfunktion nicht erforderlich ist, inaktivieren Sie diese Funktion, indem Sie die folgende Konfiguration festlegen:
```
captureMode=OFF [oder nicht festgelegt lassen]
executionMode=DYNAMIC [oder nicht festgelegt lassen]
```
Wenn Sie die pureQuery-Clientoptimierungsfunktion verwenden wollen, geben Sie eine entsprechende kompatible Kombination der Eigenschaften für diese Funktion an:
1. Aktivieren Sie das dynamische Ersetzen von SQL-Anweisungen oder den Aufzeichnungsmodus, aber nicht beides:
  - Aktivieren Sie das dynamische Ersetzen von SQL-Anweisungen mit den folgenden Eigenschaftseinstellungen:
```
enableDynamicSQLReplacement=TRUE
captureMode=OFF [oder nicht festgelegt lassen]
```
  - Aktivieren Sie den Aufzeichnungsmodus mit den folgenden Eigenschaftseinstellungen:
```
captureMode=ON
enableDynamicSQLReplacement=FALSE
[oder enableDynamicSQLReplacement nicht festgelegt lassen]
```
2. Aktivieren Sie den Aufzeichnungsmodus oder den statischen Ausführungsmodus, aber nicht beides:
  - Aktivieren Sie den Aufzeichnungsmodus mit den folgenden Eigenschaftseinstellungen:
```
captureMode=ON
executionMode=DYNAMIC [oder nicht festgelegt lassen]
```
  - Legen Sie die folgenden Eigenschaftseinstellungen fest, um den statischen Ausführungsmodus zu verwenden:
```
captureMode=OFF [oder nicht festgelegt lassen]
executionMode=STATIC
```

CLI0212W Während einer Verbindungs- oder Ausführungsanforderung ist eine nahtlose Funktionsübernahme aufgetreten.

Erläuterung

Eine Verbindung ist nicht mehr vorhanden oder konnte nicht hergestellt werden. Während einer Verbindungs- oder Ausführungsanforderung konnte sie jedoch erfolgreich wiederhergestellt werden.

Wenn ein Verbindungsfehler festgestellt wird, versucht der CLI-Treiber, eine Verbindung zu einem anderen Member oder einem Member einer anderen Gruppe herzustellen, um die fehlerfreie Ausführung einer Anwendung sicherzustellen.

Die Anforderung wurde erfolgreich ausgeführt.

Benutzeraktion

Keine Aktion erforderlich.

CLI0213E Das Abrufen der pureQueryXML-Datei aus dem Repository ist fehlgeschlagen.

Erläuterung

pureQuery Runtime ermittelt das Repository zum Abrufen der pureQueryXML-Datei mithilfe der Laufzeitgruppen-ID und der Verbindungsinformationen.

Die von Ihnen über die Eigenschaft pureQueryXmlRepository oder propertiesGroupId angegebene pureQueryXML-Datei kann möglicherweise aus den folgenden Gründen nicht abgerufen werden:

Das über die Eigenschaft pureQueryXmlRepository angegebene Repository ist ungültig oder es kann nicht darauf zugegriffen werden.
Die über die Eigenschaft propertiesGroupId angegebene Laufzeitgruppen-ID ist ungültig oder wurde nicht aktiviert.

Benutzeraktion

Führen Sie alle auf Ihren Fall zutreffenden Aktionen aus:

Stellen Sie sicher, dass Sie auf das über die Eigenschaft pureQueryXmlRepository angegebene Repository zugreifen können.
Stellen Sie sicher, dass die über die Eigenschaft propertiesGroupId angegebene Laufzeitgruppen-ID aktiviert wurde.
Ändern Sie gegebenenfalls den Wert der Eigenschaft pureQueryXmlRepository oder propertiesGroupId, sodass über das Repository auf die pureQueryXML-Datei zugegriffen werden kann.

CLI0214E Die Eigenschaft propertiesGroupId wurde in der Konfigurationsdatei nicht angegeben.

Erläuterung

Die Eigenschaft propertiesGroupId war nicht auf die im Repository für die pureQueryXML-Datei angegebene Laufzeitgruppen-ID gesetzt.

pureQuery Runtime ermittelt das Repository zum Abrufen der pureQueryXML-Datei mithilfe der Laufzeitgruppen-ID und der Verbindungsinformationen. Ist propertiesGroupId nicht angegeben, kann die pureQueryXML-Datei nicht aus dem Repository abgerufen werden.

Benutzeraktion

Setzen Sie die Eigenschaft propertiesGroupId auf die Laufzeitgruppen-ID, die in dem Repository definiert ist, in dem die pureQueryXML-Datei gespeichert ist.

CLI0215E Die Verbindung ist fehlgeschlagen, da die pureQuery-Clientoptimierung versuchte, auf die pureQueryXML-Capture-Datei zuzugreifen, aber in der Eigenschaft pureQueryXML kein gültiger Dateiname angegeben wurde.

Erläuterung

Sie können die Leistung Ihrer Datenbankanwendung mithilfe der pureQuery-Clientoptimierung verbessern. Sie können z. B. Informationen zu SQL-Anweisungen erfassen, während die Anweisungen in einer pureQueryXML-Capture-Datei aufgezeichnet werden. Mit dieser Capture-Datei (auch als pureQueryXML-Datei bezeichnet) können dieselben SQL-Anweisungen später mit besserer Leistung ausgeführt werden. Der Name der pureQueryXML-Capture-Datei wird über die Eigenschaft pureQueryXML angegeben.

Die Clientoptimierung kann mithilfe einer Gruppe pureQuery-bezogener Eigenschaften einschließlich der folgenden Beispiele konfiguriert und gesteuert werden:

enableDynamicSQLReplacement - Wird enableDynamicSQLReplacement auf "TRUE" gesetzt, werden in der pureQueryXML-Datei enthaltene alternative SQL-Anweisungen ausgeführt.
executionMode - Wird executionMode auf "STATIC" gesetzt, werden in der pureQueryXML-Datei enthaltene SQL-Anweisungen statisch ausgeführt.

Diese Nachricht wird ausgeführt, wenn versucht wird, pureQuery-Clientoptimierungsfunktionalität zu verwenden, die die pureQueryXML-Datei erfordert, die pureQueryXML-Datei jedoch nicht angegeben wurde.

Benutzeraktion

Geben Sie den Namen der pureQueryXML-Datei über die Eigenschaft pureQueryXML an und führen Sie die Anwendung erneut aus.

CLI0217E Die pureQuery-Clientoptimierungsfunktion konnte die angegebene pureQueryXML-Capture-Datei nicht verwenden, weil die Version der Capture-Datei nicht von der Call Level Interface unterstützt wird.

Erläuterung

Sie können die Leistung von SQL und XQuery verbessern, indem Sie Informationen zu SQL- und XQuery-Anweisungen in pureQueryXML-Capture-Dateien erfassen. Die Version der pureQueryXML-Capture-Datei wird durch die zum Generieren der Capture-Datei verwendete Methode bestimmt. Es folgen Beispiele für Methoden zum Generieren einer pureQueryXML-Capture-Datei:

Verwenden des Befehls db2cap
Verwenden des pureQuery-Dienstprogramms GeneratePureQueryXml

Die Call Level Interface (CLI) von DB2 for Linux, UNIX, and Windows unterstützt vom Dienstprogramm GeneratePureQueryXml generierte pureQueryXML-Capture-Dateien nicht.

Diese Nachricht wird zurückgegeben, wenn eine DB2-CLI-Anwendung versucht, die pureQuery-Clientoptimierung mit einer pureQueryXML-Capture-Datei zu verwenden, die vom Dienstprogramm GeneratePureQueryXml generiert wurde.

Benutzeraktion

Generieren Sie eine pureQueryXML-Capture-Datei mit einer anderen Methode als dem Dienstprogramm GeneratePureQueryXml neu.

CLI0219E Die zertifikatbasierte Authentifizierung ist fehlgeschlagen, weil der DB2-Client oder -Datenservertreiber so konfiguriert war, dass er die zertifikatbasierte Authentifizierung verwendete, aber außerdem ein Kennwort mit der Verbindung angegeben wurde.

Erläuterung

Sie können die SSL-Clientauthentifizierung auf der Basis einer einzigen Benutzer-ID bei Datenbankservern mit zertifikatbasierter Authentifizierung verwenden. Mit der zertifikatbasierten Authentifizierung können Sie die SSL-Clientauthentifizierung verwenden, ohne dass Datenbankkennwörter auf dem Datenbankclient speichern und verwalten zu müssen.

Sie können die zertifikatbasierte Authentifizierung verwenden, indem Sie in der CLI-Konfigurationsdatei (db2cli.ini) oder in der Konfigurationsdatei für den Datenservertreiber (db2dsdriver.cfg) die entsprechenden Konfigurationsparameter angeben, beispielsweise SSLClientKeystash oder SSLClientKeystoreDBPassword.

Wenn die zertifikatbasierte Authentifizierung so konfiguriert ist, dass Authentifizierungsinformationen bereitgestellt werden, kann ein Kennwort nicht auf andere Arten (z. B. in der Konfigurationsdatei db2dsdriver.cfg, in der Konfigurationsdatei db2cli.ini oder in der Verbindungszeichenfolge) angegeben werden. Diese Nachricht wird zurückgegeben, wenn die zertifikatbasierte Authentifizierung so konfiguriert ist, dass Authentifizierungsinformationen bereitgestellt werden und ein Kennwort außerdem auf eine andere Art angegeben wird.

Benutzeraktion

Führen Sie die folgenden Schritte aus, um über eine zertifikatbasierte Authentifizierung zu authentifizieren:

Geben Sie entweder SSLClientKeystash oder SSLClientKeystoreDBPassword in der CLI-Konfigurationsdatei oder der Konfigurationsdatei für den Datenservertreiber an.
Stellen Sie sicher, dass in der Konfigurationsdatei db2dsdriver.cfg, in der Konfigurationsdatei db2cli.ini oder in der Verbindungszeichenfolge kein Kennwort angegeben ist.

Setzen Sie den Authentifizierungsparameter auf CERTIFICATE.
Geben Sie SSLClientLabel in der CLI-Konfigurationsdatei oder in der Konfigurationsdatei für den Datenservertreiber an.

Diese Nachricht wird zurückgegeben, wenn die Funktion SQLReloadConfig die IBM Data Server Driver-Konfigurationsdatei nicht finden kann oder wenn die Funktion SQLReloadConfig die IBM Data Server Driver-Konfigurationsdatei nicht lesen kann.

Benutzeraktion

Führen Sie die folgenden Schritte zur Fehlerbehebung aus:

Wenn die Registry-Variable DB2DSDRIVER_CFG_PATH festgelegt wurde, vergewissern Sie sich, dass sich die IBM Data Server Driver-Konfigurationsdatei in dem Verzeichnis befindet, das in der Registry-Variablen DB2DSDRIVER_CFG_PATH angegeben wurde.
Wenn die Registry-Variable DB2DSDRIVER_CFG_PATH nicht festgelegt wurde, vergewissern Sie sich, dass sich die IBM Data Server Driver-Konfigurationsdatei an der Standardposition für den Treibertyp und die Plattform befindet.
Vergewissern Sie sich, dass die Benutzer-ID, die zur Ausführung der Anwendung verwendet wurde, über Lesezugriff für die IBM Data Server Driver-Konfigurationsdatei verfügt.

CLI0226E Die Funktion SQLReloadConfig ist fehlgeschlagen, da andere Abschnitte in der IBM Data Server Driver-Konfigurationsdatei als der im Argument ConfigProperty angegebene Abschnitt aktualisiert wurden.

Erläuterung

Diese Nachricht wird zurückgegeben, wenn die Funktion SQLReloadConfig erkennt, dass andere Abschnitte als der im Argument ConfigProperty angegebene Abschnitt aktualisiert wurden.

Benutzeraktion

Setzen Sie die Eigenschaften in der IBM Data Server Driver-Konfigurationsdatei wieder auf Werte zurück, die der aktuell aktiven Konfiguration entsprechen.
Aktualisieren Sie nur die Abschnitte in der IBM Data Server Driver-Konfigurationsdatei, die mit der Funktion SQLReloadConfig unterstützt werden.
Führen Sie die Funktion SQLReloadConfig erneut aus und geben Sie dabei die aktualisierten Abschnitte im Argument ConfigProperty an.

Ermitteln Sie, zu welchen Servern der IBM Client oder Treiber keine Verbindung herstellen kann.
Beheben Sie für jeden Server, zu dem der IBM Client oder Treiber keine Verbindung herstellen kann, die Probleme, die den IBM Client oder Treiber am Herstellen der Verbindung hindern.
Aktualisieren Sie den Abschnitt <alternateserverlist> der IBM Data Server Driver-Konfigurationsdatei, sodass nur noch der Server angegeben ist, zu dem der IBM Client oder Treiber eine Verbindung herstellen kann.
Rufen Sie SQLReloadConfig erneut auf.

Diese Nachricht wird zurückgegeben, wenn der Wert NULL für das Verbindungsattribut SQL_ATTR_OVERRIDE_PRIMARY_AFFINITY angegeben ist, aber das Primärmember nicht überschrieben wurde und das Feature für die automatische Clientweiterleitung bereits das Primärmember verwendet, das in der IBM Data Server Driver-Konfigurationsdatei angegeben ist.

Benutzeraktion

Keine Aktion erforderlich.

CLI0237W Das angegebene Primärmember wurde bereits festgelegt.

CLI0242E Die Ausführung der Anweisung CALL im Stapelbetrieb ist fehlgeschlagen, da das Feature für die Array-Eingabekette angegeben wurde.

Erläuterung

Das Feature für die Array-Eingabekette wird von der Ausführung der Anweisung CALL im Stapelbetrieb nicht unterstützt. Das Feature für die Array-Eingabekette wird mit den folgenden Methoden aktiviert:

Aktivieren des Schlüsselwortes ArrayInputChain in der Datei db2cli.ini oder der IBM Data Server Driver-Konfigurationsdatei.
Festlegen des Attributs SQL_ATTR_CHAINING_BEGIN oder SQL_ATTR_CHAINING_END in der API SQLSetStmtAttr.

Der CLI-Treiber konvertiert die verketteten Daten der MERGE-Anweisung in eine Array-Eingabe. Die Arrays, die für das Puffern von MERGE-Anweisungen verwendet werden, haben eine feste Größe. Wenn für eine Anweisung mehr Ressourcen erforderlich sind, als von einem Array verarbeitet werden können, führt der CLI-Treiber den Array aus, der zurzeit gepuffert wird, und führt die verbleibenden Daten der MERGE-Anweisung mithilfe mindestens eines weiteren Arrays aus.

Diese Nachricht wird zurückgegeben, wenn die maximale Größe eines Arrays erreicht wird, der für die Verarbeitung einer MERGE-Anweisung verwendet wird, oder wenn die Gesamtgröße der Daten 20 MB beträgt.

Die Funktion SQLExecute() wurde erfolgreich aufgerufen.

Benutzeraktion

Keine Aktion erforderlich.

CLI0248W Die Größe des DB2-Tracepuffers wurde nicht auf den Wert gesetzt, der mit dem Schlüsselwort db2trcStartupSize oder dem Umgebungsattribut SQL_ATTR_DB2TRC_STARTUP_SIZE angegeben wurde, da der Tracepuffer bereits zugeordnet wurde.

Erläuterung

Sie können die Größe des DB2-Tracepuffers konfigurieren, indem Sie sie über das Schlüsselwort db2trcStartupSize in der Konfigurationsdatei von IBM Data Server Driver (db2dsdriver.cfg) oder mithilfe des Umgebungsattributs SQL_ATTR_DB2TRC_STARTUP_SIZE festlegen. Wenn sowohl das Schlüsselwort db2trcStartupSize als auch das Umgebungsattribut SQL_ATTR_DB2TRC_STARTUP_SIZE gesetzt sind, hat das Schlüsselwort db2trcStartupSize Vorrang.

Sie können die Größe des DB2-Tracepuffers nur konfigurieren, solange der Prozess, der die Datenbankproduktbibliotheken verwendet, keine Umgebungskennung zugeordnet hat. Die Größe des DB2-Tracepuffers kann nicht durch Modifizieren des Schlüsselworts db2trcStartupSize oder Festlegen des Umgebungsattributs SQL_ATTR_DB2TRC_STARTUP_SIZE geändert werden, während die Datenbankproduktbibliotheken im Betriebssystem geladen werden.

Sie können die Größe des DB2-Tracepuffers mithilfe des Befehls db2trc info ermitteln.

Benutzeraktion

Führen Sie die folgenden Schritte aus, um den Tracepuffer zu vergrößern:

Stoppen Sie gegebenenfalls den Datenbankmanager durch Absetzen des Befehls db2stop.
Stoppen Sie den DB2-Traceprozess, indem Sie den Befehl db2trc mit der Option "off" absetzen.
Starten Sie den DB2-Traceprozess, indem Sie den Befehl db2trc absetzen und die neue Größe des DB2-Tracepuffers über den Parameter -l angeben.
Starten Sie gegebenenfalls den Datenbankmanager durch Absetzen des Befehls db2start.
Löschen Sie den Inhalt des DB2-Tracepuffers, indem Sie den Befehl db2trc mit der Option "clear" absetzen.

CLI0249E Der Versuch, die Bibliothek für die GSKit-Schlüsselverwaltung (IBM Global Security Toolkit) zu laden, ist fehlgeschlagen.

Erläuterung

Der CLI-Treiber lädt die Bibliothek für die GSKit-Schlüsselverwaltung während der Zuordnung der ersten Umgebungskennung. Dieser Fehler kann aufgrund einer der folgenden Bedingungen zurückgegeben werden:

Die GSKit-Bibliothek ist nicht auf dem Clientsystem installiert.
Der CLI-Treiber kann die Bibliothek für die GSKit-Schlüsselverwaltung nicht finden.
Der CLI-Treiber kann mindestens eine der abhängigen Bibliotheksdateien nicht finden, die für die Bibliothek für die GSKit-Schlüsselverwaltung erforderlich sind.

Benutzeraktion

Stellen Sie sicher, dass die Bibliotheksdateien für die GSKit-Schlüsselverwaltung im Verzeichnis <installationspfad>/lib/icc vorhanden sind. Wenn Sie ein separates GSKit-Paket installiert haben, stellen Sie sicher, dass die folgenden Umgebungsvariablen auf das GSKit-Installationsverzeichnis gesetzt sind.

PATH
LIBPATH (für AIX)
LD_LIBRARY_PATH (für Linux- und UNIX-Betriebssysteme, außer AIX)

CLI0250E Der Versuch, die Keystore-Datenbank zu erstellen, ist fehlgeschlagen.

Erläuterung

Der CLI-Treiber erstellt die Keystore-Datenbank während der Zuordnung der ersten Umgebungskennung. Dieser Fehler wird zurückgegeben, wenn die vom CLI-Treiber aufgerufene API von IBM Global Security Toolkit (GSKit) einen Fehler zurückgibt.

Der Fehler kann aufgrund einer der folgenden Bedingungen zurückgegeben werden:

Eine der abhängigen GSKit-Bibliotheken fehlt.
Der CLI-Treiberprozess hat nicht die Berechtigung zum Erstellen der Keystore-Datenbank.
Die Platte ist voll.

Benutzeraktion

Stellen Sie sicher, dass die Bibliotheksdateien für die GSKit-Schlüsselverwaltung im Verzeichnis <installationspfad>/lib/icc vorhanden sind. Wenn die GSKit-Bibliotheksdateien fehlen, installieren Sie das Datenbankprodukt erneut oder installieren Sie das GSKit-Softwarepaket.
Stellen Sie sicher, dass die Benutzer-ID, unter der die CLI-Anwendung ausgeführt wird, über die Lese- und Schreibberechtigung für das Verzeichnis der Keystore-Datenbank verfügt.
Prüfen Sie die Datei db2diag.log auf Fehlercodes der GSKit-API. Fehlerdetails finden Sie in der GSKit-Dokumentation (IBM Global Security Toolkit).

CLI0251E Der Versuch, das SSL-Zertifikat zu speichern, ist fehlgeschlagen.

Erläuterung

Beim Versuch, eine SSL-Verbindung herzustellen, speichert der CLI-Treiber das SSL-Zertifikat, das als Wert von der vom Schlüsselwort SSLCertificate definierten Speicherposition übergeben wird, in der Keystore-Datenbank. Dieser Fehler wird zurückgegeben, wenn die vom CLI-Treiber aufgerufene API von IBM Global Security Toolkit (GSKit) einen Fehler zurückgibt.

Der Fehler kann aufgrund einer der folgenden Bedingungen zurückgegeben werden:

Das im Schlüsselwort SSLCertificate angegebene Zertifikat der Zertifizierungsstelle ist nicht vorhanden.
Der CLI-Treiber kann nicht auf das SSL-Zertifikat zugreifen.
Der CLI-Treiber kann die Keystore-Datenbank nicht öffnen.
Das SSL-Zertifikat hat ein falsches Format. Das SSL-Zertifikat besteht aus ASCII-Text, der zwischen dem Text BEGIN CERTIFICATE und END CERTIFICATE eingeschlossen ist.
Die Keystore-Datenbank oder ihre Tabellen sind beschädigt.
Die GSKit-API hat einen Speicherzuordnungsfehler festgestellt. Die Datei db2diag.log kann weitere Informationen zu dem von der GSKit-API zurückgegebenen Fehler enthalten.

Benutzeraktion

Stellen Sie sicher, dass für das Schlüsselwort SSLCertificate ein vollständig qualifizierter Pfad angegeben ist.
Stellen Sie sicher, dass die Keystore-Datenbank vorhanden ist und die Benutzer-ID, unter der die CLI-Anwendung ausgeführt wird, über die Lese- und Schreibberechtigung für das Verzeichnis der Keystore-Datenbank verfügt.
Stellen Sie sicher, dass das SSL-Zertifikat aus ASCII-Text besteht, der zwischen dem Text BEGIN CERTIFICATE und END CERTIFICATE eingeschlossen ist.
Starten Sie die Anwendung erneut, um die beschädigte Keystore-Datenbank oder beschädigte Keystore-Tabellen zu beheben.

CLI0646E Bibliothek `bibliotheksname` kann nicht gefunden werden.

Erläuterung

bibliotheksname kann im Bibliothekspfad nicht gefunden werden. Der Bibliothekspfad wird durch die Umgebungsvariable für die folgenden Betriebssysteme definiert:

AIX (Java 1.1): LD_LIBRARY_PATH
AIX (Java 1.2 oder höher): LIBPATH
HP-UX: SHLIB_PATH
Linux: LD_LIBRARY_PATH
Silicon Graphics IRIX: LD_LIBRARY_PATH
Solaris-Betriebsumgebung: LD_LIBRARY_PATH
Windows-Betriebssysteme: PATH

Benutzeraktion

CLI0652W Die Ausführung der Abfrage ist nicht atomar, da der Datenbankserver autarke Operationen für nicht einfügende Abfragen nicht unterstützt.

Erläuterung

Sie können das Anweisungsattribut SQL_ATTR_PARAMOPT_ATOMIC verwenden, um anzugeben, ob die Verarbeitung mehrerer Parametermarken in einer Operation (atomar) oder in mehreren Operationen (nicht atomar) erfolgen soll. Wenn Sie z. B. den Wert SQL_ATOMIC_YES angeben, hat dies zur Folge, dass die zugrunde liegende Verarbeitung der Abfrage als eine atomare Operation ausgeführt wird.

Diese Nachricht wird zurückgegeben, wenn alle der folgenden Bedingungen für eine angegebene Abfrage wahr sind:

Das Attribut SQL_ATTR_PARAMOPT_ATOMIC ist für die Abfrage auf SQL_ATOMIC_YES gesetzt.
Die Abfrage ist keine Einfügeoperation.
Die Abfrage wird für einen DB2 for z/OS-Datenbankserver ausgeführt, der die autarke Verarbeitung von nicht einfügenden Abfragen nicht unterstützt.

Benutzeraktion

Sie müssen nicht auf diese Warnung reagieren. Es gibt keine Möglichkeit, zu erzwingen, dass eine nicht einfügende Abfrage automatisch für einen DB2 for z/OS-Datenbankserver ausgeführt wird.