Befehl "modifySIBEngine"
Verwenden Sie den Befehl modifySIBEngine, um die Eigenschaften einer Messaging-Engine für ein SIB-Member zu ändern.
Verwenden Sie zum Ausführen des Befehls das Objekt AdminTask des Scripting-Clients wsadmin.
Der Scripting-Client wsadmin wird über die Qshell ausgeführt.
Weitere Informationen finden Sie unter Qshell für die Ausführung von WebSphere-Scripts mit wsadmin-Scripting konfigurieren.
- Geben Sie den folgenden Befehl an der wsadmin-Eingabeaufforderung ein, um eine Liste der verfügbaren SIB-Befehle in Jython und eine Kurzbeschreibung jedes einzelnen Befehls anzuzeigen:
print AdminTask.help('SIBAdminCommands')
- Zum Anzeigen einer übersichtlichen Hilfe zu einem bestimmten Befehl geben Sie an der
wsadmin-Eingabeaufforderung den folgenden Befehl ein:
print AdminTask.help('Befehlsname')
AdminConfig.save()
Zweck
Dieser Befehl ändert die Eigenschaften einer Messaging-Engine.
Zielobjekt
Eine Messaging-Engine.
Erforderliche Parameter
- -bus Busname
- Der Name des Service Integration Bus, in dem das Busmember konfiguriert ist. Mit dem Befehl listSIBuses können Sie die Namen vorhandener Busse auflisten.
Vorgegebene Parameter
- -node Knotenname -server Servername
- Wenn Sie die Eigenschaften einer Messaging-Engine für einen Anwendungsserver als Busmember ändern möchten, geben Sie den Namen des Knotens, auf dem der Server ausgeführt wird, und den Namen des Servers an.
- -cluster Cluster
- Wenn Sie die Eigenschaften einer Messaging-Engine für einen Server-Cluster als Busmember ändern möchten, geben Sie den Namen des Clusters an.
- -engine Name_der_Engine
- Wenn das Busmember nur eine Messaging-Engine hat, müssen Sie den Namen der Engine nicht angeben. Wenn das Busmember mehrere Messaging-Engines hat, müssen Sie den Namen der Engine angeben, deren Eigenschaften Sie ändern möchten.
Optionale Parameter
- -description Text
- Eine optionale Beschreibung der Messaging-Engine für Verwaltungszwecke.
- -initialState STARTED | STOPPED
- Der Anfangsstatus bestimmt, ob die Messaging-Engine automatisch gestartet wird,
wenn der Server bzw. das Server-Cluster gestartet wird.
- Gestoppt
- Wenn der zugehörige Anwendungsserver gestartet ist, ist die Messaging-Engine gestoppt und kann keine Nachrichten verarbeiten.
- Gestartet
- Wenn der zugehörige Anwendungsserver gestartet ist, ist die Messaging-Engine gestartet und in der Lage, Nachrichten zu verarbeiten.
- -highMessageThreshold Anzahl
- Die maximale Anzahl von Nachrichten, die die Messaging-Engine an diesen Nachrichtenpunkten speichern kann.
Beim Erstellen der Messaging-Engine wird der obere Schwellenwert für Nachrichten des Busses verwendet, um den Standardwert für diese Eigenschaft zu definieren. Wenn ein Nachrichtenpunkt in dieser Messaging-Engine erstellt wird, wird der Wert dieser Eigenschaft verwendet, um den oberen Standardschwellenwert für Nachrichten für den Nachrichtenpunkt festzulegen.
- -restrictLongDBLock TRUE | FALSE
- Dieser Parameter
gibt an, ob die aktive Messaging-Engine Sperren mit langer Laufzeit in der Tabelle
SIBOWNER in der Datenbank beibehalten muss.Wenn Sie diese Option auswählen, richtet die Messaging-Engine nur kurze Sperren für die Datenbank ein.
Wenn die aktive Messaging-Engine nicht auf die Datenbank reagiert, kann die
Standby-Messaging-Engine das Eigentumsrecht an der Datenbank übernehmen, weil die aktive
Messaging-Engine nur kurze Sperren setzt. Dieser Parameter hat zwei gültige Werte:
- TRUE
- Sperren mit langer Laufzeit in der Datenbank beschränken
- FALSE
- Sperren mit langer Laufzeit in der Datenbank nicht beschränken
Verwenden Sie diesen Parameter, wenn der Parameter -dataStore angegeben ist.
Wichtig: Trotz Auswahl der Eigenschaft ist die Eigenschaft erst wirksam, nachdem ein Upgrade der Datenbanktabellen mit dem Befehl sibDBUpgrade für WebSphere Application Server Version 9.0 und höher durchgeführt wurde.
Beispiel
wsadmin>AdminTask.showSIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 ]')
'{initialState=STARTED, targetGroups=[], name=node01.server1-bus1,
highMessageThreshold=50000, messageStoreType=FILESTORE, uuid=56F8FE11AB84188D,
busName=bus1, busUuid=6DF19B02BC879BD1}'
wsadmin>AdminTask.modifySIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 -initialState STOPPED ]')
wsadmin>AdminTask.showSIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 ]')
'{initialState=STOPPED, targetGroups=[], name=node01.server1-bus1,
highMessageThreshold=50000, messageStoreType=FILESTORE, uuid=56F8FE11AB84188D,
busName=bus1, busUuid=6DF19B02BC879BD1}'