Db2 11.1

Allgemeine IBM Data Server Driver for JDBC and SQLJ -Eigenschaften für alle unterstützten Datenbankprodukte

Die meisten der IBM® Data Server Driver for JDBC and SQLJ -Eigenschaften gelten für alle Datenbankprodukte, die vom Treiber unterstützt werden.

Sofern nicht anders angegeben, befinden sich alle Eigenschaften in com.ibm.db2.jcc.DB2BaseDataSource .

Diese Eigenschaften sind:

affinityFailbackInterval

Gibt die Länge des Intervalls in Sekunden an, die der IBM Data Server Driver for JDBC and SQLJ zwischen Versuchen wartet, eine bestehende Verbindung zum primären Server zurückzuschlagen. Ein Wert, der kleiner-gleich 0 ist, bedeutet, dass die Verbindung nicht zurückschlägt. Der Standardwert ist DB2BaseDataSource.NOT_SET (0).

Versuche zum Zurückschlagen von Verbindungen zum primären Server werden an den Transaktionsgrenzen vorgenommen, nachdem das angegebene Intervall abgelaufen ist.

affinityFailbackInterval wird nur verwendet, wenn die Werte der Eigenschaften 'enableSeamlessFailover' und 'enableClientAffinitiesList' DB2BaseDataSource.YES (1) sind.

affinityFailbackInterval gilt nur für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity .

allowNextOnExhaustedResultSet

Gibt an, wie der IBM Data Server Driver for JDBC and SQLJ einen Aufruf ResultSet.next () für einen vorwärts-einzigen Cursor handhabt, der hinter der letzten Zeile von ResultSet positioniert ist. Der Datentyp dieser Eigenschaft ist 'int'.

Folgende Werte sind möglich:

DB2BaseDataSource.YES (1): Für ein ResultSet , das als TYPE_FORWARD_ONLY definiert ist, gibt ResultSet.next () den Wert false zurück, wenn der Cursor zuvor hinter der letzten Zeile von ResultSet positioniert wurde. ResultSet.next () gibt false zurück, unabhängig davon, ob der Cursor geöffnet oder geschlossen ist.
DB2BaseDataSource.NO (2): Für ein ResultSet , das als TYPE_FORWARD_ONLY definiert ist, wenn ResultSet.next () aufgerufen wird und der Cursor zuvor hinter der letzten Zeile von ResultSet positioniert wurde, löst der Treiber eine java.sql.SQLException mit dem Fehlertext "Invalid operation: result set is closed."Dieser Wert ist der Standardwert.

allowNullResultSetForExecuteQuery

Gibt an, ob der IBM Data Server Driver for JDBC and SQLJ null zurückgibt, wenn Statement.executeQuery , PreparedStatement.executeQuery oder CallableStatement.executeQuery verwendet wird, um eine CALL-Anweisung für eine gespeicherte Prozedur auszuführen, die keine Ergebnismengen zurückgibt.

Folgende Werte sind möglich:

DB2BaseDataSource.NOT_SET (0): Das Verhalten entspricht dem Verhalten von DB2BaseDataSource.NO.
DB2BaseDataSource.YES (1): Der IBM Data Server Driver for JDBC and SQLJ gibt null zurück, wenn Statement.executeQuery , PreparedStatement.executeQuery oder CallableStatement.executeQuery verwendet wird, um eine Anweisung CALL für eine gespeicherte Prozedur auszuführen, die keine Ergebnismengen zurückgibt. Dieses Verhalten entspricht nicht dem JDBC-Standard.
DB2BaseDataSource.NO (2): Der IBM Data Server Driver for JDBC and SQLJ löst eine SQLException aus, wenn Statement.executeQuery , PreparedStatement.executeQuery oder CallableStatement.executeQuery verwendet wird, um eine Anweisung CALL für eine gespeicherte Prozedur auszuführen, die keine Ergebnismengen zurückgibt. Dieses Verhalten entspricht dem JDBC-Standard.

atomicMultiRowInsert

Gibt an, ob Stapelverarbeitungsoperationen, die PreparedStatement -Methoden zum Ändern einer Tabelle verwenden, atomar oder nicht atomar sind. Der Datentyp dieser Eigenschaft ist 'int'.

Für Verbindungen zu Db2 for z/OS gilt diese Eigenschaft nur für Operationen im Stapelbetrieb INSERT.

Für Verbindungen zu Db2 auf Linux-, UNIX-und Windows-Systemen oder IBM Informix gilt diese Eigenschaft für die Stapel-INSERT-, MERGE-, UPDATE-oder DELETE-Operationen.

Folgende Werte sind möglich:

DB2BaseDataSource.YES (1)

Stapeloperationen sind atomar. Das Einfügen aller Zeilen in den Stapel wird als einzelne Operation betrachtet. Wenn die Einfügung einer einzelnen Zeile fehlschlägt, schlägt die gesamte Operation mit einer BatchUpdateException fehl. Die Verwendung einer Stapelanweisung, die automatisch generierte Schlüssel zurückgibt, schlägt mit einer BatchUpdateException fehl.

Wenn atomicMultiRowInsert auf DB2BaseDataSource.YES (1) gesetzt ist:

Wenn es sich bei der Zieldatenquelle um Db2 for z/OS handelt, sind die folgenden Operationen nicht zulässig:
- Die Einfügung von mehr als 32767 Zeilen in einem Stapel führt zu einer BatchUpdateException .
- Das Aufruf von mehr als einer der folgenden Methoden für denselben Parameter in verschiedenen Zeilen führt zu einer BatchUpdateException :
  - PreparedStatement.setAsciiStream
  - PreparedStatement.setCharacterStream
  - PreparedStatement.setUnicodeStream

DB2BaseDataSource.NO (2)

Stapeleinfügungen sind nicht atomar. Die Einfügung jeder Zeile wird als separate Ausführung betrachtet. Informationen über den Erfolg jeder Einfügeoperation werden vom int[] Array bereitgestellt, das von Statement.executeBatch zurückgegeben wird.

DB2BaseDataSource.NOT_SET (0)

Automatischcommit

Legt den Standardwert für die automatische Festschreibung für eine Verbindung oder eine DataSource-Instanz fest. Alle Verbindungen, die von einer Datenquelle (DataSource) abgeleitet werden, übernehmen die Eigenschaft "autocommit", die in der Datenquelle festgelegt ist.

blockingReadConnectionTimeout

Die Zeit in Sekunden, in der ein Verbindungssocket das Zeitlimit für das Lesen der Verbindung auslesen kann. Diese Eigenschaft gilt nur für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity und wirkt sich auf alle Anforderungen aus, die an die Datenquelle gesendet werden, nachdem eine Verbindung erfolgreich hergestellt wurde. Der Standardwert ist 0. Der Wert 0 bedeutet, dass es kein Zeitlimit gibt.

clientBidistringType

Wird verwendet, wenn enableBidiLayoutTransformation aktiviert ist. Gibt den Zeichenfolgetyp an, der von der Clientanwendung verwendet wird. Die gültigen Werte für die Eigenschaft und ihre entsprechenden Textattribute sind in der folgenden Tabelle angegeben:

Tabelle 1. Zeichenfolgetypwerte und entsprechende Attribute für die Eigenschaften 'clientBidiStringType' und 'serverBidiStringType'
		Textattribute
Ganzzahlige Zeichenfolge für ganzzahlige Konstante	Zeichenfolgetypwert	Typ des Texts	Orientierung	Symmetrische Auslagerung	Numeralform	Textformen
4	`DB2BaseDataSource.BIDI_ST4`	Visuell	Links-nach-rechts	Nein	Nominale	Geformt
5	`DB2BaseDataSource.BIDI_ST5`	Implizit	Links-nach-rechts	Ja	Nominale	Nominale
6	`DB2BaseDataSource.BIDI_ST6`	Implizit	Von rechts nach links	Ja	Nominale	Nominale
7	`DB2BaseDataSource.BIDI_ST7`	Visuell	Von rechts nach links	Nein	Nominale	Geformt
8	`DB2BaseDataSource.BIDI_ST8`	Visuell	Von rechts nach links	Nein	Nominale	Geformt
9	`DB2BaseDataSource.BIDI_ST9`	Implizit	Von rechts nach links	Ja	Nominale	Geformt
10	`DB2BaseDataSource.BIDI_ST10`	Implizit	Kontextuelles Linksrechts	Ja	Nominale	Nominale
11	`DB2BaseDataSource.BIDI_ST11`	Implizit	Kontextuelles Rechtes links-links	Ja	Nominale	Nominale

clientDebugInfo

Gibt einen Wert für das Verbindungsattribut CLIENT DEBUGINFO an, um den Datenserver darüber zu benachrichtigen, dass gespeicherte Prozeduren und benutzerdefinierte Funktionen, die die Verbindung verwenden, im Debugmodus ausgeführt werden. CLIENT DEBUGINFO wird von Db2 Unified Debugger verwendet. Der Datentyp dieser Eigenschaft ist 'String'. Die maximale Länge beträgt 254 Byte.

Diese Eigenschaft gilt nur für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity .

clientRerouteAlternateServerName

Gibt einen oder mehrere Servernamen für die Clientweiterleitung an. Der Datentyp dieser Eigenschaft ist 'String'.

Wenn enableClientAffinitiesList=DB2BaseDataSource.YES (1) verwendet wird, muss clientRerouteAlternateServerName den Namen des primären Servers sowie alternative Servernamen enthalten. Der Server, der durch serverName und portNumber identifiziert wird, ist der primäre Server. Dieser Servername muss am Anfang der Liste "clientRerouteAlternateServerName" angezeigt werden.

Wenn mehr als ein Servername angegeben ist, begrenzen Sie die Servernamen mit Kommas (,) oder Leerzeichen. Die Anzahl der Werte, die für 'clientRerouteAlternateServerName' angegeben wird, muss mit der Anzahl der Werte übereinstimmen, die für 'clientRerouteAlternatePortNumber' angegeben ist.

clientRerouteAlternateServerName gilt für IBM Data Server Driver for JDBC and SQLJ type 2 connectivity für Db2 auf Linux-, UNIX-und Windows-Systemen und IBM Data Server Driver for JDBC and SQLJ type 4 connectivity .

clientRerouteAlternatePortNumber

Gibt eine oder mehrere Anschlussnummern für die Clientweiterleitung an. Der Datentyp dieser Eigenschaft ist 'String'.

Wenn enableClientAffinitiesList=DB2BaseDataSource.YES (1) verwendet wird, muss clientRerouteAlternatePortNumber die Portnummer für den primären Server sowie die Port-Nummern für alternative Server enthalten. Der Server, der durch serverName und portNumber identifiziert wird, ist der primäre Server. Diese Portnummer muss am Anfang der Liste "clientRerouteAlternatePortNumber" angezeigt werden.

Wenn mehr als eine Portnummer angegeben ist, begrenzen Sie die Portnummern mit Kommas (,) oder Leerzeichen. Die Anzahl der Werte, die für 'clientRerouteAlternatePortNumber' angegeben ist, muss mit der Anzahl der Werte übereinstimmen, die für 'clientRerouteAlternateServerName' angegeben ist.

clientRerouteAlternatePortNumber gilt für IBM Data Server Driver for JDBC and SQLJ type 2 connectivity für Db2 auf Linux-, UNIX-und Windows-Systemen und IBM Data Server Driver for JDBC and SQLJ type 4 connectivity .

clientRerouteServerListJNDIName

Bezeichnet eine JNDI-Referenz auf eine DB2ClientRerouteServerList -Instanz in einem JNDI-Repository, in dem Serverinformationen erneut weitergeleitet werden. clientRerouteServerListJNDIName gilt nur für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity und für Verbindungen, die über die Schnittstelle DataSource hergestellt werden.

Wenn der Wert von clientRerouteServerListJNDIName nicht null ist, stellt clientRerouteServerListJNDIName die folgenden Funktionen bereit:

Lässt Informationen über die Weiterleitung von Servern über JVMs hinweg zu
Stellt eine alternative Serverposition bereit, wenn die erste Verbindung zur Datenquelle fehlschlägt.

clientRerouteServerListJNDIContext

Gibt den JNDI-Kontext an, der für die Bindung und Suche der Instanz DB2ClientRerouteouteServerList verwendet wird. clientRerouteServerListJNDIContext gilt nur für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity und für Verbindungen, die über die Schnittstelle DataSource hergestellt werden.

Wenn clientRerouteServerListJNDIContext nicht definiert ist, erstellt der IBM Data Server Driver for JDBC and SQLJ einen Ausgangskontext mithilfe der Systemeigenschaften oder der Datei "jndi.properties".

clientRerouteServerListJNDIContext kann nur mit der folgenden Methode festgelegt werden:

