Befehl "modifySIBForeignBus"
Verwenden Sie den Befehl modifySIBForeignBus, um die Eigenschaften eines fremden Busses 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.
Für die SIB-Befehle wird jeweils eine Befehlszeilenhilfe bereitgestellt:
- 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')
Speichern Sie
Ihre Änderungen nach der Ausführung des Befehls in der Masterkonfiguration. Verwenden Sie hierfür beispielsweise
den folgenden Befehl:
AdminConfig.save()
Zweck
Dieser Befehl ändert die Eigenschaften eines fremden Busses. Ein fremder Bus stellt einen Bus in einer anderen Zelle (oder in derselben Zelle) oder in einem IBM MQ-Netz dar, mit dem ein Service Integration Bus Nachrichten austauschen kann.
Zielobjekt
Ein fremder Bus.
Erforderliche Parameter
- -bus Busname
- Der Name des Service Integration Bus, für den Sie einen fremden Bus ändern möchten. Mit dem Befehl listSIBuses können Sie die Namen vorhandener Busse auflisten.
- -name Busname
- Der Name des fremden Busses, den Sie ändern möchten. Mit dem Befehl listSIBForeignBuses können Sie die Namen vorhandener Busse auflisten.
Vorgegebene Parameter
Ohne.
Optionale Parameter
- -description Text
- Eine optionale Beschreibung des Busses für Verwaltungszwecke.
- -sendAllowed False | False
- (Standardeinstellung: True)
Gibt an, ob Erzeuger Nachrichten an den fremden Bus senden können.
- False
- Erzeuger können keine Nachrichten an den fremden Bus senden.
- True
- Erzeuger können Nachrichten an den fremden Bus senden.
- -inboundUserid Benutzer-ID
- Die Benutzer-ID für eingehende Daten wird verwendet, um einzelne Nachrichten, die
vom fremden Bus bei Zielen in diesem Service Integration Bus ankommen, zu authentifizieren. Falls dieser Bus nicht sicher ist, hat diese Eigenschaft keine Auswirkungen auf die Nachrichten.
Sie können eine Benutzer-ID für eingehende Daten angeben, wenn:
- sich der fremde Bus in einer anderen Sicherheitsdomäne als dieser Bus befindet und Benutzer-IDs des fremden Busses in diesem Bus nicht erkannt werden,
- um den Zugriff auf eingehende Nachrichten in diesem Bus lokal zu steuern.
- -outboundUserid Benutzer-ID
- Die Benutzer-ID für abgehende Daten ersetzt die Benutzer-ID, die die Quelle einer Nachricht in allen Nachrichten ersetzt, die an den fremden Bus gesendet werden. Diese Benutzer-ID wird vom fremden Bus verwendet, um die Nachricht für das zugehörige Ziel zu berechtigen, wenn beide Busse sicher sind und der fremde Bus die Benutzer-ID nicht durch eine eigene Benutzer-ID für eingehende Daten überschrieben hat.
- -nextHopBus Busname
- (wenn für -routingType der Wert Indirect angegeben ist) Der Name des nächsten Service Integration Bus in der Folge verbundener Busse. Ein zwischengeschalteter Bus muss kein Service Integration Bus sein. Es kann auch IBM MQ-System sein.
- -topicSpaceMappings Name_des_lokalen_Topicbereichs : Name_des_fernen_Topicbereichs
- Durch die Zuordnung eines Topicbereichs sind Subskribenten im lokalen Topicbereich in der Lage, Nachrichten zu empfangen, die im fremden Topicbereich veröffentlicht wurden. Damit Veröffentlichungen aus dem lokalen Topicbereich in den fremden Bus übertragen werden, ist eine entsprechende Topicbereichszuordnung im fremden Bus erforderlich. Die Namen der Topicbereiche für den lokalen Bus werden den Namen der Topicbereiche zugeordnet, die im fremden Bus definiert sind. In der Regel stimmen die beiden Namen überein. Die Zuordnung von zwei Topicbereichen impliziert, dass die darin enthaltenen Topics identisch sind. Sie können mehrere Topicbereichspaare angeben.
Beispiel
Im folgenden Beispiel werden weitere optionale Eigenschaften für einen vorhandenen fremden Bus mit dem Namen foreignbus1 angegeben:- Benutzeridentität für eingehende Anforderungen mit dem Namen iuserid, um Nachrichten zu berechtigen, die von foreignbus1 an den lokalen Bus gesendet werden, wenn die Sicherheit in foreignbus1 und im lokalen Bus aktiviert ist.
- Benutzeridentität für abgehende Anforderungen mit dem Namen ouserid, um Nachrichten zu berechtigen, die vom lokalen Bus an foreignbus1 gesendet werden, wenn die Sicherheit in foreignbus1 und im lokalen Bus aktiviert ist.
- Topicbereichszuordnung zwischen Topic.Space1 im lokalen Bus und Topic.Space2 in foreignbus1. Die Zuordnung ermögicht Subskribenten in Topic.Space1 im lokalen Bus, Nachrichten zu empfangen, die in Topic.Space2 in foreignbus1 veröffentlicht werden.
AdminTask.modifySIBForeignBus('[-bus bus1 -name foreignbus1 -inboundUserid iuserid
-outboundUserid ouserid -topicSpaceMappings [[Topic.Space1 Topic.Space2]]]')
'foreignbus1(cells/cell01/buses/bus1|sib-bus.xml#SIBForeignBus_1213023645293)'