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.

[IBM i][IBM i]Der Scripting-Client wsadmin wird über die Qshell ausgeführt. [IBM i]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.
Falls dieser Bus sicher, der fremde Bus nicht sicher und keine Benutzer-ID für eingehende Daten definiert ist, werden vom fremden Bus eingehende Nachrichten nur an die Ziele zugelassen, die nicht authentifizierte Benutzerzugriffe zulassen.
-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)'  

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_fbus_modify
Dateiname:rjj_fbus_modify.html