Angepasste Eigenschaften der Serviceintegration
Sie verwenden angepasste Eigenschaften, um erweiterte Einstellungen für Serviceintegrationsobjekte wie Messaging-Engines zu konfigurieren.
- sib.msgstore.cachedDataBufferSize
- sib.msgstore.discardableDataBufferSize
- sib.msgstore.jdbcFailoverOnDBConnectionLoss
- sib.msgstore.jdbcInitialDatasourceWaitTimeout
- sib.msgstore.jdbcResAuthForConnections
- sib.msgstore.jdbcStaleConnectionRetryDelay
- sib.meEnableInstanceOnFailure
- sib.processor.maxReconstituteThreadpoolSize
- sib.msgstore.storeFullWaitForCheckPoint
- sib.msgstore.transactionSendLimit
- sib.trm.retry
- sib.wsrm.tokenLockTimeout
sib.msgstore.cachedDataBufferSize
Die Größe des Datenpuffers, der von der Messaging-Engine verwendet wird, um Daten zu speichern, deren Servicequalitätsattribut besser ist als Bestmöglich, nicht persistent und die im Datenspeicher gehalten werden. Der Standardwert ist 320000. Dies sind ungefähr 320 Kilobytes.
Der Zweck dieses Datenpuffers ist die Optimierung der Leistung der Messaging-Engine. Die Zwischenspeicherung der Daten, die die Messaging-Engine unter Umständen benötigt, bewirkt, dass diese nicht aus dem Datenspeicher eingelesen werden müssen. Während die Daten in den Datenspeicher geschrieben und aus dem Datenspeicher gelesen werden, versucht die Messaging-Engine, diese Daten dem zwischengespeicherten Datenpuffer hinzuzufügen. Die Messaging-Engine kann bereits im Puffer abgelegte Daten verwerfen, wenn Speicherplatz benötigt wird.
| Datentyp | Standardeinstellung |
|---|---|
| Bytes | 40000000 |
sib.msgstore.discardableDataBufferSize
Die Größe des Datenpuffers (in Bytes), der von der Messaging-Engine verwendet wird, um Daten mit dem Servicequalitätsattribut "Bestmöglich, nicht persistent" zu speichern. Der Standardwert ist 320000. Dies sind ungefähr 320 Kilobytes.
Der löschbare Datenpuffer enthält alle Daten mit dem Servicequalitätsattribut "Bestmöglich, nicht persistent". Dazu gehören Daten, die an aktiven Transaktionen beteiligt sind, und alle Daten vom Typ "Bestmöglich, nicht persistent", die die Messaging-Engine weder verworfen noch konsumiert hat. Die Messaging-Engine hält diese Daten nur in diesem Speicher und schreibt sie nie in den Datenspeicher. Wenn die Messaging-Engine dem Puffer für verwerfbare Daten Daten hinzufügt, z. B. wenn sie eine Nachricht vom Typ "Bestmöglich, nicht persistent" von einem Client empfängt, kann sie bereits im Puffer enthaltene Daten verwerfen, um Platz zu schaffen. Die Messaging-Engine kann nur Daten verwerfen, die nicht an aktiven Transaktionen beteiligt sind. Dieses Verhalten ermöglicht der Messaging-Engine, Nachrichten vom Typ "Bestmöglich, nicht persistent" zu verwerfen.
Wenn Sie die Größe des Puffers für verwerfbare Daten erhöhen, können mehr Daten vom Typ "Bestmöglich, nicht persistent" bearbeitet werden, bevor die Messaging-Engine beginnt, Nachrichten zu verwerfen.
Wenn die Messaging-Engine versucht, Daten zu einem löschbaren Datenpuffer hinzuzufügen, und nicht genügend Speicherplatz verfügbar ist, nachdem alle Daten, die nicht an aktiven Transaktionen beteiligt sind, verworfen wurden, löst die Messaging-Engine eine Ausnahme des Typs com.ibm.ws.sib.msgstore.OutOfCacheSpace aus. Clientanwendungen können diese Ausnahme in API-spezifischen Ausnahmen wie "javax.jms.JMSException" abfangen.
| Datentyp | Standardeinstellung |
|---|---|
| Bytes | 1280000 |
sib.msgstore.jdbcFailoverOnDBConnectionLoss
Diese Eigenschaft bestimmt das Verhalten der Messaging-Engine und ihres Host-Servers für den Fall, dass die Verbindung zum Datenspeicher verloren geht.
| Eigenschaftswert | Verhalten beim Verlust der Verbindung zum Datenspeicher |
|---|---|
| true (Standardeinstellung) | Der Server wird heruntergefahren und muss manuell erneut gestartet werden. |
| false | Die Messaging-Engine wird weiterhin ausgeführt und akzeptiert Anforderungen und versucht in regelmäßigen Abständen erneut, die Verbindung zum Datenspeicher wiederherzustellen. Werden weitere Anforderungen an die Messaging-Engine übergeben, während der Datenspeicher nicht verfügbar ist, können die Ergebnisse unvorhersehbar sein, und die Messaging-Engine kann einen inkonsistenten Zustand aufweisen, wenn die Verbindung zum Datenspeicher wiederhergestellt wird. Anmerkung: Wenn weitere Anforderungen an die Messaging-Engine
übergeben werden, kann selbst das nicht persistente Messaging scheitern, weil die Messaging-Engine
den Datenspeicher möglicherweise verwenden muss, um beispielsweise einer Nachricht
eine eindeutige ID zuzuordnen oder um nicht persistente Nachrichten aus dem Speicher zu verschieben.
|
sib.msgstore.jdbcInitialDatasourceWaitTimeout
Diese Eigenschaft legt fest, wie lange (Millisekunden) auf die Verfügbarkeit des Datenspeichers gewartet wird. Diese Zeit umfasst die Zeit, die erforderlich ist, um eine Verbindung zur Datenbank herzustellen und um die erforderlichen Tabellensperren anzufordern.
| Datentyp | Standardeinstellung |
|---|---|
| Millisekunden | 900000 (15 Minuten) |
sib.msgstore.jdbcResAuthForConnections
Der Ressourcenberechtigungsmechanismus der Messaging-Engine, der bei der gemeinsamen Nutzung von Verbindungen verwendet wird. Der Standardwert ist "Container".
| Datentyp | Standardeinstellung |
|---|---|
| Zeichenfolge | Container |
sib.msgstore.jdbcStaleConnectionRetryDelay
Diese Eigenschaft legt fest, wie lange (Minuten) zwischen den einzelnen Versuchen, eine Verbindung zum Datenspeicher herzustellen, gewartet wird.
Wenn Sie die Eigenschaft "sib.msgstore.jdbcInitialDatasourceWaitTimeout" beispielsweise auf 600000 und die Eigenschaft "sib.msgstore.jdbcStaleConnectionRetryDelay" auf 3000 setzen, versucht die Messaging-Engine, über einen Zeitraum von 10 Minuten hinweg alle 3 Sekunden, eine Verbindung aufzubauen.
| Information | Wert |
|---|---|
| Datentyp | Millisekunden |
| Standardeinstellung | 2000 (2 Sekunden) |
sib.meEnableInstanceOnFailure
Die Eigenschaft bestimmt, ob die inaktivierte Messaging-Engine erneut automatisch aktiviert werden muss, falls die Messaging-Engine die Verbindung zum Datenspeicher verliert.
Wenn Sie die Eigenschaft "sib.meEnableInstanceOnFailure" beispielsweise auf "true" setzen, versucht die inaktivierte Messaging-Engine nach 30 Sekunden, sich zu aktivieren.
| Information | Wert |
|---|---|
| Datentyp | Boolean |
| Standardeinstellung | True |
sib.processor.maxReconstituteThreadpoolSize
Diese Einstellung gibt an, wie viele Threads beim Start der Messaging-Engine gleichzeitig zum Laden von Zielen verwendet werden. Falls Ihre Datenbank keine parallelen Lesezugriffe durch mehrere Threads zulässt, können Sie diese Eigenschaft auf "1" setzen, damit Konflikte zwischen Threads vermieden werden können.
| Information | Wert |
|---|---|
| Datentyp | Integer |
| Standardeinstellung | Die Anzahl der Kerne im System. |
sib.msgstore.storeFullWaitForCheckPoint
Diese Eigenschaft legt die Aktion fest, die eine Messaging-Engine ausführt, wenn ein Dateispeicher voll ist und die Anwendungen versuchen, weitere Nachrichten zu senden.
Wenn ein Dateispeicher voll ist, setzt die Messaging-Engine einen Prüfpunkt der Protokolldatei, um alle Nachrichten, die seit dem letzten Prüfpunkt gesendet und empfangen wurden, auszugleichen. Dieser Prozess kann einige Zeit dauern. Wenn zwischen dem Zeitpunkt, zu dem der Dateispeicher voll ist, und dem Zeitpunkt, zu dem der Prüfpunkt abgeschlossen ist, Anwendungen versuchen, eine Nachricht zu senden, löst die Messaging-Engine die Ausnahmebedingung ObjectStoreFullException aus und setzt die Nachricht CWSOM1042E ab.
Wenn ein Anwendungsthread, der eine Nachricht sendet, feststellt, dass die Datei voll ist, fordert er einen Prüfpunkt an. Wenn die Eigenschaft mit den Wert "false" hat, setzt der Anwendungsthread unverzüglich die Ausnahme ObjectStoreFullException an die Anwendung ab und gibt dann Daten zurück. Sie können ein alternatives Verhalten auswählen, indem Sie den Eigenschaftswert auf "true" setzen. Wenn dieser Eigenschaftswert gesetzt ist, löst der Anwendungsthread die Ausnahme nicht aus, sondern wartet, bis der Prüfpunkt abgeschlossen ist. Wenn der Prüfpunkt Speicherplatz im Dateispeicher freimachen kann, fährt der Anwendungsthread fort und sendet die Nachrichten, bevor er Daten zurückgibt. Wenn der Datenspeicher nach dem Prüfpunkt immer noch voll ist, setzt der Anwendungsthread die Ausnahme an die Anwendung ab.
Setzen Sie den Eigenschaftswert auf "true", und lassen Sie Anwendungsthreads warten, bis der Prüfpunkt abgeschlossen ist, falls Ihre Anwendungen alle Nachrichen im Dateispeicher löschen, damit sie die Informationen erhalten, dass der Dateispeicher nicht mehr voll ist. Die Anwendungen müssen zwar warten, bis der Prüfpunkt abgeschlossen ist, empfangen jedoch während der Ausführung des Prüfpunkts keine Ausnahmen und müssen auch keine Sendevorgänge wiederholen.
| Information | Wert |
|---|---|
| Datentyp | Boolean |
| Standardeinstellung | False |
sib.msgstore.transactionSendLimit
Die maximale Anzahl von Operationen, die die Messaging-Engine in jede Transaktion einschließt. Jeder JMS-Sende- und Empfangsvorgang ist beispielsweise eine Operation, die hier gezählt wird. Der Standardwert ist 100.
| Datentyp | Standardeinstellung |
|---|---|
| Integer | 100 |
sib.trm.retry
Das Wiederholungsintervall für eine Verbindung zwischen einer Messaging-Engine und einer Messaging-Engine in Sekunden. Das Wiederholungsintervall ist die Zeitverzögerung zwischen aufeinander folgenden Versuchen, eine Verbindung zwischen benachbarten Messaging-Engines aufzubauen, zwischen denen die Kommunikation möglich sein sollte. Das Standardwiederholungsintervall sind 30 Sekunden.
| Datentyp | Standardeinstellung |
|---|---|
| Sekunden | 30 |
sib.wsrm.tokenLockTimeout
Diese Eigenschaft wirkt sich auf die von WS-ReliableMessaging verwalteten Servicequalitäten aus. Definieren Sie diese Eigenschaft in der Messaging-Engine, die in der Richtlinienbindung für die WS-ReliableMessaging-Anwendung angegeben ist.
Diese Eigenschaft legt fest, wie lange (in Millisekunden) eine WS-ReliableMessaging-Nachricht gesperrt bleibt. Wenn ein Server während der Verarbeitung einer Nachricht ausfällt, wird die Sperre nach Ablauf dieser Zeit freigegeben, damit andere Server die Verarbeitung fortsetzen können. Sollte der ursprüngliche Server vor Ablauf dieser Zeit wiederhergestellt sein, setzt er die Verarbeitung der Nachricht fort. Die Sperre wird nach Ablauf der Zeit auch dann freigegeben, wenn die Nachricht noch verarbeitet wird.
Wenn Ihr System große Nachrichten verarbeitet, können Sie den Wert dieser Eigenschaft erhöhen. Dauert die Verarbeitung einer Nachricht beispielsweise 12 Minuten, wird die Sperre zwei Minuten vor Abschluss der Verarbeitung freigegeben. Um eine solche Situation zu vermeiden, legen sie einen Wert für die Eigenschaft fest, der größer ist als 12 Minuten.
Wenn Ihr System kleine Nachrichten verarbeitet, können Sie den Wert dieser Eigenschaft verringern, damit die Sperre bei Ausfällen schneller freigegeben wird und andere Server die Verarbeitung der Nachricht ohne Verzögerung fortsetzen können.
| Information | Wert |
|---|---|
| Datentyp | Millisekunden |
| Standardeinstellung | 600000 (10 Minuten) |
Referenzartikel