Angepasste Eigenschaften des Nachrichten-Listener-Service
Verwenden Sie diese Anzeige, um die angepassten Eigenschaften des Nachrichten-Listener-Service anzuzeigen oder zu ändern.
Klicken Sie zum Anzeigen dieser Seite der Administrationskonsole auf .
- DYNAMIC.CONFIGURATION.ENABLED
ENABLE.ZOS.LP.RECOVERY
- MAX.RECOVERY.RETRIES
- MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH
- MQJMS.POOLING.THRESHOLD
- MQJMS.POOLING.TIMEOUT
- NON.ASF.RECEIVE.TIMEOUT
- NON.ASF.BMT.ROLLBACK.ENABLED
- RECOVERY.RETRY.INTERVAL
- SERVER.SESSION.POOL.REAP.TIME
- SERVER.SESSION.POOL.UNUSED.TIMEOUT
- SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname
DYNAMIC.CONFIGURATION.ENABLED
Diese Eigenschaft steuert, ob der Anwendungsserver, in dem ein Listener-Port erstellt wird, erneut gestartet werden muss. Setzen Sie diese Eigenschaft auf "true", um die dynamische Konfiguration zu aktivieren.
Information | Wert |
---|---|
Datentyp | Boolean |
Standardwert | False (nicht ausgewählt) |
![[z/OS]](../images/ngzos.gif)
ENABLE.ZOS.LP.RECOVERY
Diese Eigenschaft steuert das Verhalten der Listener-Ports, wenn ein Anwendungsserver eine Verbindung zu WebSphere MQ for z/OS herstellt.
- Einen Listener-Port, der eine Wiederherstellung versucht, wenn eine Verbindung zwischen dem Anwendungsserver und WebSphere MQ unterbrochen wurde, z. B., weil der Warteschlangenmanager gestoppt wurde. Wenn Sie diese Eigenschaft nicht aktivieren, versucht der Listener-Port keine Wiederherstellung, nachdem ein Warteschlangenmanager gestoppt wurde.
- Konfiguration mehrerer Workload-Management-Klassifikationen für einen Listener-Port. Wenn Sie diese Eigenschaft nicht aktivieren, bleiben Nachrichten in der WebSphere MQ-Warteschlange, wenn mehrere Workload-Management-Klassifikationen für einen Listener-Port konfiguriert sind.
Starten Sie den Server erneut, nachdem Sie die Eigenschaft hinzugefügt haben.
Wenn Sie eine Verbindung zu WebSphere MQ for z/OS über Bindungsverbindungen herstellen, müssen Sie auch WebSphere MQ APAR PK53912 anwenden. Dieser APAR wird in WebSphere MQ Version 6.0.2.4 bereitgestellt.
Information | Wert |
---|---|
Datentyp | Boolean |
Standardwert | True (Ausgewählt) |
MAX.RECOVERY.RETRIES
Gibt an, wie oft ein von diesem Service verwalteter Listener-Port maximal einen Wiederanlaufversucht startet. Wenn der zugehörige Listener-Port gestoppt wird, wechselt er in den Stoppstatus. Die Zeit zwischen den Wiederholungsversuchen wird mit der Eigenschaft RECOVERY.RETRY.INTERVAL definiert.
- Beim Abrufen einer Nachricht vom JMS-Provider ist ein unerwarteter Fehler aufgetreten.
- Die Verbindung zwischen dem Anwendungsserver und dem JMS-Provider ist (aufgrund eines Netzfehlers) unterbrochen worden.
Information | Wert |
---|---|
Datentyp | Integer |
Einheiten | Wiederholungsversuche |
Standardwert | 5 |
Einstellmöglichkeiten | 0 (keine Wiederholungen) bis 2147483647 |
MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH
Ein Regulierungsanzeiger, der ermöglicht, dass die Verarbeitung von Controllernachrichten fortgesetzt wird, wenn der untere Schwellenwert für Nachrichten erreicht wird. Wenn der Nachrichten-Listener-Service mit der angepassten Eigenschaft "MDB.THROTTLE.THRESHOLD.LOW.EQUALS.HIGH" konfiguriert und auf den Wert "true" gesetzt wurde, wird der untere Schwellenwert intern auf den oberen Schwellenwert gesetzt (bei dem es sich um die extern festgelegte Eigenschaft für die maximale Anzahl an Sitzungen des Listener-Ports handelt).
Information | Wert |
---|---|
Datentyp | String |
Standardwert | True |
MQJMS.POOLING.THRESHOLD
Die Maximalanzahl der nicht verwendeten Verbindungen im Pool.
Ein MQSimpleConnectionManager ordnet die Verbindungen, die am häufigsten verwendet werden, zu und löscht die Verbindungen, die am seltensten verwendet werden. Die Standardeinstellung sieht vor, dass eine Verbindung gelöscht wird, wenn mehr als zehn nicht verwendete Verbindungen im Pool vorhanden sind.
Information | Wert |
---|---|
Datentyp | Integer |
Einheiten | Anzahl der Verbindungen |
Standardwert | 10 |
MQJMS.POOLING.TIMEOUT
Der Zeitraum (in Millisekunden), nach dem eine Verbindung im Pool gelöscht wird, wenn sie nicht verwendet wurde.
Ein MQSimpleConnectionManager ordnet die Verbindungen, die am häufigsten verwendet werden, zu und löscht die Verbindungen, die am seltensten verwendet werden. Die Standardeinstellung sieht vor, dass eine Verbindung gelöscht wird, wenn sie fünf Minuten nicht verwendet wurde.
Information | Wert |
---|---|
Datentyp | Integer |
Einheiten | Millisekunden |
Standardwert | 5 Minuten |
NON.ASF.RECEIVE.TIMEOUT
Diese Eigenschaft legt das Zeitlimit (in Millisekunden) für den Empfang von Synchronnachrichten in MDB-Listener-Sitzungen im Betriebsmodus ohne ASF fest.
- Der ASF-Modus bietet Parallelität Zugriff und Transaktionsunterstützung für Anwendungen. Aufgrund des besseren Durchsatzes und der Unterstützung der Parallelität empfiehlt sich der ASF-Modus für Pub/Sub-MDBs. Im Modus ohne ASF hat der Listener nur einen Thread.
- Der Modus ohne ASF ist hauptsächlich für Messaging-Provider von Fremdanbietern bestimmt, die JMS-ASF, eine optionale Erweiterung der JMS-Spezifikation, nicht unterstützen. Der Modus ohne ASF bietet zwar auch Transaktionsunterstützung, aber aufgrund des im Vergleich mit dem ASF-Modus kürzeren Weges in der Regel eine bessere Leistung.
Setzen Sie diese Eigenschaft auf einen Wert ungleich null, wenn Sie den Betriebsmodus ohne ASF für alle MDB-Listener im Anwendungsserver aktivieren möchten.
Der Nicht-ASF-Modus kann auf z/OS-Systemen nicht ausgewählt werden.
Deshalb dürfen Sie in diesem Fall keinen Wert ungleich null für diese Eigenschaft angeben.
Wenn Ihr Messaging-System im Modus ohne ASF ausgeführt wird, müssen Sie, um nicht erwünschte Transaktionszeitlimitis zu vermeiden, ausreichend Zeit für die Verarbeitung zulassen, bevor das Zeitlimit für die Gesamtlebensdauer der Transaktion erreicht wird. Vergewissern Sie sich, dass der für die angepasste Eigenschaft NON.ASF.RECEIVE.TIMEOUT des Nachrichten-Listener-Service angegebene Wert kleiner ist als der Wert für die Eigenschaft Zeitlimit für Gesamtlebensdauer der Transaktion des Transaktionsservice und dass die Differenz zwischen den Werten der zwei Eigenschaften größer ist als der Wert für den Zeitraum, den die Methode onMessage() Ihrer MDB benötigt, um die Nachricht zu verarbeiten.
Hat Ihre MDB-Methode onMessage() gewöhnlich eine maximale Dauer von 10 Sekunden und ist das Transaktionszeitlimit auf 120 Sekunden gesetzt, können Sie die Eigenschaft NON.ASF.RECEIVE.TIMEOUT auf maximal 110000 Millisekunden (d. h. 110 Sekunden) setzen.
Information | Wert |
---|---|
Datentyp | Integer |
Einheiten | Millisekunden |
Standardwert | ASF-Modus (keine Erstellung angepasster Eigenschaften) |
Einstellmöglichkeiten | 0 Millisekunden oder höher
|
NON.ASF.BMT.ROLLBACK.ENABLED
Wenn die Betriebsart ohne ASF verwendet wird (weil Sie die Eigenschaft NON.ASF.RECEIVE.TIMEOUT auf einen Wert ungleich null gesetzt haben) und eine Message-driven Bean, die Bean-gesteuerte Transaktionen verwendet, eine Laufzeitausnahme generiert, bestimmt die Eigenschaft NON.ASF.BMT.ROLLBACK.ENABLED, ob Nachrichten an das Ziel zurückgegeben werden.
- Der ASF-Modus bietet Parallelität Zugriff und Transaktionsunterstützung für Anwendungen. Aufgrund des besseren Durchsatzes und der Unterstützung der Parallelität empfiehlt sich der ASF-Modus für Pub/Sub-MDBs. Im Modus ohne ASF hat der Listener nur einen Thread.
- Der Modus ohne ASF ist hauptsächlich für Messaging-Provider von Fremdanbietern bestimmt, die JMS-ASF, eine optionale Erweiterung der JMS-Spezifikation, nicht unterstützen. Der Modus ohne ASF bietet zwar auch Transaktionsunterstützung, aber aufgrund des im Vergleich mit dem ASF-Modus kürzeren Weges in der Regel eine bessere Leistung.
Der Modus ohne ASF kann auf z/OS-Systemen nicht ausgewählt werden.
Wenn Sie diese Eigenschaft auf false (Standardeinstellung) setzen, wird die Nachricht automatisch bestätigt, bevor sie an die Message-driven Bean übergeben wird.
Wenn Sie diese Eigenschaft auf true setzen, sendet der Nachrichten-Listener-Service eine Nachrichtenbestätigung an den Client, nachdem die Nachricht erfolgreich von der Message-driven Bean verarbeitet wurde und der Nachrichten-Listener-Service die Wiederherstellung aller Nachrichten angefordert hat, für die die Bean eine Ausnahme generiert.
Information | Wert |
---|---|
Datentyp | Boolean |
Standardwert | False |
RECOVERY.RETRY.INTERVAL
Gibt die Wartezeit (in Sekunden) zwischen den Wiederholungsversuchen für einen Wiederanlauf nach einem Fehler eines Listener-Port an. Die maximale Anzahl der Versuche wird mit der angepassten Eigenschaft MAX.RECOVERY.RETRIES definiert.
- Beim Abrufen einer Nachricht vom JMS-Provider ist ein unerwarteter Fehler aufgetreten.
- Die Verbindung zwischen dem Anwendungsserver und dem JMS-Provider ist (aufgrund eines Netzfehlers) unterbrochen worden.
Information | Wert |
---|---|
Datentyp | Integer |
Einheiten | Sekunden |
Standardwert | 60 |
Einstellmöglichkeiten | 1 bis 2147483647 |
SERVER.SESSION.POOL.REAP.TIME
Die Zeit (in Sekunden) zwischen den Überprüfungen der Serversitzungspools. Zum Aktivieren der Überwachung der Serversitzungspools setzen Sie diese Eigenschaft auf einen nicht negativen Wert.
Die angepasste Eigenschaft SERVER.SESSION.POOL.REAP.TIME ist nicht gültig, wenn Ihr Messaging-System nicht im ASF-Modus ausgeführt wird.
Information | Wert |
---|---|
Datentyp | Integer |
Einheiten | Sekunden |
Standardwert | -1 (inaktiviert) |
Einstellmöglichkeiten | -2147483648 bis 2147483647 |
SERVER.SESSION.POOL.UNUSED.TIMEOUT
Das Standardzeitlimit für Serversitzungspools in Sekunden.
Wenn diese Eigenschaft auf einen nicht negativen Wert gesetzt wird, wird es mit der Zeit verglichen, die seit der Verwendung der Serversitzung abgelaufen ist. Ist der Zeitlimitwert kleiner als die abgelaufene Zeit, wird die Serversitzung aus dem Serversitzungspool entfernt, und die JMS-Sitzung wird an den JMS-Sitzungspool zurückgegeben. Wenn der Zeitlimitwert beispielsweise eine Sekunde beträgt und die seit der Verwendung einer bestimmten Serversitzung abgelaufene Zeit zwei Sekunden beträgt, wird diese Serversitzung aus dem Serversitzungspool entfernt, und die JMS-Sitzung wird an den JMS-Sitzungspool zurückgegeben.
Die angepasste Eigenschaft SERVER.SESSION.POOL.UNUSED.TIMEOUT ist nicht gültig, wenn Ihr Messaging-System nicht im ASF-Modus ausgeführt wird.
Information | Wert |
---|---|
Datentyp | Integer |
Einheiten | Sekunden |
Standardwert | -1 (inaktiviert) |
Einstellmöglichkeiten | -2147483648 bis 2147483647 |
SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname
Diese Eigenschaft überschreibt den Standardwert der Eigenschaft SERVER.SESSION.POOL.UNUSED.TIMEOUT für den Listener-Port mit dem Namen lpname. Dieser Wert gilt für alle Message-driven Beans, die den angegebenen Listener-Port verwenden.
Wenn der Korrekturwert ein nicht negativer Wert ist, wird der Wert von SERVER.SESSION.POOL.UNUSED.TIMEOUT auch dann überschrieben, wenn SERVER.SESSION.POOL.UNUSED.TIMEOUT einen negativen Wert hat.
Wenn der Korrekturwert ein negativer Wert ist, wird die Überwachung der Serversitzungspools für den angegebenen Listener-Port inaktiviert.
Die angepasste Eigenschaft SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname ist nicht gültig, wenn Ihr Messaging-System nicht im ASF-Modus ausgeführt wird.
Information | Wert |
---|---|
Datentyp | Integer |
Einheiten | Sekunden |
Standardwert | Nicht definiert |
Einstellmöglichkeiten | -2147483648 bis 2147483647 |