請使用這個指令在 Cell 中建立新的外部匯流排。
開始之前
在這個主題中說明的指令,是使用 wsadmin Scripting 用戶端的 AdminTask 物件來執行。
這些指令行 Script 會從 Qshell 執行。如果需要詳細資訊,請參閱「配置 Qshell 以執行 WebSphere Application Server Script」主題。
如果需要指令內容的其他詳細資料,請參閱相關的參照主題。
用途
這個指令會建立指定服務整合匯流排的新外部匯流排。外部匯流排為另一個 Cell(或同一個 Cell 內)或 WebSphere MQ 網路中的匯流排,
服務整合匯流排可和它交換訊息。
- 指令名稱
- createSIBForeignBus
- 目標
- 無。
- 結果
- 外部匯流排物件。
如果要儲存指令所進行的變更,請呼叫 AdminConfig 物件上的 "save" 指令。
必要的參數
- -bus busname
- 您要建立其外部匯流排之服務整合匯流排的名稱。您可以使用 listSIBuses 指令來列出現有匯流排的名稱。
- -name busname
- 您要用來識別外部匯流排的名稱。
附註: - 當您建立代表另一個服務整合匯流排的外部匯流排時,外部匯流排的名稱必須符合其他服務整合匯流排的名稱。
- 如果您想要直接鏈結這兩個匯流排,您必須指派給它們唯一名稱。
- 配置之後,您就不可變更外部匯流排的名稱。
- -routingType Direct | Indirect
- 建立具有指定實體鏈結(也稱為遞送類型)的外部匯流排:
- Direct
- 服務整合匯流排鏈結,從本端匯流排的傳訊引擎鏈結至外部匯流排的傳訊引擎。
- Indirect
- 間接鏈結,就是透過一或多個中間外部匯流排來建立的鏈結。
選用參數
- -description text
- 用來進行管理的匯流排選用說明。
- -type MQ | SIBus
- 建立具有指定類型的外部匯流排:
- MQ
- 建立將服務整合匯流排鏈結到 WebSphere MQ 網路的外部匯流排。
- SIBus
- 建立將服務整合匯流排鏈結到另一個服務整合匯流排的外部匯流排。
- -sendAllowed True | False
- (預設值:True)生產端是否可傳送訊息給外部匯流排。
- False
- 生產端不能傳送訊息給外部匯流排。
- True
- 生產端可以傳送訊息給外部匯流排。
- -inboundUserid userID
- 入埠使用者 ID 可用來授權個別訊息從外部匯流排送至服務整合匯流排中的目的地。如果這不是安全匯流排,這個內容對訊息沒有作用。在下列情況下,您可以指定入埠使用者 ID:
- 如果外部匯流排在不同於這個匯流排的安全網域中,且在這個匯流排中無法辨識外部匯流排的使用者 ID
- 您要進行這個匯流排的入埠訊息本端控制存取。
如果這是一個安全匯流排,但外部匯流排不安全,且未設定入埠使用者 ID,則任何來自外部匯流排的入埠訊息,都只會獲授權送至允許未經鑑別使用者存取的目的地。
- -outboundUserid userID
- 離埠使用者 ID 會取代在送往外部匯流排的所有訊息中,用來識別訊息來源的使用者 ID。
如果兩個匯流排都是安全匯流排,且外部匯流排未以自己的入埠使用者 ID 來置換這個使用者 ID,則外部匯流排也會使用這個使用者 ID,授權訊息送至其目的地。
- -nextHopBus bus_name
- (如果 -routingType 是 Indirect)在一系列相連匯流排中的下一個服務整合匯流排的名稱。中間匯流排可以是 WebSphere MQ 系統,而不是服務整合匯流排。
範例
wsadmin>$AdminTask createSIBForeignBus {-bus SCA.SYSTEM.IBM-AA8DA602255Cell01.Bus -name SCA.SYSTEM.IBM-AA8DA602255Cell02.Bus -routingType Direct -type SIBus}
SCA.SYSTEM.IBM-AA8DA602255Cell02.Bus(cells/IBM-AA8DA602255Cell01/buses/SCA.SYSTEM.IBM-AA8DA602255Cell01.Bus|sib-bus.xml#SIBForeignBus_1132530748562)
wsadmin>