Angepasste Eigenschaften der Serviceintegration

Sie verwenden angepasste Eigenschaften, um erweiterte Einstellungen für Serviceintegrationsobjekte wie Messaging-Engines zu konfigurieren.

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 High Availability Manager stoppt die Messaging-Engine und ihren Hostanwendungsserver, wenn die nächste Prüfung des Typs Ist aktiv des Stammgruppenservice stattfindet (der Standardwert sind 120 Sekunden). Wenn der Server von einem Node Agent überwacht wird und Sie den automatischen Neustart in der Überwachungsrichtlinie für den Server aktiviert haben, wird der Server erneut gestartet. Die Messaging-Engine wird gestartet, wenn ein entsprechender Server verfügbar ist.
Anmerkung: Nachrichten, die eine geringere Zuverlässigkeitsstufe als "Garantiert, persistent" haben, werden von der Messaging-Engine möglicherweise in der Zeit zwischen den Prüfungen Ist aktiv akzeptiert und können verloren gehen.
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
[z/OS]

sib.ra.zosMessageLockTimeout

Gibt an, wie lange (in Sekunden) die Nachricht in der Messaging-Engine gesperrt bleibt, nachdem diese Nachricht zur Zustellung an eine MDB an Workload Management (WLM) for z/OS übergeben wurde.

WLM ordnet die Nachricht einer Servantregion zu, die eine Verbindung zur Messaging-Engine herstellt. Die Servantregion konsumiert die Nachricht und übergibt sie an die Methode "onMessage" der Message-driven Bean.

Falls die Servantregion keine Verbindung zur Messaging-Engine herstellen kann und die Nachricht konsumiert, bevor diese an die Message-driven Bean übergeben wird, bleibt die Nachricht so lange gesperrt, bis das Zeitlimit erreicht ist. Nach Ablauf des Zeitlimits wird die Nachricht freigegeben und die Zustellung wiederholt.

Wenn WLM eine Nachricht während des Starts eines Anwendungsservers einer Servantregion zustellt, bevor die für die Verbindungsherstellung zur Messaging-Engine erforderliche Infrastruktur verfügbar ist, kann diese Servantregion möglicherweise keine Verbindung zu einer Messaging-Engine herstellen. Verbindungsfehler dieses Typs sind an CWSIV1052W-Einträgen im Jobprotokoll der Servantregion erkennbar. Wenn Sie solche Einträge im Jobprotokoll sehen, sollten Sie die Verwendung dieser Eigenschaft in Erwägung ziehen, um das Zeitlimit für die Sperre der Nachrichten zu reduzieren.

Datentyp Standardeinstellung
Sekunden 300

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.

[z/OS]Anmerkung:

Wenn eine Servant-Region während der Verarbeitung einer Nachricht abnormal beendet wird, startet die Steuerregion eine neue Servant-Region, die auf die Freigabe der Sperre warten muss, bevor sie die Verarbeitung der Nachricht fortsetzen kann. Ist die Servant-Region zu lange inaktiv, beendet die Steuerregion sie und startet eine andere Servant-Region. Wenn die Servant-Region für die Verarbeitung einer Nachricht sehr viel Zeit benötigt, kann die Steuerregion die Servant-Region als inaktiv einstufen und daraufhin beenden.

Wie lange eine Servant-Region inaktiv sein kann, bevor die Steuerregion sie beendet, wird durch verschiedene Zeitlimits, wie z. B. die Eigenschaft "control_region_wlm_dispatch_timeout" beeinflusst. Überprüfen Sie die Konfiguration Ihres Systems, um die zulässige Inaktivitätszeit für dieses System festzulegen.

Um zu verhindern, dass die Steuerregion die Servant-Region beendet, bevor die Nachricht verarbeitet wurde, setzen Sie den Wert der Eigenschaft für das Tokensperrzeitlimit auf einen Wert, der kleiner ist als zulässige Inaktivitätszeit der Servant-Region.

Information Wert
Datentyp Millisekunden
Standardeinstellung 600000 (10 Minuten)

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjj_custom_props
Dateiname:rjj_custom_props.html