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 Server > Servertypen > WebSphere-Anwendungsserver > Servername > [Kommunikation] Messaging > Nachrichten-Listener-Service > Angepasste Eigenschaften.

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]

ENABLE.ZOS.LP.RECOVERY

Diese Eigenschaft steuert das Verhalten der Listener-Ports, wenn ein Anwendungsserver eine Verbindung zu WebSphere MQ for z/OS herstellt.

Aktivieren Sie diese Eigenschaft, wenn Ihre Umgebung eine der folgenden Funktionen erfordert:
  • 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.

Ein Fehler kann durch die folgenden Bedingungen hervorgerufen werden:
  • 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.

Anmerkung: Der Nachrichten-Listener-Service hat zwei Betriebsmodi: ASF (Application Server Facilities) und ohne ASF (Non-Application Server Facilities):
  • 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.

[z/OS]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
0
Modus ohne ASF ist inaktiviert
1 oder mehr
Das Zeitlimit (in Millisekunden) für den Empfang von Synchronnachrichten in MDB-Sitzungen im Modus ohne ASF.

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.

Anmerkung: Der Nachrichten-Listener-Service hat zwei Betriebsmodi: ASF (Application Server Facilities) und ohne ASF (Non-Application Server Facilities):
  • 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.

[z/OS]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.

Ein Fehler kann durch die folgenden Bedingungen hervorgerufen werden:
  • 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

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=umb_prolscp
Dateiname:umb_prolscp.html