createSIBWMQServer 指令

使用 createSIBWMQServer 指令，在 Cell 範圍建立新的 IBM MQ 伺服器。

您可以依照這個主題中的說明，利用 wsadmin 工具，或依照建立 IBM MQ 伺服器定義中的說明，利用管理主控台來建立新的 IBM MQ 伺服器。

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

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

服務整合匯流排指令有指令行說明：

如需 Jython 中可用的服務整合匯流排指令清單，以及每個指令的簡要說明，請在 wsadmin 提示下，輸入下列指令：
print AdminTask.help('SIBAdminCommands')
如需給定指令的概觀說明，請在 wsadmin 提示下，輸入下列指令：
print AdminTask.help('command_name')

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

AdminConfig.save()

用途

IBM MQ 伺服器代表 IBM MQ 佇列管理程式或 (適用於 IBM MQ for z/OS) 佇列共用群組。這個指令會在 Cell 範圍建立新的 IBM MQ 伺服器，並使用提供的值來移入其參數。

附註: 建立 IBM MQ 伺服器時，請務必瞭解 -name 和 -serverName 參數的重要性。例如，如果 WebSphere Application Server 管理建立名稱為 My European area server 的 IBM MQ 伺服器物件，且該伺服器物件代表具有 serverName QM1的 IBM MQ 佇列管理程式。 WebSphere Application Server 管理接著可以建立第二個名稱為 My UK country server的 IBM MQ 伺服器物件，也代表具有 serverName QM1的相同 IBM MQ 佇列管理程式。

目標物件

WebSphere Application Server Cell。

必要參數

-name

IBM MQ 伺服器的名稱。此值僅供管理之用，可由管理者決定。名稱只有在 WebSphere Application Server 管理內才有意義，在 Cell 層次必須是唯一的。沒有預設值。無法修改此參數。

-serverName

佇列管理程式或佇列共用群組的名稱。此值是用來識別佇列管理程式或佇列共用群組的名稱，由 IBM MQ 管理配置給該 IBM MQ 物件。 WebSphere Application Server 管理者必須一律使用 IBM MQ 管理所配置的名稱。

-host

建立連線以與佇列管理程式或佇列共用群組進行通訊的主機。此值是此 IBM MQ 伺服器所代表佇列管理程式或佇列共用群組的主機名稱或 IP 位址。這個值是一個字串，必須是下列其中一項：

符號主機名稱
IPv4 位址
IPv6 位址

-transportChain

與 IBM MQ建立連線時要使用的通道架構出埠傳輸鏈。如果您沒有指定這個選項，則會採用預設值 OutboundBasicWMQClient 。

條件式參數

無

選用參數

對於在服務整合中執行的傳訊應用程式，選用的主機、埠、通道和鑑別別名屬性會一起指定這個 IBM MQ 伺服器的連線存取路徑。如需相關資訊，請參閱 IBM MQ 伺服器: 連線和鑑別。

-port

此 IBM MQ 伺服器所代表的佇列管理程式或佇列共用群組所接聽的 TCP/IP 埠號。預設值是 1414。

-channel

連接至此 IBM MQ 伺服器所代表的佇列管理程式或佇列共用群組時，要使用的 IBM MQ 用戶端通道名稱。此值是由 IBM MQ 管理配置給 IBM MQ 物件的名稱，且一律必須由 WebSphere Application Server 管理使用。預設值為 SYSTEM.DEF.SVRCONN。

-description

IBM MQ 伺服器的簡要說明。此值僅用於管理目的。

-securityAuthAlias

連接至佇列管理程式或佇列共用群組時要使用的鑑別別名。此參數不應與探索鑑別別名混淆。

-trustUserIds

決定服務整合匯流排是否隨訊息一起傳遞從 IBM MQ 收到的訊息中的使用者 ID。一律從 jsAppUserId RFH2 值設定應用程式使用者 ID。如果不存在 (因為 RFH2 標頭中沒有鍵/值配對，或因為訊息沒有 RFH2 標頭) ，則不會設定此欄位。如果您將此值設為 FALSE，則會以 IBM MQ 伺服器名稱改寫使用者 ID。這個參數有兩個可能值：

TRUE: 使用者 ID 會延伸到訊息中。
FALSE: 使用者 ID 不會延伸到訊息中。

預設值為 TRUE。

-allowDiscovery

判定是否執行 IBM MQ 資源的自動化探索。這個參數有兩個可能值：

TRUE: 使用自動化探索。
FALSE: 不使用自動化探索。

預設值為 TRUE。

-discoveryAuthAlias

建立與佇列管理程式或佇列共用群組的資源探索連線時要使用的鑑別別名。此值不應與安全鑑別別名混淆。

-replyToQueue

用於資源探索的回覆目的地佇列。此值是由 IBM MQ 管理配置給 IBM MQ 物件的名稱，且必須是暫時動態佇列的模型佇列名稱。 WebSphere Application Server 管理者必須一律使用 IBM MQ 管理所配置的名稱。預設值為 SYSTEM.DEFAULT.MODEL.QUEUE。

-type

決定 IBM MQ 伺服器物件是由 WebSphere Application Server 管理所決定的佇列管理程式或佇列共用群組。此參數有兩個可能的值:

MQ_QUEUE_MANAGER: IBM MQ 伺服器代表佇列管理程式。如果您選取此值，資源探索程序會擷取屬於佇列管理程式的佇列名稱。
MQ_QUEUE_SHARING_GROUP: IBM MQ 伺服器代表佇列共用群組。如果您選取此值，資源探索程序會擷取屬於佇列共用群組的佇列名稱。

-bindingsMode

決定在連接佇列管理程式或佇列共用群組時，是否使用連結傳輸模式連線。如果應用程式伺服器和佇列管理程式位於相同節點上，則可以使用連結模式連線。即使相同節點上存在多個佇列管理程式，也只能以連結模式連接至單一佇列管理程式。這個參數有兩個可能值：

TRUE: 使用連結模式 (如果可用的話)。如果您選取這個選項，且連結模式無法使用，連線機制會預設為用戶端傳輸模式。
FALSE: 一律使用用戶端模式。

範例

使用 Jython：

wsadmin>AdminTask.createSIBWMQServer(["-name", "Finance dept QM", 
 "-serverName", "FDQM", "-type", "MQ_QUEUE_MANAGER", "-bindingsMode", "true", 
 "-host", "findep01.ibm.com", "-port", 1414, 
 "-transportChain", "OutboundSecureWMQClient"])

使用 Jacl：

wsadmin>$AdminTask createSIBWMQServer {-name "Finance dept QM" 
-serverName FDQM -type MQ_QUEUE_MANAGER -bindingsMode true 
-host findep01.ibm.com -port 1414 
-transportChain OutboundSecureWMQClient}