public void setClientRerouteServerListJNDIContext(javax.naming.Context registry)

Befehlszeitlimit

Gibt die maximale Zeit in Sekunden an, die eine Anwendung, die unter IBM Data Server Driver for JDBC and SQLJ ausgeführt wird, wartet, bis SQL-Operationen ausgeführt werden, bevor der Treiber eine SQLException auslöst. Die Wartezeit umfasst die Zeit, um einen Transport zu erhalten, bei Bedarf eine Funktionsübernahme durchzuführen, die Anforderung zu senden und auf eine Antwort zu warten. Der Datentyp dieses Parameters ist 'int'. Der Standardwert ist 0, was bedeutet, dass es kein Zeitlimit gibt.

Wenn die Methode java.sql.Statement.setQueryTimeout aufgerufen wird, überschreibt der durch Statement.setQueryTimeout festgelegte Wert für die Abfragezeitlimitüberschreitung den Wert des Befehls "commandTimeout".

commandTimeout gilt für die Ausführung der Methoden Anweisung , PreparedStatement und CallableStatement execute , executeQuery und executeUpdate . commandTimeout gilt auch für die Methode executeBatch , wenn die Eigenschaft 'queryTimeoutInterruptProcessingMode' den Wert INTERRUPT_PROCESSING_MODE_CLOSE_SOCKET (2) hat.

Der SQL-Fehlercode, der mit der SQLException zurückgegeben wird, hängt vom Datenserver und dem Wert der Eigenschaft queryTimeoutInterruptProcessingMode ab:

Für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity in Bezug auf Db2 for z/OS-Datenserver lautet der Wert für 'queryTimeoutInterruptProcessingMode' immer INTERRUPT_PROCESSING_MODE_CLOSE_SOCKET (2).
- Ist der Sysplex-Lastausgleich aktiviert, wird der SQL-Fehlercode '-30108' zurückgegeben.
- Ist die automatische Clientweiterleitung aktiviert und der Sysplex-Lastausgleich inaktiviert, wird der SQL-Fehlercode '-4498' zurückgegeben.
- Ist weder der Sysplex-Lastausgleich noch die automatische Clientweiterleitung aktiviert, wird der SQL-Fehlercode '-4499' zurückgegeben.
Die automatische Clientweiterleitungsverarbeitung wird nicht eingeleitet, wenn der Wert des Befehls 'commandTimeout' überschritten wird.
Für Verbindungen zu anderen Datenservern:
- Wenn der Wert für 'queryTimeoutInterruptProcessingMode' INTERRUPT_PROCESSING_MODE_STATEMENT_CANCEL (1) ist, wird -952 zurückgegeben.
- Lautet der Wert für 'queryTimeoutInterruptProcessingMode' INTERRUPT_PROCESSING_MODE_CLOSE_SOCKET (2), gilt Folgendes:
  - Ist der Db2-Lastausgleich aktiviert, wird der SQL-Fehlercode '-30108' zurückgegeben.
  - Ist die Verarbeitung der automatischen Clientweiterleitung aktiviert und der Db2-Lastausgleich inaktiviert, wird der SQL-Fehlercode '-4498' zurückgegeben.
  - Ist weder die Verarbeitung der automatischen Clientweiterleitung noch der Db2-Lastausgleich aktiviert, wird der SQL-Fehlercode '-4498' zurückgegeben.

Wenn die Konfigurationseigenschaft 'db2.jcc.enableInetAddressGetHostName' auf true gesetzt ist, können die folgenden Situationen eintreten:

Tatsächliche Wartezeiten können den Wert des Befehls 'commandTimeout' überschreiten. Diese Situation kann auftreten, wenn der Treiber mehrere DNS-Suchoperationen ausführen muss, um IP-Adressen in Hostnamen aufzulösen. Der Betrag, um den die Wartezeit den Wert für 'commandTimeout' überschreitet, hängt von der Anzahl der DNS-Suchoperationen und der Zeit ab, die die einzelnen DNS-Suchoperationen benötigt.
Die zusätzliche Zeit, die für DNS-Suchoperationen erforderlich ist, kann zu mehr Zeitlimitbedingungen führen, als wenn db2.jcc.enableInetAddressGetHostName auf false gesetzt ist.

connectionCloseWithInFlightTransaction

Gibt an, ob der IBM Data Server Driver for JDBC and SQLJ eine SQLException auslöst oder eine Transaktion rückgängig macht, ohne eine SQLException zu werfen, wenn eine Verbindung in der Mitte der Transaktion geschlossen wird. Folgende Werte sind möglich:

DB2BaseDataSource.NOT_SET (0): Das Verhalten ist mit dem Verhalten von DB2BaseDataSource.CONNECTION_CLOSE_WITH_EXCEPTION. identisch.
DB2BaseDataSource.CONNECTION_CLOSE_WITH_EXCEPTION (1): Wenn eine Verbindung in der Mitte einer Transaktion geschlossen wird, wird eine SQLException -Ausnahmebedingung mit dem Fehler -4471 ausgelöst.
DB2BaseDataSource.CONNECTION_CLOSE_WITH_ROLLBACK (2): Wenn eine Verbindung in der Mitte einer Transaktion geschlossen wird, wird die Transaktion rückgängig gemacht, und es wird keine SQLException ausgelöst.
DB2BaseDataSource.CONNECTION_CLOSE_WITH_COMMIT (3): Wenn eine Verbindung in der Mitte einer Transaktion geschlossen wird, wird die Transaktion festgeschrieben, und es wird keine SQLException ausgelöst. Verwenden Sie diese Option nur bei der Migration von Anwendungen in Db2.

Verbindungszeitlimit

Gibt die maximale Zeit in Sekunden an, die der IBM Data Server Driver for JDBC and SQLJ auf eine Antwort von einer Gruppe von Datenservern wartet, wenn der Treiber versucht, eine Verbindung herzustellen. Wenn der Treiber keine Antwort erhält, nachdem der durch "connectionTimeout" angegebene Zeitraum angegeben wurde, löst der Treiber eine SQLException mit dem SQL-Fehlercode -4499 aus. Der Datentyp dieses Parameters ist 'int'. Der Standardwert ist 0.

Wenn 'connectionTimeout' auf einen positiven Wert gesetzt ist, überschreibt dieser Wert alle anderen Zeitlimitwerte, die für eine Verbindung festgelegt sind, z. B. loginTimeout. Es wird versucht, eine Verbindung zum Member der Gruppe von Datenservern mit der größten Ladekapazität zu versuchen. Wenn keine der Member vorhanden ist, wird versucht, eine Verbindung zu der IP-Gruppenadresse zu erstellen, die in der DataSource angegeben ist. Wenn die Verbindung nicht mit einem der Datenserver innerhalb der durch 'connectionTimeout' angegebenen Zeit hergestellt werden kann, wird eine SQLException ausgelöst.

Wenn 'connectionTimeout' auf 0 gesetzt ist und die automatische Clientweiterleitung nicht aktiviert ist, gibt es keine zeitliche Begrenzung.

Wenn 'connectionTimeout' auf 0 gesetzt ist und die automatische Clientweiterleitung für eine Db2 for z/OS-Gruppe mit gemeinsamer Datennutzung, einen Db2 pureScale instanz oder einen IBM Informix -Hochverfügbarkeitscluster aktiviert ist, steuern die automatischen Clientweiterleitungseigenschaften wie z. B. maxRetriesForClientReroute und retryIntervalForClientReroute die Zeit, die ist zum Herstellen der Verbindung erforderlich.

Wenn die Konfigurationseigenschaft 'db2.jcc.enableInetAddressGetHostName' auf true gesetzt ist, können die folgenden Situationen eintreten:

Tatsächliche Wartezeiten können den Wert für "connectionTimeout" überschreiten. Diese Situation kann auftreten, wenn der Treiber mehrere DNS-Suchoperationen ausführen muss, um IP-Adressen in Hostnamen aufzulösen. Der Betrag, um den die Wartezeit den Wert für "connectionTimeout" überschreitet, hängt von der Anzahl der DNS-Suchoperationen und der Zeit ab, die jede DNS-Suchoperation benötigt.
Die zusätzliche Zeit, die für DNS-Suchoperationen erforderlich ist, kann zu mehr Zeitlimitbedingungen führen, als wenn db2.jcc.enableInetAddressGetHostName auf false gesetzt ist.

databaseName

Gibt den Namen für die Datenquelle an. Dieser Name wird als Teil der Datenbank der Verbindungs-URL verwendet. Der Name hängt davon ab, ob IBM Data Server Driver for JDBC and SQLJ type 4 connectivity oder IBM Data Server Driver for JDBC and SQLJ type 2 connectivity verwendet wird.

Für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity :

