mediateSIBDestination 指令

請利用 mediateSIBDestination 指令來調解服務整合匯流排的匯流排目的地。

調解目的地會使調解與選取的匯流排目的地產生關聯。 在執行時期，調解會將一些訊息處理套用至匯流排目的地所處理的訊息。 請注意，您一次只能利用單一調解來調解目的地。 您可以利用相同的調解來調解多個目的地。

如果要執行指令，請使用 wsadmin Scripting 用戶端的 AdminTask 物件 。

[IBM i][IBM i]從 Qshell 執行 wsadmin Scripting 用戶端。

服務整合匯流排指令有指令行說明：
  • 如需 Jython 中可用的服務整合匯流排指令清單，以及每個指令的簡要說明，請在 wsadmin 提示下，輸入下列指令：

    print AdminTask.help('SIBAdminCommands')

  • 如需給定指令的概觀說明，請在 wsadmin 提示下，輸入下列指令：

    print AdminTask.help('command_name')

使用指令之後，請利用下列指令，儲存對主要配置所做的變更：

AdminConfig.save()

目的

這個指令會調解服務整合匯流排的匯流排目的地。 有一些參數可用來在 WebSphere® MQ 伺服器上建立調解佇列點，以及在叢集或伺服器上建立對應的調解執行點。

在支援伺服器叢集的 WebSphere Application Server 環境中，您應該只使用 node、 server和 cluster 參數。
附註: 如果您在調解點是 WebSphere MQ 伺服器上的佇列的目的地進行調解 (使用 wmqServer 參數) ，您必須指定調解程式碼的執行位置。 如果調解程式碼在服務整合匯流排成員中執行，您必須使用 node、 server和 cluster 參數來指定調解執行點。 如果調解程式碼在外部執行，您必須省略 node、 server和 cluster 參數。
  • 如果您不是使用 WebSphere MQ 伺服器上佇列的調解點，請使用 node、 server和 cluster 參數來指定調解點所在的位置。 這也是執行調解的位置。 如果您省略這些參數，調解點會預設為指派調解目的地的匯流排成員。
  • 如果您使用的調解點是 WebSphere MQ 伺服器上的佇列，請使用 wqmServer 和 wmqQueueName 參數來指定調解點。
    • 如果您省略 node、 server和 cluster 參數，服務整合匯流排會假設調解程序是由外部 WebSphere MQ 應用程式執行。
    • 如果您想要將調解點指派給 WebSphere MQ 伺服器匯流排成員，請使用 wmqServer 和 wmqQueueName 參數來指定 WebSphere MQ 佇列。 在此狀況下，因為您已省略 node、 server及 cluster 參數，外部 WebSphere MQ 應用程式可以執行調解。 node、 server和 cluster 參數用來指定調解程式碼執行所在的匯流排成員。

目標物件

無。

必要參數

-bus bus_name -destinationName 目的地名稱
要調解的目的地。
-mediationName 媒體名稱
要套用至匯流排目的地的調解名稱。 此調解必須存在，才能使用此指令。

條件式參數

-wmqServer mq_server_name -wmqQueueName mq_queue_name
[佇列或 Web 服務目的地] 如果要將調解點指派給 WebSphere MQ 佇列，請同時指定要在其中指派調解點的 WebSphere MQ 伺服器匯流排成員名稱，以及用來儲存備妥可進行調解之訊息的 WebSphere MQ 佇列名稱。 mq_server_name 是建立 WebSphere MQ 伺服器時在 -name 參數中指定的 WebSphere MQ 伺服器名稱。 mq_queue_name 是 WebSphere MQ 管理配置給 WebSphere MQ 佇列的名稱。
-node node_name -server server_name
[非主題空間] 如果要調解伺服器匯流排成員的匯流排目的地，請同時指定伺服器執行所在的節點名稱和伺服器名稱。
-cluster 叢集名稱
[非主題空間] 如果要調解叢集匯流排成員的匯流排目的地，請指定叢集名稱。

這個選項只能在支援伺服器叢集的 WebSphere Application Server 環境中使用。

選用參數

-nonPersistentReliability

指定服務整合品質，以與服務整合從 WebSphere MQ 網路接收的非持續性 WebSphere MQ 訊息搭配使用。 WebSphere MQ 網路中的訊息具有自己的服務品質層次。 這是持續性或非持續性。 當服務整合應用程式收到這些訊息時，會根據它們的 WebSphere MQ 服務品質層次來指派服務整合服務品質層次。

對於接收的非持續性 WebSphere MQ 訊息，預設服務整合服務品質是 RELIABLE_NONPERSISTENT。 如果您選擇置換這個預設值，您可能會選擇其中一個其他非持續性服務整合服務品質 BEST_EFFORT_NONPERSISTENT 或 EXPRESS_NONPERSISTENT。 不過，您可以選擇服務整合五個可能的服務品質：
BEST_EFFORT_NONPERSISTENT
傳訊引擎停止或失效時捨棄的訊息。 訊息也可能因為用來傳送訊息的連線無法使用，或系統資源受到限制，而遭到捨棄。
EXPRESS_NONPERSISTENT
傳訊引擎停止或失效時捨棄的訊息。 如果用來傳送訊息的連線無法使用，也可能捨棄訊息。
RELIABLE_NONPERSISTENT
傳訊引擎停止或失效時捨棄的訊息。
RELIABLE_PERSISTENT
當傳訊引擎失敗時，可能會捨棄訊息。
ASSURED_PERSISTENT
不捨棄訊息。
附註: 可靠性層次越高，對效能的影響越大。

如需相關資訊，請參閱 與 WebSphere MQ 持續性值之間來回對映 JMS 遞送選項和訊息可靠性。

-persistentReliability

指定服務整合服務品質，以與服務整合從 WebSphere MQ 網路接收的持續 WebSphere MQ 訊息搭配使用。 WebSphere MQ 網路中的訊息具有自己的服務品質層次。 這是持續性或非持續性。 當服務整合應用程式收到這些訊息時，會根據它們的 WebSphere MQ 服務品質層次來指派服務整合服務品質層次。

對於收到的持續性 WebSphere MQ 訊息，預設服務整合服務品質是 ASSURED_PERSISTENT。 如果您選擇置換此預設值，則可能會選擇其他持續性服務整合服務品質 RELIABLE_PERSISTENT。 不過，您可以選擇服務整合五個可能的服務品質：
BEST_EFFORT_NONPERSISTENT
EXPRESS_NONPERSISTENT
RELIABLE_NONPERSISTENT
RELIABLE_PERSISTENT
ASSURED_PERSISTENT
-useRFH2
決定服務整合技術是否在它放置在調解點上的訊息中包含 RFH2 標頭。 可能的值為:
true
False
預設值為 TRUE。
-maintainStrictMessageOrder
維護嚴格訊息順序。 可能的值為:
已選取
維護生產者將訊息傳送到目的地的順序。

在執行時期，此內容優先於其他配置內容值。

已清除
未保留此目的地的訊息順序。

範例

  • 使用 Jython：
    wsadmin>AdminTask.mediateSIBDestination("-bus abus -destinationName myqueue
 -mediationName filterMed -cluster cluster1")
  • 使用 Jacl：
    wsadmin>$AdminTask mediateSIBDestination {-bus abus -destinationName myqueue
 -mediationName filterMed -cluster cluster1}