Wenn die Verbindung zu einem Db2 for z/OS -Server besteht, ist der Wert für databaseName der Name des Db2-Standorts, der während der Installation definiert wird. Alle Zeichen in diesem Wert müssen Großbuchstaben sein. Sie können den Standortnamen ermitteln, indem Sie die folgende SQL-Anweisung auf dem Server ausführen:
```
SELECT CURRENT SERVER FROM SYSIBM.SYSDUMMY1;
```
Wenn die Verbindung zu einem Db2 auf Linux-, UNIX-und Windows-Systemen -Server besteht, ist der Wert für databaseName der Datenbankname, der während der Installation definiert wird.
Wenn die Verbindung zu einem IBM Informix -Server besteht, ist database der Datenbankname. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. Der Server konvertiert den Namen in Kleinbuchstaben.
Wenn die Verbindung zu einem IBM Cloudscape-Server besteht, ist der Wert für databaseName der vollständig qualifizierte Name der Datei, die die Datenbank enthält. Dieser Name muss in doppelte Anführungszeichen (") eingeschlossen werden. Zum Beispiel:
```
"c:/databases/testdb"
```

Wenn diese Eigenschaft nicht festgelegt ist, werden Verbindungen zum lokalen Standort hergestellt.

Für IBM Data Server Driver for JDBC and SQLJ type 2 connectivity :

Der Wert für databaseName ist der Datenbankname, der während der Installation definiert wird, wenn der Wert der Verbindungseigenschaft serverName null ist. Wenn der Wert der Eigenschaft "serverName" nicht null ist, ist der Wert "databaseName" ein Datenbankaliasname.

decimalSeparator

Gibt das Dezimaltrennzeichen für Eingabe und Ausgabe für Dezimal-, Gleitkomma-oder dezimale Gleitkomma-Datenwerte an. Der Datentyp dieser Eigenschaft ist 'int'.

Wenn der Wert der Eigenschaft sendDataAsIs auf true gesetzt ist, wirkt sich decimalSeparator nur auf die Ausgabewerte aus.

Folgende Werte sind möglich:

DB2BaseDataSource.DECIMAL_SEPARATOR_NOT_SET (0): Ein Punkt wird als Dezimaltrennzeichen verwendet. Dieser Wert ist der Standardwert.
DB2BaseDataSource.DECIMAL_SEPARATOR_PERIOD (1): Ein Punkt wird als Dezimaltrennzeichen verwendet.
DB2BaseDataSource.DECIMAL_SEPARATOR_COMMA (2): Als Dezimaltrennzeichen wird ein Komma verwendet.
Wenn DECIMAL_SEPARATOR_COMMA gesetzt ist, hat das Ergebnis von ResultSet.getString auf einem dezimal-, Gleitkomma-oder dezimalen Gleitkommawert ein Komma als Trennzeichen. Wenn die Methode toString jedoch für einen Wert ausgeführt wird, der mit einer ResultSet.getXXX -Methode abgerufen wird, die einen dezimalen Gleitkommawert oder einen dezimalen Gleitkommawert zurückgibt, hat das Ergebnis ein Dezimalzeichen als Dezimaltrennzeichen.

decimalStringFormat

Gibt das Zeichenfolgeformat für Daten an, die aus einer DECIMAL-oder DECFLOAT-Spalte abgerufen werden, wenn das SDK für Java™ Version 1.5 oder höher ist. Der Datentyp dieser Eigenschaft ist 'int'. Folgende Werte sind möglich:

DB2BaseDataSource.DECIMAL_STRING_FORMAT_NOT_SET (0): Der IBM Data Server Driver for JDBC and SQLJ gibt Dezimalwerte in dem Format zurück, das von der Methode java.math.BigDecimal.toString zurückgegeben wird. Dieser Wert ist der Standardwert.
Der Wert 0,0000000004 wird z. B. als 4E-10 zurückgegeben.
DB2BaseDataSource.DECIMAL_STRING_FORMAT_TO_STRING (1): Der IBM Data Server Driver for JDBC and SQLJ gibt Dezimalwerte in dem Format zurück, das von der Methode java.math.BigDecimal.toString zurückgegeben wird.
Der Wert 0,0000000004 wird z. B. als 4E-10 zurückgegeben.
DB2BaseDataSource.DECIMAL_STRING_FORMAT_TO_PLAIN_STRING (2): Der IBM Data Server Driver for JDBC and SQLJ gibt Dezimalwerte in dem Format zurück, das von der Methode java.math.BigDecimal.toPlainString zurückgegeben wird.
Beispiel: Der Wert 0,0000000004 wird als 0.0000000004 zurückgegeben.

Diese Eigenschaft hat keine Auswirkungen auf frühere Versionen des SDK für Java. Für diese Versionen gibt der IBM Data Server Driver for JDBC and SQLJ Dezimalwerte in dem Format zurück, das von der Methode java.math.BigDecimal.toString zurückgegeben wird.

defaultIsolationLevel

Gibt die Standardisolationsstufe der Transaktion für neue Verbindungen an. Der Datentyp dieser Eigenschaft ist 'int'. Wenn 'defaultIsolationLevel' auf einer Datenquelle festgelegt ist, haben alle Verbindungen, die aus dieser Datenquelle erstellt werden, die Standardisolationsstufe, die durch defaultIsolationLevel angegeben wird.

Bei Db2-Datenquellen ist der Standardwert java.sql.Connection.TRANSACTION_READ_COMMITTED.

Bei IBM Informix -Datenbanken ist der Standardwert von der Art der Datenquelle abhängig. In der folgenden Tabelle sind die Standardwerte aufgeführt.

Tabelle 2. Standardisolationsstufen für IBM Informix -Datenbanken
Typ der Datenquelle	Standardisolationsstufe
ANSI-kompatible Datenbank mit Protokollierung	java.sql.Connection.TRANSACTION_SERIALIZABLE
Datenbank ohne Protokollierung	java.sql.Connection.TRANSACTION_READ_UNCOMMITTED
Nicht-ANSI-kompatible Datenbank mit Protokollierung	java.sql.Connection.TRANSACTION_READ_COMMITTED

deferPrepares

Gibt an, ob der Aufruf der Methode Connection.prepareStatement die sofortige Vorbereitung einer SQL-Anweisung in der Datenquelle zur Folge hat oder ob die Anweisungsvorbereitung verzögert wird, bis die Methode PreparedStatement.execute ausgeführt wird. Der Datentyp dieser Eigenschaft ist boolesch.

deferPrepares wird für IBM Data Server Driver for JDBC and SQLJ type 2 connectivity für Db2 auf Linux-, UNIX-und Windows-Systemen und für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity unterstützt.

Folgende Werte sind möglich:

wahr: Die Anweisungsvorbereitung für die Datenquelle findet erst statt, wenn die Methode PreparedStatement.execute ausgeführt wird. Dieser Wert ist der Standardwert.
False: Die Anweisungsvorbereitung für die Datenquelle tritt auf, wenn die Methode Connection.prepareStatement ausgeführt wird.

Deferring-Operationen können die Verzögerungen im Netz reduzieren. Wenn Sie jedoch die Vorbereitung von Operationen verzögern, müssen Sie sicherstellen, dass Eingabedatentypen mit Tabellenspaltentypen übereinstimmen.

Beschreibung

Eine Beschreibung der Datenquelle. Der Datentyp dieser Eigenschaft ist 'String'.

downgradeHoldCursorsUnderXa

Gibt an, ob Cursor, die mit WITH HOLD definiert sind, unter XA-Verbindungen geöffnet werden können.

downgradeHoldCursorsUnderXa gilt für:

IBM Data Server Driver for JDBC and SQLJ type 4 connectivity auf Db2 for z/OS-Server.
IBM Data Server Driver for JDBC and SQLJ type 4 connectivity oder IBM Data Server Driver for JDBC and SQLJ type 2 connectivity zu Db2 auf Linux-, UNIX-und Windows-Systemen -Servern.

Der Standardwert ist false . Dies bedeutet, dass ein Cursor, der mit WITH HOLD definiert ist, unter einer XA-Verbindung nicht geöffnet werden kann. Es wird eine Ausnahmebedingung ausgelöst, wenn versucht wird, diesen Cursor zu öffnen.

Wenn 'downgradeHoldCursorsUnderXa' auf true gesetzt ist, kann ein Cursor, der mit WITH HOLD definiert ist, unter einer XA-Verbindung geöffnet werden. Der Cursor hat jedoch die folgenden Einschränkungen:

Wenn der Cursor unter einer XA-Verbindung geöffnet wird, weist der Cursor nicht das Verhalten WITH HOLD auf. Der Cursor wird beim XA-Ende geschlossen.
Ein Cursor, der vor dem XA-Start in einer lokalen Transaktion geöffnet ist, wird bei XA Start geschlossen.

Treibertyp

Legt für die Schnittstelle DataSource fest, welcher Treiber für Verbindungen verwendet werden soll. Der Datentyp dieser Eigenschaft ist 'int'. Gültige Werte sind 2 oder 4. 2 ist der Standardwert.

enableClientAffinitiesList

Gibt an, ob der IBM Data Server Driver for JDBC and SQLJ Clientaffinitäten für die kaskadierte Übernahmeunterstützung aktiviert. Der Datentyp dieser Eigenschaft ist 'int'. Folgende Werte sind möglich:

DB2BaseDataSource.YES (1)

Der IBM Data Server Driver for JDBC and SQLJ aktiviert die Clientaffinitäten für die kaskadierte Übernahmeunterstützung. Aus diesem Grund werden nur Server, die in den Eigenschaften clientRerouteAlternateServerName und clientRerouteAlternatePortNumber angegeben sind, erneut versucht. Der Treiber versucht nicht, eine Verbindung zu einem anderen Server herzustellen.

Nehmen Sie beispielsweise an, dass clientRerouteAlternateServerName die folgende Zeichenfolge enthält:

host1,host2,host3

Nehmen Sie außerdem an, dass clientRerouteAlternatePortNumber die folgende Zeichenfolge enthält:

Port1,port2,port3

Wenn Clientaffinitäten aktiviert sind, lautet der Wiederholungsbefehl:

Host1 :Port1
Host2 :Port2
Host3 :Port3

DB2BaseDataSource.NO (2)

Der IBM Data Server Driver for JDBC and SQLJ aktiviert keine Clientaffinitäten für die kaskadierte Übernahmeunterstützung.

DB2BaseDataSource.NOT_SET (0)

Der IBM Data Server Driver for JDBC and SQLJ aktiviert keine Clientaffinitäten für die kaskadierte Übernahmeunterstützung. Dieser Wert ist der Standardwert.

Die Auswirkung der Eigenschaften "maxRetriesForClientReroute" und "retryIntervalForClientReroute" hängt davon ab, ob enableClientAffinitiesList aktiviert ist.

Diese Eigenschaft gilt nur für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity .

enableNamedParameterMarkers

Gibt an, ob die Unterstützung für benannte Parametermarken in der IBM Data Server Driver for JDBC and SQLJ aktiviert ist. Der Datentyp dieser Eigenschaft ist 'int'. Folgende Werte sind möglich:

DB2BaseDataSource.YES (1)

Die Markierungs-Unterstützung für benannte Parameter ist in der IBM Data Server Driver for JDBC and SQLJ aktiviert.

DB2BaseDataSource.NO (2)

Named-Parametermarkerunterstützung ist in IBM Data Server Driver for JDBC and SQLJ nicht aktiviert.

Der Treiber sendet eine SQL-Anweisung ohne Änderung an die Zieldatenquelle mit benannten Parametermarken. Der Erfolg oder Misserfolg der Anweisung hängt von einer Reihe von Faktoren ab, einschließlich der folgenden Faktoren:

Gibt an, ob die Zieldatenquelle benannte Parametermarken unterstützt.
Gibt an, ob der Wert der Eigenschaft "deferPrepares" true oder false lautet.
Gibt an, ob der Wert der Eigenschaft 'sendDataAsIs' auf true oder false gesetzt ist.

Empfehlung: Um ein unerwartetes Verhalten in einer Anwendung zu vermeiden, die benannte Parametermarken verwendet, setzen Sie "enableNamedParameterMarkers" auf YES.

DB2BaseDataSource.NOT_SET (0)

Das Verhalten ist mit dem Verhalten von DB2BaseDataSource.NO (2) identisch. Dieser Wert ist der Standardwert.

enableBidiLayoutTransformation

Gibt an, ob der Treiber eine bidirektionale (bidirektionale) Layoutumsetzung für SQL-Anweisungen, Eingabeparameter oder Daten ausführen muss, die von der Datenbank empfangen wurden. Der Datentyp dieser Eigenschaft ist boolesch, und der Standardwert ist false .

enableSeamlessFailover

Gibt an, ob der IBM Data Server Driver for JDBC and SQLJ nahtlose Funktionsübernahme für Clientweiterleitung verwendet. Der Datentyp dieser Eigenschaft ist 'int'.

Für Verbindungen zu Db2 for z/OS, wenn enableSysplexWLB auf true gesetzt ist, hat enableSeamlessFailover keine Auswirkungen. Der IBM Data Server Driver for JDBC and SQLJ verwendet eine nahtlose Funktionsübernahme unabhängig von der Einstellung 'enableSeamlessFailover'.

Mögliche Werte für enableSeamlessFailover:

DB2BaseDataSource.YES (1)

Der IBM Data Server Driver for JDBC and SQLJ verwendet eine nahtlose Funktionsübernahme. Daher löst der Treiber keine SQLException mit dem SQL-Fehlercode -4498 aus, nachdem eine fehlgeschlagene Verbindung erneut hergestellt wurde, wenn die folgenden Bedingungen zutreffen:

Die Verbindung wurde nicht für eine Transaktion zum Zeitpunkt der fehlgeschlaerfolgten Transaktion verwendet.
Es sind keine ausstehenden globalen Ressourcen vorhanden, wie z. B. globale temporäre Tabellen oder offene, gehaltene Cursor oder Verbindungsstatus, die eine nahtlose Funktionsübernahme durch einen anderen Server verhindern.

Wenn die nahtlose Funktionsübernahme erfolgt, nachdem die Verbindung zu einer neuen Datenquelle hergestellt wurde, gibt der Treiber die SQL-Anweisung erneut aus, die gerade verarbeitet wurde, als die ursprüngliche Verbindung fehlgeschlagen ist.

Empfehlung: Setzen Sie die Eigenschaft 'queryCloseImplicit' auf DB2BaseDataSource.QUERY_CLOSE_IMPLICIT_NO (2), wenn Sie enableSeamlessFailover auf DB2BaseDataSource.YES setzen, wenn die Anwendung die gehaltenen Cursor verwendet.

DB2BaseDataSource.NO (2)

Der IBM Data Server Driver for JDBC and SQLJ verwendet keine nahtlose Funktionsübernahme.

Wenn diese Einstellung wirksam ist, versucht der Treiber, wenn ein Server inaktiv ist, die Zurücksetzung oder das Fehlschlagen eines Servers auf einem anderen Server zu versuchen. Wenn Failover oder Failback erfolgreich ist, löst der Treiber eine SQLException mit dem SQL-Fehlercode -4498 aus, der angibt, dass eine Verbindung fehlgeschlagen ist, aber erfolgreich hergestellt wurde. Eine SQL-Ausnahmebedingung mit dem SQL-Fehlercode -4498 informiert die Anwendung darüber, dass sie die Transaktion wiederholen muss, während der der Verbindungsfehler aufgetreten ist. Wenn der Treiber keine Verbindung erneut herstellen kann, löst er eine SQLException mit dem SQL-Fehlercode -4499 aus.

DB2BaseDataSource.NOT_SET (0)

Der IBM Data Server Driver for JDBC and SQLJ verwendet keine nahtlose Funktionsübernahme. Dieser Wert ist der Standardwert.

enableSysplexWLB

Gibt an, ob die Sysplex-Lastausgleichsfunktion von IBM Data Server Driver for JDBC and SQLJ aktiviert ist. Der Datentyp von enableSysplexWLB ist boolesch. Der Standardwert ist false .

Wenn Sie nicht über eine Db2 auf Linux-, UNIX-und Windows-Systemen pureScale-Datenbank verfügen, setzen Sie enableSysplexWLB auf false .

enableSysplexWLB gilt nur für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity .

fetchSize

Gibt die Standardabrufgröße für ResultSet -Objekte an, die aus Statement -Objekten generiert werden. Der Datentyp dieser Eigenschaft ist 'int'.

Der Standardwert für 'fetchSize' kann durch die Methode Statement.setFetchSize überschrieben werden. Die Eigenschaft "fetchSize" hat keine Auswirkungen auf Statement -Objekte, die vorhanden sind, wenn fetchSize festgelegt wird.

Mögliche Werte für fetchSize sind:

0 oder positive-integer: Der Standardwert für fetchSize für neu erstellte Statement -Objekte. Wenn der Wert der Eigenschaft "fetchSize" ungültig ist, setzt der IBM Data Server Driver for JDBC and SQLJ den Standardwert für fetchSize auf 0.
DB2BaseDataSource.FETCHSIZE_NOT_SET (-1): Gibt an, dass der Standardwert für fetchSize für Statement -Objekte 0 ist. Dieser Wert ist der Standardwert für die Eigenschaft.

Die Eigenschaft 'fetchSize' unterscheidet sich von der Eigenschaft 'queryDataSize'. fetchSize wirkt sich auf die Anzahl der zurückgegebenen Zeilen aus, und queryDataSize beeinflusst die Anzahl der Byte, die zurückgegeben werden.

fullyMaterializeLobData

Gibt an, ob der Treiber LOB-Querverweisoperationen für FETCH-Operationen abruft. Der Datentyp dieser Eigenschaft ist boolesch.

Der Effekt von fullyMaterializeLobData hängt davon ab, ob die Datenquelle progressives Streaming unterstützt, das auch als dynamisches Datenformat bezeichnet wird:

Wenn die Datenquelle progressives Streaming nicht unterstützt:
Wenn der Wert von fullyMaterializeLobData true lautet, werden LOB-Daten innerhalb des JDBC-Treibers vollständig materialisiert, wenn eine Zeile abgerufen wird. Wenn der Wert false lautet, werden LOB-Daten gestreamt. Der Treiber verwendet Locators intern, um LOB-Daten nach Bedarf in Chunks abzurufen. Es wird dringend empfohlen, diesen Wert auf false zu setzen, wenn LOBs abgerufen werden, die große Datenmengen enthalten. Der Standardwert ist true .
Wenn die Datenquelle progressives Streaming unterstützt:
Der JDBC-Treiber ignoriert den Wert von fullyMaterializeLobData, wenn die Eigenschaft "progressiveStreaming" auf DB2BaseDataSource.YES oder DB2BaseDataSource.NOT_SET gesetzt ist.

Diese Eigenschaft hat keine Auswirkungen auf gespeicherte Prozedurparameter oder auf LOBs, die mit Hilfe von verschiebbaren Cursorn abgerufen werden. Parameter für gespeicherte LOB-Prozeduren werden immer vollständig gespeichert. LOBs, die über verschiebbare Cursor abgerufen werden, verwenden LOB-Querverweis, wenn progressives Streaming nicht in Kraft ist.

implicitRollbackOption

Gibt die Aktionen an, die von IBM Data Server Driver for JDBC and SQLJ ausgeführt werden, wenn eine Transaktion einen Deadlock oder eine Zeitlimitüberschreitung feststellt. Folgende Werte sind möglich:

DB2BaseDataSource.IMPLICIT_ROLLBACK_OPTION_NOT_CLOSE_CONNECTION (1): Der IBM Data Server Driver for JDBC and SQLJ löst eine SQLException mit einem SQL-Fehlercode aus, der anzeigt, dass ein Deadlock oder eine Zeitlimitüberschreitung aufgetreten ist. Der SQL-Fehlercode ist der SQL-Fehlercode, der vom Datenserver nach einer Deadlock-oder Zeitlimitüberschreitung generiert wird. Der Treiber schließt die Verbindung nicht.
DB2BaseDataSource.IMPLICIT_ROLLBACK_OPTION_CLOSE_CONNECTION (2): Der IBM Data Server Driver for JDBC and SQLJ löst eine DisconnectException mit dem SQL-Fehlercode -4499 aus, wenn ein Deadlock oder eine Zeitlimitüberschreitung auftritt. Der Treiber schließt die Verbindung. Wenn der automatische Clientweiterleitungsausgleich oder der Sysplex-Lastausgleich aktiviert ist, inaktiviert der Treiber das automatische Failover-Verhalten.
DB2BaseDataSource.IMPLICIT_ROLLBACK_OPTION_NOT_SET (0): Dieser Wert ist der Standardwert. Der IBM Data Server Driver for JDBC and SQLJ löst eine SQLException mit einem SQL-Fehlercode aus, der anzeigt, dass ein Deadlock oder eine Zeitlimitüberschreitung aufgetreten ist. Der SQL-Fehlercode ist der SQL-Fehlercode, der vom Datenserver nach einer Deadlock-oder Zeitlimitüberschreitung generiert wird. Der Treiber schließt die Verbindung nicht.

interruptProcessingMode

Gibt das Verhalten von IBM Data Server Driver for JDBC and SQLJ an, wenn eine Anwendung die Methode Statement.cancel ausführt. Folgende Werte sind möglich:

DB2BaseDataSource.INTERRUPT_PROCESSING_MODE_DISABLED (0): Die Unterbrechungsverarbeitung ist inaktiviert. Wenn eine Anwendung Statement.cancel ausführt, führt die IBM Data Server Driver for JDBC and SQLJ nichts aus.
DB2BaseDataSource.INTERRUPT_PROCESSING_MODE_STATEMENT_CANCEL (1): Wenn eine Anwendung Statement.cancel ausführt, bricht der IBM Data Server Driver for JDBC and SQLJ die momentan ausgeführte Anweisung ab, wenn der Datenserver die Unterbrechungsverarbeitung unterstützt. Wenn der Datenserver die Unterbrechungsverarbeitung nicht unterstützt, löst der IBM Data Server Driver for JDBC and SQLJ eine SQLException aus, die angibt, dass die Funktion nicht unterstützt wird. INTERRUPT_PROCESSING_MODE_STATEMENT_CANCEL ist der Standardwert.
DB2BaseDataSource.INTERRUPT_PROCESSING_MODE_CLOSE_SOCKET (2): Wenn eine Anwendung Statement.cancel ausführt, löscht der IBM Data Server Driver for JDBC and SQLJ den zugrunde liegenden Socket. Die Verbindung ist nicht geschlossen und kann wiederverwendet werden, um die Anweisung erneut zu übergeben. Wenn die Verbindung wiederverwendet wird, ruft der Treiber einen neuen Socket ab.
Für Verbindungen zu Db2 for z/OS-Datenservern verwendet der IBM Data Server Driver for JDBC and SQLJ immer diesen Wert, unabhängig von dem angegebenen Wert.

Wenn interruptProcessingMode auf DB2BaseDataSource.INTERRUPT_PROCESSING_MODE_STATEMENT_CANCEL oder DB2BaseDataSource.INTERRUPT_PROCESSING_MODE_CLOSE_SOCKET gesetzt ist und Statement.cancel ausgeführt wird, während eine Anwendung eine Methode in einem ResultSet -Objekt ausführt, wird die Operation für das Objekt ResultSet möglicherweise nicht abgebrochen. Wenn die Anweisung Statement.cancel ausgeführt wird, wird die Ausführung der Operation abgebrochen, wenn die zugrunde liegende Verarbeitung für die Methode ResultSet auf dem Datenserver ausgeführt wird. Wenn sich die zugrunde liegende Verarbeitung für die Methode ResultSet im Treiber befindet, wird die Ausführung der Operation nicht abgebrochen.

keepAliveTimeOut

Die maximale Zeit in Sekunden, bevor jedes TCP-KeepAlive-Signal an den Datenserver gesendet wird. Der Datentyp dieser Eigenschaft ist 'int'. Der Standardwert ist 15 Sekunden.

IBM Data Server Driver for JDBC and SQLJ type 4 connectivity verwendet das TCP/IP-Protokoll für die Kommunikation mit Datenservern. Um potenzielle Failover-Probleme zu verhindern, die durch Zeitlimitüberschreitungen innerhalb der TCP/IP-Schicht verursacht werden, müssen die TCP/IP-KeepAlive-Parameter auf dem Client angepasst werden. Wenn Sie die KeepAlive-Werte auf dem Client verringern, wird die rechtzeitige Erkennung von Serverausfällen verbessert.

Der Wert 0 bedeutet, dass der Zeitlimitwert das Standardzeitlimit für das System ist.

keepAliveTimeOut wird nur für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity unterstützt.

loginTimeout

Die maximale Zeit in Sekunden, die auf eine Verbindung zu einer Datenquelle gewartet wird . Nachdem die Anzahl der Sekunden, die durch loginTimeout angegeben wurden, abgelaufen ist, schließt der Treiber die Verbindung zur Datenquelle. Der Datentyp dieser Eigenschaft ist 'int'. Der Standardwert ist 0. Der Wert 0 bedeutet, dass der Zeitlimitwert das Standardzeitlimit für das System ist. Diese Eigenschaft wird für IBM Data Server Driver for JDBC and SQLJ type 2 connectivity unter Db2 for z/OS nicht unterstützt.

Wenn es sich bei der Datenserverumgebung um eine Db2 for z/OS Sysplex-Lastausgleichsumgebung oder um eine Db2 pureScale-Umgebung handelt, wird die Wartezeit für eine Verbindung durch eine Kombination aus loginTimeout, maxRetriesForClientReroute und retryIntervalForClientReroute bestimmt. loginTimeout bestimmt nur die Zeit für einen einzelnen Versuch, eine Verbindung zu einem Datenserver herzustellen. Es kann mehrere Versuche geben, eine Verbindung basierend auf dem Wert von maxRetriesForClientReroute herzustellen. Es kann auch Lücken zwischen den Versuchen zum Herstellen einer Verbindung bestehen, die auf dem Wert retryIntervalForClientReroute basiert.

Bei der automatischen Clientweiterleitungsverarbeitung hat die Eigenschaft "memberConnectTimeout" Vorrang vor der Eigenschaft "loginTimeout".

logWriter

Der Zeichenausgabedatenstrom, in den alle Protokoll-und Tracenachrichten für das Objekt DataSource gedruckt werden. Der Datentyp dieser Eigenschaft ist java.io.PrinterWriter . Der Standardwert ist null. Dies bedeutet, dass keine Protokollierung oder Traceverarbeitung für DataSource ausgegeben wird.

maxRetriesForClientReroute

Bei der automatischen Clientweiterleitung schränkt die Anzahl der Wiederholungen ein, wenn die primäre Verbindung zum Datenserver fehlschlägt.

Der Datentyp dieser Eigenschaft ist 'int'.

Die Bedeutung einer Wiederholung und die Standardeinstellung hängt vom Datenserver ab:

Für Verbindungen zu Db2 auf Linux-, UNIX-und Windows-Systemen -oder IBM Informix -Datenservern:
- Bedeutung einer Wiederholung: Wenn enableClientAffinitiesList auf DB2BaseDataSource.NO (2) gesetzt ist, zählt ein Versuch, eine Verbindung zum primären Server und alternativen Servern herzustellen, als eine Wiederholung an.
  Wenn enableClientAffinitiesList auf DB2BaseDataSource.YES (1) gesetzt ist, versucht der Versuch, eine Verbindung zu jedem Server herzustellen, der durch die Werte clientRerouteAlternateServerName und clientRerouteAlternatePortNumber angegeben wird, als eine Wiederholung. Für jede Serververbindung wird die Anzahl der Male wiederholt, die von maxRetriesForClientReroute angegeben wird.
  
  Für eine Verbindung zu einem Db2 pureScale instanz :
  - Bei Version 3.67 oder 4.17 oder höher ist ein erneuter Versuch der Versuch, eine Verbindung zu allen Membern der Db2 pureScale instanz herzustellen.
  - Bei Versionen von IBM Data Server Driver for JDBC and SQLJ vor 3.67 oder 4.17 ist ein erneuter Versuch der Versuch, eine Verbindung zu einem einzelnen Member herzustellen.
- Standardwert: Wenn enableClientAffinitiesList auf DB2BaseDataSource.NO (2) gesetzt ist und maxRetriesForClientReroute und retryIntervalForClientReroute nicht gesetzt sind, wird die Verbindung für 10 Minuten wiederholt. Es ist eine Wartezeit zwischen Wiederholungen vorhanden, die sich mit der Dauer ab der ersten Wiederholung erhöht.
  Wenn enableClientAffinitiesList den Wert DB2BaseDataSource.YES (1) hat, ist der Standardwert 3.
Für Verbindungen zu Db2 for z/OS-Datenservern:
- Bedeutung einer Wiederholung:
  - Bei Version 3.66 oder 4.16 oder höher bedeutet ein Wiederholungsversuch, dass versucht wird, eine Verbindung zu allen Membern der Gruppe mit gemeinsamer Datennutzung, die nicht das fehlerhafte Mitglied ist, und der IP-Gruppenadresse herzustellen.
  - Für Versionen von IBM Data Server Driver for JDBC and SQLJ vor 3.66 oder 4.16 bedeutet ein Wiederholungsversuch, dass versucht wird, eine Verbindung zu einem Mitglied der Gruppe mit gemeinsamer Datennutzung herzustellen.
- Standardwert:
  - Für Version 3.66 oder 4.16 oder höher von IBM Data Server Driver for JDBC and SQLJ ist der Standardwert 1.
  - Für die Versionen 3.64, 4.14, 3.65 oder 4.15 ist der Standardwert 5.
  - Für Versionen von IBM Data Server Driver for JDBC and SQLJ vor 3.64 und 4.14 wird die Verbindung für 10 Minuten erneut versucht. Es ist eine Wartezeit zwischen Wiederholungen vorhanden, die sich mit der Dauer ab der ersten Wiederholung erhöht.

Wenn der Wert von maxRetriesForClientReroute 0 ist, findet keine Clientweiterleitungsverarbeitung statt.

maxStatements

Steuert einen internen Anweisungscache, der einer Verbindung zugeordnet ist. Der Datentyp dieser Eigenschaft ist 'int'. Folgende Werte sind möglich:

positive ganze Zahl: Aktiviert den internen Anweisungscache für eine Verbindung und gibt die Anzahl der Anweisungen an, die der IBM Data Server Driver for JDBC and SQLJ im Cache offen hält.
0 oder negative ganze Zahl: Inaktiviert das interne Anweisungscaching für die Verbindung . 0 ist der Standardwert.

com.ibm.db2.jcc.DB2SimpleDataSource.maxStatements steuert den internen Anweisungscache, der nur dann einer Verbindung zugeordnet ist, wenn das Objekt Verbindung erstellt wird. com.ibm.db2.jcc.DB2SimpleDataSource.maxStatements hat keine Auswirkungen auf das Caching in einem vorhandenen Connection -Objekt.

com.ibm.db2.jcc.DB2SimpleDataSource.maxStatements gilt nur für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity .

memberConnectTimeout

Gibt an, wie lange (in Sekunden) ein Versuch, einen Socket zu einem Mitglied einer Gruppe mit gemeinsamer Datennutzung, Db2 pureScale instanz oder IBM Informix -Hochverfügbarkeitscluster zu öffnen, fehlschlägt. Der Datentyp dieser Eigenschaft ist 'int'.

memberConnectTimeout gilt nur für Socket-Verbindungsversuche zu verschiedenen Membern während der automatischen Clientweiterleitungsverarbeitung. Die Eigenschaft "memberConnectTimeout" hat Vorrang vor der Eigenschaft "loginTimeout".

Für Verbindungen zu Db2 for z/OS-Datenservern ist der Standardwert 1 Sekunde. Für Verbindungen zu anderen Datenservern ist der Standardwert 0.

Wenn der Wert für "memberConnectTimeout" kleiner-gleich 0 ist, verwendet der Treiber den Wert loginTimeout, um zu ermitteln, wie lange gewartet wird, bevor eine Verbindungsanforderung fehlschlägt.

Der Wert memberConnectTimeout wird für jede Socket-Öffnungsoperation für jedes Mitglied in einer Mitgliedsliste verwendet.

Für eine Verbindung zu einer Db2 for z/OS-Gruppe mit gemeinsamer Datennutzung, nachdem alle Versuche, einen Socket für alle Member zu öffnen, fehlgeschlagen ist, versucht der Treiber, den Socket unter Verwendung einer Gruppe-IP-Adresse zu öffnen. Für diese Wiederholung verwendet der Treiber den Wert loginTimeout, um zu bestimmen, wie lange gewartet wird, bis die Verbindungsanforderung fehlschlägt.

Kennwort

Das Kennwort, das zum Herstellen von Verbindungen verwendet werden soll. Der Datentyp dieser Eigenschaft ist 'String'. Wenn Sie die Schnittstelle DataSource zum Herstellen einer Verbindung verwenden, können Sie diesen Eigenschaftswert überschreiben, indem Sie diese Form der Methode DataSource.getConnection aufrufen:

getConnection(benutzer,
kennwort);

portnummer

Die Nummer des Ports, an dem der DRDA-Server für Anforderungen empfangsbereit ist. Der Datentyp dieser Eigenschaft ist 'int'.

progressiveStreaming

Gibt an, ob der JDBC-Treiber progressives Streaming verwendet, wenn progressives Streaming in der Datenquelle unterstützt wird.

Db2 for z/OS Version 9.1 und höher unterstützt progressives Streaming für LOBs und XML-Objekte. Db2 auf Linux-, UNIX-und Windows-Systemen Version 9.5 und höher und IBM Informix Version 11.50 und höher unterstützen progressives Streaming für LOBs.

Bei progressivem Streaming, auch als dynamisches Datenformat bezeichnet, bestimmt die Datenquelle dynamisch den effizientesten Modus, in dem LOB-Daten oder XML-Daten zurückgegeben werden. Dieser Schritt basiert auf der Größe der LOBs oder XML-Objekte. Der Wert des Parameters streamBufferSize bestimmt, ob die Daten bei der Rückgabe materialisiert werden.

Der Datentyp 'progressiveStreaming' ist 'int'. Gültige Werte sind DB2BaseDataSource.YES (1) und DB2BaseDataSource.NO (2). Wenn die Eigenschaft "progressiveStreaming" nicht angegeben wird, ist der progressiveStreaming-Wert DB2BaseDataSource.NOT_SET (0).

Wenn die Verbindung zu einer Datenquelle besteht, die progressives Streaming unterstützt, und der Wert von progressiveStreaming DB2BaseDataSource.YES oder DB2BaseDataSource.NOT_SET ist, verwendet der JDBC-Treiber progressives Streaming, um LOBs und XML-Daten zurückzugeben.

Wenn der Wert von progressiveStreaming DB2BaseDataSource.NO ist oder die Datenquelle progressives Streaming nicht unterstützt, hängt die Art und Weise, in der der JDBC-Treiber LOB-oder XML-Daten zurückgibt, vom Wert der Eigenschaft fullyMaterializeLobData ab.

queryCloseImplicit

Gibt an, ob Cursor sofort geschlossen werden, nachdem alle Zeilen abgerufen wurden. queryCloseImplicit gilt nur für Verbindungen mit IBM Data Server Driver for JDBC and SQLJ type 4 connectivity zu z/OS Version 8 oder höher und IBM Data Server Driver for JDBC and SQLJ type 4 connectivity oder IBM Data Server Driver for JDBC and SQLJ type 2 connectivity Db2 auf Linux-, UNIX-und Windows-Systemen Version 9.7 oder höher. Folgende Werte sind möglich:

DB2BaseDataSource.QUERY_CLOSE_IMPLICIT_YES (1)

Schließen Sie die Cursor unmittelbar, nachdem alle Zeilen abgerufen wurden.

Ein Wert von DB2BaseDataSource.QUERY_CLOSE_IMPLICIT_YES kann eine bessere Leistung bieten, da diese Einstellung zu weniger Netzverkehr führt.

DB2BaseDataSource.QUERY_CLOSE_IMPLICIT_NO (2)

Schließen Sie Cursor nicht sofort, nachdem alle Zeilen abgerufen wurden.

DB2BaseDataSource.QUERY_CLOSE_IMPLICIT_COMMIT (3)

Führen Sie die folgenden Aktionen aus:

Schließen Sie den Cursor implizit, nachdem alle Zeilen abgerufen wurden.
Wenn sich die Anwendung im Modus für automatische Festschreibung befindet, senden Sie implizit eine Commitanforderung an die Datenquelle für die aktuelle UOWL-Einheit.

Wichtig: Wenn dieser Wert festgelegt wird, kann es Auswirkungen auf andere Ressourcen geben, ebenso wie eine explizite COMMIT-Operation Auswirkungen auf andere Ressourcen haben kann. Beispielsweise werden andere nicht gehaltene Cursor geschlossen, LOB-Querverweise werden außerhalb des Geltungsbereichs, progressive Verweise werden zurückgesetzt und verschiebbare Cursor verlieren ihre Position.

Einschränkung: Die folgenden Einschränkungen gelten für das Verhalten von QUERY_CLOSE_IMPLICIT_COMMIT:

Dieses Verhalten gilt nur für SELECT-Anweisungen, die von der Anwendung ausgegeben werden. Sie gilt nicht für SELECT-Anweisungen, die von der IBM Data Server Driver for JDBC and SQLJ generiert werden.
Wenn QUERY_CLOSE_IMPLICIT_COMMIT gesetzt ist und die Anwendung nicht im Modus für automatisches Festschreiben (autocommit) ist, verwendet der Treiber das Standardverhalten (Verhalten QUERY_CLOSE_IMPLICIT_NOT_SET). Wenn QUERY_CLOSE_IMPLICIT_COMMIT das Standardverhalten ist, verwendet der Treiber das Verhalten QUERY_CLOSE_IMPLICIT_YES.
Wenn QUERY_CLOSE_IMPLICIT_COMMIT definiert ist und die Datenquelle das Verhalten von QUERY_CLOSE_IMPLICIT_COMMIT nicht unterstützt, verwendet der Treiber das Verhalten QUERY_CLOSE_IMPLICIT_YES.
Dieses Verhalten wird bei stapelweise Anweisungen nicht unterstützt.
Dieses Verhalten wird bei einer XA-Verbindung nur unterstützt, wenn sich die Verbindung in einer lokalen Transaktion befindet.

DB2BaseDataSource.QUERY_CLOSE_IMPLICIT_NOT_SET (0)

Dieser Wert ist der Standardwert. In der folgenden Tabelle wird das Verhalten für eine Verbindung zu jedem Typ von Datenquelle beschrieben.

Datenquellen	Version	Umgebung mit gemeinsamer Datennutzung	Behavior
Db2 for z/OS	Version 10	gemeinsame Nutzung von Daten oder gemeinsame Nutzung von Daten ohne gemeinsame	QUERY_CLOSE_IMPLICIT_COMMIT
Db2 for z/OS	Version 9 mit APAR PK68746	Nicht-gemeinsame Nutzung oder in einer Gruppe mit gemeinsamer Datennutzung, jedoch nicht im Koexistenzmodus mit Membern der Version 8	QUERY_CLOSE_IMPLICIT_COMMIT
Db2 for z/OS	Version 9 ohne APAR PK68746	Nicht-gemeinsame Nutzung oder in einer Gruppe mit gemeinsamer Datennutzung, jedoch nicht im Koexistenzmodus mit Membern der Version 8	QUERY_CLOSE_IMPLICIT_YES
Db2 for z/OS	Version 9 mit APAR PK68746	In einer Gruppe mit gemeinsamer Datennutzung im Koexistenzmodus mit Mitgliedern der Version 8	QUERY_CLOSE_IMPLICIT_COMMIT
Db2 for z/OS	Version 9 ohne APAR PK68746	In einer Gruppe mit gemeinsamer Datennutzung im Koexistenzmodus mit Mitgliedern der Version 8	QUERY_CLOSE_IMPLICIT_YES
Db2 for z/OS	Version 8 mit oder ohne APAR PK68746		QUERY_CLOSE_IMPLICIT_YES
Db2 auf Linux-, UNIX-und Windows-Systemen	Version 9.7		QUERY_CLOSE_IMPLICIT_YES

Datengröße queryDataSize

Gibt einen Hinweis an, der verwendet wird, um die Menge der Abfragedaten in Byte zu steuern, die bei jeder Abrufoperation von der Datenquelle zurückgegeben werden. Dieser Wert kann zur Optimierung der Anwendung verwendet werden, indem die Anzahl der Fahrten in die Datenquelle gesteuert wird, die zum Abrufen von Daten erforderlich sind.

Die Verwendung eines größeren Werts für 'queryDataSize' kann zu einem geringeren Datenaustausch im Netz führen, was zu einer besseren Leistung führen kann. Wenn die Größe der Ergebnismenge beispielsweise 50 KB beträgt und der Wert von queryDataSize 32767 (32 KB) beträgt, sind zwei Fahrten zum Datenbankserver erforderlich, um die Ergebnismenge abzurufen. Wenn queryDataSize jedoch auf 65535 (64 KB) gesetzt ist, ist nur eine Fahrt zur Datenquelle erforderlich, um die Ergebnismenge abzurufen.

In der folgenden Tabelle sind die Mindest-, Maximal-und Standardwerte für queryDataSize für jede Datenquelle aufgelistet.

Tabelle 3. Standard-, Minimal-und Maximalwerte für queryDataSize
Datenquellen	Produktversion	Standard	Minimum	Maximum	Gültige Werte
Db2 auf Linux-, UNIX-und Windows-Systemen	Alle	32767	4096	262143	4096-32767, 98303, 131071, 163839, 196607, 229375, 262143 ¹
IBM Informix	Alle	32767	4096	10485760	4096-10485760
Db2 für IBM i	V5R4	32767	4096	65535	4096-65535
Db2 für IBM i	V6R1	32767	4096	262143	4096-65535, 98303, 131071, 163839, 196607, 229375, 262143 ¹
Db2 for z/OS	Version 8 ( IBM Data Server Driver for JDBC and SQLJ type 4 connectivity )	32767	32767	32767	32767
Db2 for z/OS	Version 9 ( IBM Data Server Driver for JDBC and SQLJ type 4 connectivity )	32767	32767	65535	32767, 65535
Db2 for z/OS	Version 10 ( IBM Data Server Driver for JDBC and SQLJ type 4 connectivity )	32767	32767	262143	32767, 65535, 98303, 131071, 163839, 196607, 229375, 262143 ¹
Db2 for z/OS	Version 10 ( IBM Data Server Driver for JDBC and SQLJ type 2 connectivity )	32767	32767	1048575	32767, 65535, 98303, 131071, 163839, 196607, 229375, 262143, 294911, 327679, 360447, 393215, 425983, 458751, 491519, 524287, 557055, 589823, 622591, 655359, 688127, 720895, 753663, 786431, 819199, 851967, 884735, 917503, 950271, 983039, 1015807, 1048575 ¹
Anmerkung: Wenn Sie einen Wert zwischen dem minimalen und dem maximalen Wert angeben, der kein gültiger Wert ist, setzt IBM Data Server Driver for JDBC and SQLJ queryDataSize auf den nächstgültigen Wert.

queryTimeoutInterruptProcessingMode

Gibt an, was passiert, wenn das Zeitlimitintervall für Abfragen für ein Statement -Objekt abläuft. Gültige Werte sind:

DB2BaseDataSource.INTERRUPT_PROCESSING_MODE_STATEMENT_CANCEL (1)

Gibt an, dass der IBM Data Server Driver for JDBC and SQLJ die momentan ausgeführte SQL-Anweisung abbricht, wenn das Zeitlimitintervall für Abfragen für ein Statement -Objekt abläuft. Der IBM Data Server Driver for JDBC and SQLJ löst außerdem eine Ausnahmebedingung mit dem SQL-Fehler-952 aus, wenn der Datenserver die Unterbrechung von SQL-Anweisungen unterstützt. Wenn der Datenserver die Unterbrechung von SQL-Anweisungen nicht unterstützt, löst der Treiber eine Ausnahme aus, die anzeigt, dass die Funktion nicht unterstützt wird.

Für Verbindungen zu anderen Datenservern als Db2 for z/OS ist INTERRUPT_PROCESSING_MODE_STATEMENT_CANCEL der Standardwert.

Für Verbindungen zu Db2 for z/OS-Datenservern ist INTERRUPT_PROCESSING_MODE_STATEMENT_CANCEL kein möglicher Wert. Wenn er angegeben wird, verwendet der Treiber stattdessen INTERRUPT_PROCESSING_MODE_CLOSE_SOCKET.

DB2BaseDataSource.INTERRUPT_PROCESSING_MODE_CLOSE_SOCKET (2)

Gibt an, dass der zugrunde liegende Socket gelöscht wird und die Verbindung geschlossen wird, wenn das Zeitlimitintervall für die Abfrage für ein Statement -Objekt abläuft.

Für Verbindungen zu anderen Datenservern als Db2 for z/OS, wenn das Statement -Objekt das Zeitlimit erreicht:

Wenn die automatische Clientweiterleitung nicht aktiviert ist und die Option enableSysplexWLB auf false gesetzt ist, wird eine Ausnahme mit dem SQL-Fehlercode -4499 ausgelöst. Alle nachfolgenden Operationen im Statement -Objekt oder in allen anderen Statement -Objekten, die aus derselben Verbindung erstellt wurden, empfangen eine Ausnahmebedingung , die anzeigt, dass die Verbindung geschlossen ist. Wenn ein Statement -Objekt das Zeitlimit erreicht hat, muss die Anwendung eine neue Verbindung herstellen, bevor sie eine neue Transaktion ausführen kann.
Wenn die automatische Clientweiterleitung aktiviert ist und die Option enableSysplexWLB auf false gesetzt ist, versucht der IBM Data Server Driver for JDBC and SQLJ , eine Verbindung erneut herzustellen. Wenn eine neue Verbindung erfolgreich hergestellt werden konnte, gibt der Treiber einen SQL-Fehlercode -4498 zurück. Der Treiber führt die zeitgetakten SQL-Anweisungen jedoch nicht erneut aus, selbst wenn enableSeamlessFailover auf DB2BaseDataSource.YES (1) gesetzt ist.
Wenn enableSysplexWLB auf true gesetzt ist, versucht der IBM Data Server Driver for JDBC and SQLJ , eine Verbindung erneut herzustellen. Wenn eine neue Verbindung erfolgreich hergestellt werden konnte, gibt der Treiber den SQL-Fehlercode -30108 zurück. Der Treiber führt die zeitgetakten SQL-Anweisungen jedoch nicht erneut aus, selbst wenn enableSeamlessFailover auf DB2BaseDataSource.YES (1) gesetzt ist.

Für Verbindungen zu Db2 for z/OS, wenn das Statement -Objekt das Zeitlimit hat:

Wenn enableSysplexWLB auf false gesetzt ist, wird eine Ausnahme mit dem SQL-Fehlercode -4499 ausgelöst. Alle nachfolgenden Operationen im Statement -Objekt oder in allen anderen Statement -Objekten, die aus derselben Verbindung erstellt wurden, empfangen eine Ausnahmebedingung , die anzeigt, dass die Verbindung geschlossen ist. Wenn ein Statement -Objekt das Zeitlimit erreicht hat, muss die Anwendung eine neue Verbindung herstellen, bevor sie eine neue Transaktion ausführen kann.
Wenn enableSysplexWLB auf true gesetzt ist, versucht der IBM Data Server Driver for JDBC and SQLJ , eine Verbindung erneut herzustellen. Wenn eine neue Verbindung erfolgreich hergestellt werden konnte, gibt der Treiber den SQL-Fehlercode -30108 zurück. Der Treiber führt die zeitgetakten SQL-Anweisungen jedoch nicht erneut aus, selbst wenn 'enableSeamlessFailover' auf DB2BaseDataSource.YES (1) gesetzt ist.

Eigenschaft 'resultSetHoldability'

Gibt an, ob Cursor nach einer Festschreibungsoperation geöffnet bleiben. Der Datentyp dieser Eigenschaft ist 'int'. Gültige Werte sind:

DB2BaseDataSource.HOLD_CURSORS_OVER_COMMIT (1)

Lassen Sie die Cursor nach einer Festschreibungsoperation geöffnet.

Diese Einstellung ist für eine Verbindung, die Teil einer verteilten (XA)-Transaktion ist, nicht gültig.

DB2BaseDataSource.CLOSE_CURSORS_AT_COMMIT (2)

Cursor nach einer COMMIT-Operation schließen.

DB2BaseDataSource.NOT_SET (0)

Dieser Wert ist der Standardwert. Das Verhalten ist:

Bei Verbindungen, die zu verteilten Transaktionen (XA-Transaktionen) gehören, werden die Cursor nach einer Festschreibungsoperation geschlossen.
Für Verbindungen, die nicht Teil einer verteilten Transaktion sind:
- Für Verbindungen zu allen Versionen von Db2 for z/OS-, Db2 auf Linux-, UNIX-und Windows-Systemen -oder Db2 für IBM i -Servern oder Cloudscape Version 8.1 oder höher-Servern bleiben Cursor nach einer Festschreibungsoperation geöffnet.
- Für Verbindungen zu allen Versionen von IBM Informix oder zu Cloudscape-Versionen vor Version 8.1 werden die Cursor nach einer COMMIT-Operation geschlossen.

retrieveMessagesFromServerOnGetMessage

Gibt an, ob die JDBC-Aufrufe SQLException.getMessage oder SQLWarning.getMessage dazu führen, dass der IBM Data Server Driver for JDBC and SQLJ eine gespeicherte Db2 for z/OS-Prozedur aufruft, die den Nachrichtentext für den Fehler abruft. Der Datentyp dieser Eigenschaft ist boolesch. Der Standardwert ist false , d. es bedeutet, dass der vollständige Nachrichtentext nicht an den Client zurückgegeben wird.

Wenn z. B. retrieveMessagesFromServerOnGetMessage auf true gesetzt ist, wird eine Nachricht ähnlich dieser Nachricht von SQLException.getMessage zurückgegeben, nachdem versucht wurde, eine SQL-Operation für eine nicht vorhandene Tabelle ADMF001.NO_TABLE auszuführen:

ADMF001.NO_TABLE IST EIN NICHT DEFINIERTER NAME. SQLCODE=-204, 
SQLSTATE=42704, DRIVER=3.50.54

Wenn retrieveMessagesFromServerOnGetMessage auf false gesetzt ist, wird eine Nachricht ähnlich der folgenden zurückgegeben:

SQL-Fehlercode (Db2):  SQLCODE=-204, SQLSTATE=42704, DRIVER=3.50.54

Eine Alternative zum Festlegen dieser Eigenschaft auf true ist die Verwendung nur der DB2Sqlca.getMessage-Methode für IBM Data Server Driver for JDBC and SQLJ in Anwendungen. Beide Verfahren führen zu einem Aufruf einer gespeicherten Prozedur, der eine Arbeitseinheit startet.

retryIntervalForClientReroute

Gibt für die automatische Clientweiterleitung die Zeit in Sekunden an, die zwischen den Verbindungsversuchen wiederholt werden soll.

Der Datentyp dieser Eigenschaft ist 'int'.

Die Bedeutung einer Wiederholung und die Standardeinstellung hängt vom Datenserver ab:

Für Verbindungen zu Db2 auf Linux-, UNIX-und Windows-Systemen -oder IBM Informix -Datenservern:
- Bedeutung einer Wiederholung: Wenn enableClientAffinitiesList auf DB2BaseDataSource.NO (2) gesetzt ist, zählt ein Versuch, eine Verbindung zum primären Server und alternativen Servern herzustellen, als eine Wiederholung an.
  Wenn enableClientAffinitiesList auf DB2BaseDataSource.YES (1) gesetzt ist, versucht der Versuch, eine Verbindung zu jedem Server herzustellen, der durch die Werte clientRerouteAlternateServerName und clientRerouteAlternatePortNumber angegeben wird, als eine Wiederholung. Für jede Serververbindung wird die Anzahl der Male wiederholt, die von maxRetriesForClientReroute angegeben wird.
- Standardwert: Wenn enableClientAffinitiesList auf DB2BaseDataSource.NO (2) gesetzt ist und maxRetriesForClientReroute und retryIntervalForClientReroute nicht gesetzt sind, wird die Verbindung für 10 Minuten wiederholt. Es ist eine Wartezeit zwischen Wiederholungen vorhanden, die sich mit der Dauer ab der ersten Wiederholung erhöht.
  Wenn enableClientAffinitiesList der Wert DB2BaseDataSource.YES (1) ist, ist der Standardwert 0.
Für Verbindungen zu Db2 for z/OS-Datenservern:
- Bedeutung einer Wiederholung:
  - Bei Version 3.66 oder 4.16 oder höher bedeutet ein Wiederholungsversuch, dass versucht wird, eine Verbindung zu allen Membern der Gruppe mit gemeinsamer Datennutzung, die nicht das fehlerhafte Mitglied ist, und der IP-Gruppenadresse herzustellen.
  - Für Versionen von IBM Data Server Driver for JDBC and SQLJ vor 3.66 oder 4.16 bedeutet ein Wiederholungsversuch, dass versucht wird, eine Verbindung zu einem Mitglied der Gruppe mit gemeinsamer Datennutzung herzustellen.
- Standardwert:
  - Für Version 3.64 oder 4.14 oder höher von IBM Data Server Driver for JDBC and SQLJ ist der Standardwert 0.
  - Für Versionen von IBM Data Server Driver for JDBC and SQLJ vor 3.64 und 4.14 wird die Verbindung für 10 Minuten erneut versucht. Es ist eine Wartezeit zwischen Wiederholungen vorhanden, die sich mit der Dauer ab der ersten Wiederholung erhöht.

Sicherheitsmechanismus

Gibt den Sicherheitsmechanismus von DRDA an. Der Datentyp dieser Eigenschaft ist 'int'. Folgende Werte sind möglich:

CLEAR_TEXT_PASSWORD_SECURITY (3): Benutzer-ID und Kennwort
USER_ONLY_SECURITY (4): Nur Benutzer-ID
ENCRYPTED_PASSWORD_SECURITY (7): Benutzer-ID, verschlüsseltes Kennwort
ENCRYPTED_USER_AND_PASSWORD_SECURITY (9): Verschlüsselte Benutzer-ID und Kennwort
KERBEROS_SECURITY (11): Kerberos. Dieser Wert gilt nicht für Verbindungen zu IBM Informix .
ENCRYPTED_USER_AND_DATA_SECURITY (12): Verschlüsselte Benutzer-ID und verschlüsselte sicherheitsrelevante Daten. Dieser Wert gilt nur für Verbindungen zu Db2 for z/OS .
ENCRYPTED_USER_PASSWORD_AND_DATA_SECURITY (13): Verschlüsselte Benutzer-ID und Kennwort und verschlüsselte sicherheitsrelevante Daten. Dieser Wert gilt nicht für Verbindungen zu IBM Informix .
PLUGIN_SECURITY (15): Plug-in-SicherheitDieser Wert gilt nur für Verbindungen zu Db2 auf Linux-, UNIX-und Windows-Systemen .
ENCRYPTED_USER_ONLY_SECURITY (16): Verschlüsselte Benutzer-ID. Dieser Wert gilt nicht für Verbindungen zu IBM Informix .
TLS_CLIENT_CERTIFICATE_SECURITY (18): Clientzertifikatssicherheit, unter Verwendung von SSL. Dieser Wert bezieht sich nur auf Verbindungen zu Db2 for z/OS Version 10 und höher.

Wenn diese Eigenschaft angegeben wird, ist der angegebene Sicherheitsmechanismus der einzige Mechanismus, der verwendet wird. Wenn der Sicherheitsmechanismus von der Verbindung nicht unterstützt wird, wird eine Ausnahmebedingung ausgelöst.

Der Standardwert für securityMechanism wird durch die Konfigurationseigenschaft db2.jcc.securityMechanism bereitgestellt. Wenn die Konfigurationseigenschaft "db2.jcc.securityMechanism" ebenfalls nicht angegeben wird, lautet der Standardwert für securityMechanism CLEAR_TEXT_PASSWORD_SECURITY.

Wenn der Datenserver CLEAR_TEXT_PASSWORD_SECURITY nicht unterstützt, aber ENCRYPTED_USER_AND_PASSWORD_SECURITY unterstützt, führt der IBM Data Server Driver for JDBC and SQLJ -Treiber ein Upgrade des Sicherheitsmechanismus auf ENCRYPTED_USER_AND_PASSWORD_SECURITY durch und versucht, eine Verbindung zum Server herzustellen. Alle anderen Abweichungen in der Sicherheitsmechanismus-Unterstützung zwischen dem Requester und dem Server führen zu einem Fehler.

Diese Eigenschaft gilt nicht für IBM Data Server Driver for JDBC and SQLJ type 2 connectivity unter Db2 for z/OS.

Die Sicherheitsmechanismen ENCRYPTED_PASSWORD_SECURITY, ENCRYPTED_USER_AND_PASSWORD_SECURITY, ENCRYPTED_USER_AND_DATA_SECURITY, ENCRYPTED_USER_PASSWORD_AND_DATA_SECURITY und ENCRYPTED_USER_ONLY_SECURITY verwenden die DRDA-Verschlüsselung. Die Verschlüsselung von DRDA dient nicht dazu, die Vertraulichkeit und Integrität von Kennwörtern oder Daten über ein Netz zu gewährleisten, das nicht sicher ist, z. B. das Internet. Die DRDA-Verschlüsselung verwendet einen anonymen Schlüsselaustausch, Diffie-Hellman, der keine Authentifizierung des Servers oder des Clients bereitstellt. Die DRDA-Verschlüsselung ist anfällig für 'Man-in-the-middle'-Angriffe.

sendDataAsIs

Gibt an, dass der IBM Data Server Driver for JDBC and SQLJ Eingabeparameterwerte nicht in die Zielspaltendatentypen konvertiert. Der Datentyp dieser Eigenschaft ist boolesch. Der Standardwert ist false .

Sie müssen diese Eigenschaft nur für Anwendungen verwenden, die immer sicherstellen, dass die Datentypen in der Anwendung mit den Datentypen in den entsprechenden Datenbanktabellen übereinstimmen.

ServerBidistringType

Wird verwendet, wenn enableBidiLayoutTransformation aktiviert ist. Gibt den Zeichenfolgetyp an, der vom Server verwendet wird. Der Datentyp dieser Eigenschaft ist 'int'. 'serverBidiStringType' verwendet dieselben gültigen Werte wie 'clientBidiStringType'.

Servername

Der Hostname oder die TCP/IP-Adresse der Datenquelle. Der Datentyp dieser Eigenschaft ist 'String'.

sslCertLocation

Gibt an, dass eine Anwendung die Position einer vertrauenswürdigen Zertifikatsdatei konfigurieren kann. Für Anwendungen, die das Datenbankserverzertifikat haben, ist sslCertLocation die einzige Eigenschaft, die konfiguriert werden muss, um IBM Data Server Driver for JDBC and SQLJ anzuweisen, dem Zertifikat für SSL-Verbindungen zu vertrauen. Mit dieser Eigenschaft wird die Notwendigkeit, das Zertifikat in eine Java-Truststore-Datenbank und zugehörige Treiberkonfigurationen zu importieren, entfernt.

Der Standardwert für 'sslCertLocation' wird von der Konfigurationseigenschaft 'db2.jcc.sslCertLocation' bereitgestellt. Wenn die Konfigurationseigenschaft "db2.jcc.sslCertLocation" nicht angegeben ist, die Eigenschaften "sslTruststoreLocation" und "sslCertLocation" nicht konfiguriert sind und "sslConnection" auf true gesetzt ist, verwendet IBM Data Server Driver for JDBC and SQLJ den Standard-Truststore für die Java-Laufzeitumgebung.

Die Eigenschaft "sslCertLocation" akzeptiert Zertifikatpositionswerte in den folgenden Formularen:

Dateierweiterungen: '.arm', '.pem', '.cert', '.crt' und '.der'.
Vollständiger Pfad zur Zertifikatsdatei: sslCertLocation=/path/to/cert.arm
Pfad relativ zum aktuellen Klassenpfad: sslCertLocation=classpath:relative/cert.arm
DER-kodierte Zertifikate in binärer oder Base64-ASCII-Codierung. Wenn das Zertifikat in der Base64-Codierung bereitgestellt wird, muss der Dateiinhalt am Anfang von -----BEGIN CERTIFICATE----- und am Ende von -----END CERTIFICATE----- gebunden werden.

sslCipherSuites

Gibt die Gruppe der Cipher Suites an, die verwendet werden sollen, wenn SSL-Verbindungen zum Server hergestellt werden. Konfigurieren Sie diese Eigenschaft nur, wenn Sie die Standard-Cipher-Suites nicht aus der JRE (Java Runtime Environment) verwenden möchten. Geben Sie die Namen der Cipher Suites als durch Kommas getrennte Zeichenfolgewerte an.

sslConnection

Gibt an, ob der IBM Data Server Driver for JDBC and SQLJ einen SSL-Socket verwendet, um eine Verbindung zur Datenquelle herzustellen. Wenn sslConnection auf true gesetzt ist, verwendet die Verbindung einen SSL-Socket. Wenn sslConnection auf false gesetzt ist, verwendet die Verbindung einen einfachen Socket.

Der Standardwert für 'sslConnection' wird durch die Konfigurationseigenschaft 'db2.jcc.sslConnection' bereitgestellt. Wenn die Konfigurationseigenschaft db2.jcc.sslConnection ebenfalls nicht angegeben wird, lautet der Standardwert für sslConnection false .

Diese Eigenschaft gilt nur für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity .

sslTrustStoreLocation

Gibt den Namen des Java-Truststore auf dem Client an, der das Serverzertifikat für eine SSL-Verbindung enthält.

Der IBM Data Server Driver for JDBC and SQLJ verwendet diese Option nur, wenn die Eigenschaft "sslConnection" auf true gesetzt ist.

Wenn "sslTrustStoreLocation" festgelegt ist und "sslConnection" auf true gesetzt ist, verwendet IBM Data Server Driver for JDBC and SQLJ anstelle des Werts in der Eigenschaft "javax.net.ssl.trustStore Java " den Wert "sslTrustStoreLocation".

Der Standardwert für "sslTrustStoreLocation" wird durch die Konfigurationseigenschaft "db2.jcc.sslTrustStoreLocation" bereitgestellt. Wenn die Konfigurationseigenschaft 'db2.jcc.sslTrustStoreLocation' ebenfalls nicht angegeben ist, ist der Standardwert für sslTrustStoreLocation null.

Diese Eigenschaft gilt nur für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity .

sslTrustStorePassword

Gibt das Kennwort für den Java-Truststore auf dem Client an, der das Serverzertifikat für eine SSL-Verbindung enthält.

Der IBM Data Server Driver for JDBC and SQLJ verwendet diese Option nur, wenn die Eigenschaft "sslConnection" auf true gesetzt ist.

Wenn "sslTrustStorePassword" festgelegt ist und "sslConnection" auf true gesetzt ist, verwendet der IBM Data Server Driver for JDBC and SQLJ den Wert "sslTrustStorePassword" anstelle des Werts in der Eigenschaft "javax.net.ssl.trustStorePassword Java ".

Der Standardwert für 'sslTrustStorePassword' wird von der Konfigurationseigenschaft 'db2.jcc.sslTrustStorePassword' bereitgestellt. Wenn die Konfigurationseigenschaft db2.jcc.sslTrustStorePassword ebenfalls nicht angegeben wird, ist der Standardwert für sslTrustStorePassword null.

Diese Eigenschaft gilt nur für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity .

sslTrustStoreType

Gibt den Typ einer vertrauenswürdigen Zertifikatsdatei an. Die Eigenschaft sslTrustStoreType gilt für Db2 for z/OS, Db2 auf Linux-, UNIX-und Windows-Systemen und IBM Informix für eine T4-SSL-Verbindung.

Der Standardwert von sslTrustStoreType ist NULL (NOT SET). Wenn sslTrustStoreType NULL ist, wird der Standardtyp des JRE-Truststore angewendet, um die Truststore-Datei für die SSL-Verbindung zu laden.

sslVersion

Gibt die Version an, die die Anwendung konfigurieren kann, um den Treiber für die TLS-Protokollstufe für eine SSL-Verbindung zu aktivieren. Der Standardwert von sslVersion ist null (nicht festgelegt). Wenn sslVersion nicht im Verbindung-oder Datenquellenobjekt definiert ist, wird die Standard-TLS-Version der JRE oder die SSL-Version für die SSL-Verbindung angewendet.

Die Eigenschaft sslVersion gilt nur für Db2 for z/OS, Db2 auf Linux-, UNIX-und Windows-Systemen und IBM Informix .

stripTrailingZerosForDecimalNumbers

Gibt an, ob der IBM Data Server Driver for JDBC and SQLJ abschließende Nullen entfernt, wenn er Daten aus einer DECFLOAT-, DECIMAL-oder NUMERIC-Spalte abruft. Diese Eigenschaft ist nur sinnvoll, wenn das SDK für Java Version 1.5 oder höher ist. Der Datentyp dieser Eigenschaft ist 'int'.

Folgende Werte sind möglich:

DB2BaseDataSource.NOT_SET (0): Der IBM Data Server Driver for JDBC and SQLJ entfernt keine abschließenden Nullen aus dem abgerufenen Wert. Dieser Wert ist der Standardwert.
DB2BaseDataSource.YES (1): Der IBM Data Server Driver for JDBC and SQLJ entfernt abschließende Nullen, wenn er einen Wert aus einer DECFLOAT-, DECIMAL-oder NUMERIC-Spalte als ein Objekt java.math.BigDecimal abruft.
Wenn der Treiber z. B. den Wert 234.04000 abruft, wird der Wert 234.04 an die Anwendung zurückgegeben.
DB2BaseDataSource.NO (2): Der IBM Data Server Driver for JDBC and SQLJ entfernt keine abschließenden Nullen aus dem abgerufenen Wert.

timerLevelForQueryTimeOut

Gibt die Ebene an, auf der der IBM Data Server Driver for JDBC and SQLJ ein Objekt java.util.Timer erstellt, das darauf wartet, dass die Abfrageausführung ausgelagert wird. Folgende Werte sind möglich:

DB2BaseDataSource.QUERYTIMEOUT_STATEMENT_LEVEL (1): Der IBM Data Server Driver for JDBC and SQLJ erstellt ein Objekt Zeitgeber für jedes Statement -Objekt. Wenn das Objekt Statement geschlossen wird, löscht der Treiber das Objekt Zeitgeber . Dieser Wert ist der Standardwert.
DB2BaseDataSource.QUERYTIMEOUT_CONNECTION_LEVEL (2): Der IBM Data Server Driver for JDBC and SQLJ erstellt für jedes Connection -Objekt ein Objekt Timer . Wenn das Objekt Verbindung geschlossen wird, löscht der Treiber das Objekt Zeitgeber .
DB2BaseDataSource.QUERYTIMEOUT_DISABLED (-1): Der IBM Data Server Driver for JDBC and SQLJ erstellt kein Objekt Timer , um das Zeitlimit für die Abfrageausführung zu steuern.

timestampFormat

Gibt das Format an, in dem das Ergebnis der ResultSet.getString-oder CallableStatement.getString-Methode für die Spalte TIMESTAMP zurückgegeben wird. Der Datentyp von timestampFormat ist 'int'.

Mögliche Werte für timestampFormat:

Konstant	Ganzzahliger Wert	Format
`com.ibm.db2.jcc.DB2BaseDataSource.ISO`	1	yyyy-mm-dd-hh.mm ss.nnnnnnnnn ¹
`com.ibm.db2.jcc.DB2BaseDataSource.JDBC`	5	jjjj-mm-tt hh:mm:ss.nnnnnnnnn ¹
Anmerkung: Die Anzahl der Stellen im Bruchteil der Zeitmarke hängt von der Genauigkeit der Spalte TIMESTAMP (`p`) in der Quellentabelle ab. Wenn `p` < 9, werden `p` Ziffern zurückgegeben. Wenn `p` > = 9, 9 Ziffern zurückgegeben werden, werden die restlichen Ziffern abgeschnitten.

Der Standardwert ist com.ibm.db2.jcc.DB2BaseDataSource.JDBC.

timestampFormat wirkt sich nur auf das Format der Ausgabe aus.

timestampPrecisionReporting

Gibt an, ob abschließende Nullen im Ergebnis eines Aufrufs von Resultset.getString für einen TIMESTAMP-Wert abgeschnitten werden. Der Datentyp dieser Eigenschaft ist 'int'. Folgende Werte sind möglich:

TIMESTAMP_JDBC_STANDARD (1)

Abgelaufende Nullen werden im Ergebnis des Aufrufs von Resultset.getString für einen TIMESTAMP-Wert abgeschnitten. Dieser Wert ist der Standardwert.

Zum Beispiel:

Der Wert für TIMESTAMP (2009-07-19-10.12.00.000000) wird nach dem Abruf auf 2009-07-19-10.12.00.0 abgeschnitten.
Der TIMESTAMP-Wert 2009-12-01-11.30.00.100000 wird nach dem Abruf auf 2009-12-01-11.30.00.1 abgeschnitten.

TIMESTAMP_ZERO_PADDING (2)

Abgelaufende Nullen werden im Ergebnis eines Aufrufs von Resultset.getString für einen TIMESTAMP-Wert nicht abgeschnitten.

Traceverzeichnis

Gibt ein Verzeichnis an, in das die Trace-Informationen geschrieben werden. Der Datentyp dieser Eigenschaft ist String. Wenn traceDirectory angegeben ist, werden Trace-Informationen für mehrere Verbindungen in derselben DataSource in mehrere Dateien geschrieben.

Wenn traceDirectory angegeben wird, wird eine Verbindung zu einer Datei mit dem Namen traceFile_ origin _ n durchgeführt.

n ist die n -te Verbindung für eine DataSource .

Ursprung gibt den Ursprung des Protokollschreibprogramms an, das im Gebrauch ist. Gültige Werte für den Ursprung sind:

cpds: Das Protokollausgabeprogramm für ein Objekt DB2ConnectionPoolDataSource .
Treiber: Der Protokollwriter für ein DB2Driver -Objekt.
global: Der Protokollwriter für ein DB2TraceManager -Objekt.
sds: Das Protokollausgabeprogramm für ein DB2SimpleDataSource -Objekt.
XAds: Das Protokollausgabeprogramm für ein DB2XADataSource -Objekt.

Wenn auch die Eigenschaft 'traceFile' angegeben wird, wird der Wert für 'traceDirectory' nicht verwendet.

Tracedatei

Gibt den Namen einer Datei an, in die der IBM Data Server Driver for JDBC and SQLJ Trace-Informationen schreibt. Der Datentyp dieser Eigenschaft ist String. Die Eigenschaft 'traceFile' ist eine Alternative zur Eigenschaft 'logWriter', mit der der Ausgabe-Trace-Datenstrom in eine Datei geleitet wird.

traceFileAppend

Gibt an, ob die Datei, die durch die Eigenschaft 'traceFile' angegeben wird, angehängt oder überschrieben werden soll. Der Datentyp dieser Eigenschaft ist boolesch. Der Standardwert ist false . Dies bedeutet, dass die Datei, die durch die Eigenschaft 'traceFile' angegeben wird, überschrieben wird.

Tracestufe

Gibt an, was zu verfolgen ist. Der Datentyp dieser Eigenschaft ist 'int'.

Sie können eine oder mehrere der folgenden Traces mit der Eigenschaft 'traceLevel' angeben:

com.ibm.db2.jcc.DB2BaseDataSource.TRACE_NONE ( X'00 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_CONNECTION_CALLS ( X'01 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_STATEMENT_CALLS ( X'02 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_RESULT_SET_CALLS ( X'04 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_DRIVER_CONFIGURATION ( X'10 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_CONNECTS ( X'20 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_DRDA_FLOWS ( X'40 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_RESULT_SET_META_DATA ( X'80 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_PARAMETER_META_DATA ( X'100 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_DIAGNOSTICS ( X'200 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_SQLJ ( X' 400 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_XA_CALLS (X'800') ( IBM Data Server Driver for JDBC and SQLJ type 2 connectivity for Db2 auf Linux-, UNIX-und Windows-Systemen only)
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_META_CALLS ( X'2000 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_DATASOURCE_CALLS ( X'4000 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_LARGE_OBJECT_CALLS ( X'8000 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_SYSTEM_MONITOR ( X'20000 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_TRACEPOINTS ( X'40000 ' )
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_SYSPLEX ( X'80000 ' ) (für Version 3.68 oder 4.18 oder höher von IBM Data Server Driver for JDBC and SQLJ und Verbindungen zu Db2 for z/OS-Gruppen mit gemeinsamer Datennutzung)
com.ibm.db2.jcc.DB2BaseDataSource.TRACE_ALL ( X'FFFFFFFF ' )

Wenn Sie mehr als einen Trace angeben möchten, verwenden Sie eine der folgenden Methoden:

Verwenden Sie Bitweises OR (|)-Operatoren mit zwei oder mehr Trace-Werten. Geben Sie zum Beispiel für die Trace-und Verbindungsaufrufe von DRDA diesen Wert für traceLevel an:
```
TRACE_DRDA_FLOWS|TRACE_CONNECTION_CALLS
```
Verwenden Sie einen bitweisen Ergänzungsoperator (~) mit einem Trace-Wert, um alle bis auf einen bestimmten Trace anzugeben. Wenn Sie z. B. alle Daten außer DRDA abführen möchten, geben Sie den folgenden Wert für traceLevel an:
```
 ~TRACE_DRDA_FLOWS
```

traceFileCount

Gibt die maximale Anzahl Tracedateien für die Umlauftracefunktion an. Der IBM Data Server Driver for JDBC and SQLJ verwendet diese Eigenschaft nur, wenn traceOption auf DB2BaseDataSource.TRACE_OPTION_CIRCULAR (1) gesetzt ist. Der Datentyp dieser Eigenschaft ist 'int'. Der Standardwert ist 2.

traceFileSize

Gibt die maximale Größe der einzelnen Tracedateidateien für die Umlauftracefunktion an. Der IBM Data Server Driver for JDBC and SQLJ verwendet diese Eigenschaft nur, wenn traceOption auf DB2BaseDataSource.TRACE_OPTION_CIRCULAR (1) gesetzt ist. Der Datentyp dieser Eigenschaft ist 'int'. Der Standardwert ist 10485760 (10 MB).

useJDBC41DefinitionForGetColumns

Gibt an, ob die Methode DatabaseMetaData.getColumns eine Ergebnismenge mit einer Spalte mit dem Namen SCOPE_CATALOG oder SCOPE_CATLOG zurückgibt. Folgende Werte sind möglich:

DB2BaseDataSource.NOT_SET (0): Gibt an, dass für Version 4.13 oder höher von IBM Data Server Driver for JDBC and SQLJ die Ergebnismenge von DatabaseMetaData.getColumns eine Spalte mit dem Namen SCOPE_CATALOG enthält. In Version 4.12 oder einer früheren Version von IBM Data Server Driver for JDBC and SQLJ heißt diese Spalte SCOPE_CATLOG.
DB2BaseDataSource.YES (1): Gibt an, dass für Version 4.13 oder höher von IBM Data Server Driver for JDBC and SQLJ die Ergebnismenge von DatabaseMetaData.getColumns eine Spalte mit dem Namen SCOPE_CATALOG enthält. In Version 4.12 oder einer früheren Version von IBM Data Server Driver for JDBC and SQLJ heißt diese Spalte SCOPE_CATLOG.
DB2BaseDataSource.NO (2): Gibt an, dass für alle Versionen des IBM Data Server Driver for JDBC and SQLJ s die Ergebnismenge von DatabaseMetaData.getColumns eine Spalte mit dem Namen SCOPE_CATLOG enthält.

traceOption

Gibt an, wie Tracedaten erfasst werden. Der Datentyp dieser Eigenschaft ist 'int'. Folgende Werte sind möglich:

DB2BaseDataSource.NOT_SET (0)

Gibt an, dass eine einzelne Tracedatei generiert wird und dass die Größe der Datei nicht begrenzt ist. Dieser Wert ist der Standardwert.

Wenn der Wert von 'traceOption' NOT_SET ist, werden die Eigenschaften 'traceFileSize' und 'traceFileCount' ignoriert.

DB2BaseDataSource.TRACE_OPTION_CIRCULAR (1)

Gibt an, dass der IBM Data Server Driver for JDBC and SQLJ die Umlauftracefunktion übernimmt. Die Umlaufverfolgung wird wie folgt durchgeführt:

Wenn eine Anwendung ihren ersten Tracesatz schreibt, erstellt der Treiber eine Datei.
Der Treiber schreibt Tracedaten in die Datei.
Wenn die Größe der Datei gleich dem Wert für die Eigenschaft traceFileSize ist, erstellt der Treiber eine andere Datei.
Der Treiber wiederholt die Schritte 2 und 3 , bis die Anzahl der Dateien, in die Daten geschrieben werden, gleich dem Wert der Eigenschaft 'traceFileCount' ist.
Der Treiber schreibt Daten in die erste Tracedatei und überschreibt die vorhandenen Daten.
Der Treiber wiederholt die Schritte 3 bis 5 , bis die Anwendung abgeschlossen ist.

Die Dateinamen für die Tracedateien sind die Dateinamen, die durch die Eigenschaft 'traceFile' oder 'traceDirectory' festgelegt werden. Der Dateiname wird mit .1 für die erste Datei, .2 für die zweite Datei und so weiter angehängt.

Benutzer

Die Benutzer-ID, die zum Herstellen von Verbindungen verwendet werden soll. Der Datentyp dieser Eigenschaft ist 'String'. Wenn Sie die Schnittstelle DataSource zum Herstellen einer Verbindung verwenden, können Sie diesen Eigenschaftswert überschreiben, indem Sie diese Form der Methode DataSource.getConnection aufrufen:

getConnection(benutzer, kennwort);

xaNetworkOptimization

Gibt an, ob die XA-Netzoptimierung für IBM Data Server Driver for JDBC and SQLJ type 4 connectivity aktiviert ist. Möglicherweise müssen Sie die XA-Netzoptimierung in einer Umgebung inaktivieren, in der ein XA-Start und ein XA-Ende von einem Java-Prozess ausgegeben werden, und eine XA-Vorbereitung und ein XA-Festschreiben werden von einem anderen Java-Prozess abgesetzt. Bei der XA-Netzoptimierung kann die XA-Vorbereitung die Datenquelle vor dem XA-Ende erreichen, was zu einem Fehler XAER_PROTO führt. Um zu verhindern, dass der XAER_PROTO-Fehler auftritt, inaktivieren Sie die XA-Netzoptimierung.

Der Standardwert ist true , d. es bedeutet, dass die XA-Netzoptimierung aktiviert ist. Wenn 'xaNetworkOptimization' den Wert false hat, bedeutet dies, dass die XA-Netzoptimierung inaktiviert ist. Der Treiber schließt alle geöffneten Cursor auf XA-Endzeit.

xaNetworkOptimization kann für ein DataSource -Objekt oder im Parameter url in einem Aufruf getConnection festgelegt werden. Der Wert von xaNetworkOptimization kann nicht geändert werden, nachdem eine Verbindung hergestellt wurde.