IBM MQ 傳訊提供者啟動規格設定

請利用這個畫面，來檢視或變更用於 WebSphere® MQ 傳訊提供者之所選取啟動規格的配置內容。這些配置內容會控制如何建立連線來通往相關聯的佇列和主題。

如果要檢視 IBM MQ 啟動規格設定，請利用管理主控台來完成下列步驟：

在導覽窗格中，按一下資源 > JMS -> 啟動規格來顯示現有啟動規格。
適當的話，在內容窗格中，將範圍設定改成定義啟動規格的層次。這會限制所顯示的啟動規格集。
選取您要使用的啟動規格名稱。

在「一般內容」之下，有五個內容群組：

管理
連線
目的地
進階
安全設定

請先進行「管理」、「連線」、「目的地」、「進階」和「安全」等內容設定群組的任何必要變更，按一下套用來儲存配置，然後才在「其他內容」之下的內容窗格中，按下列任何鏈結：

進階內容，顯示或變更 IBM MQ 啟動規格的進階內容。
分配管理系統內容，顯示或變更 IBM MQ 啟動規格的分配管理系統內容。
自訂內容，顯示或變更 IBM MQ 啟動規格的自訂內容。例如，您可以利用這個選項，設定啟動規格的自訂內容 WAS_EndpointInitialState。 WAS_EndpointInitialState 決定在訊息驅動 Bean 與目的地連線中使用啟動規格後，訊息耗用是否就立即從 JMS 目的地開始。
用戶端傳輸內容，顯示或變更 IBM MQ 啟動規格的用戶端傳輸內容。如果所選啟動規格不是利用「用戶端通道定義表 (CCDT)」來建立，請遵循此鏈結來輸入連接 IBM MQ 的所有必要資訊。如果所選啟動規格是利用 CCDT 來建立的，則您不需要提供用戶端傳輸內容，因此不會出現鏈結。

在「相關項目」之下，您可以按一下 JAAS - J2C 鑑別資料來配置搭配啟動規格使用的鑑別資訊。

您也可以利用 createWMQActivationSpec IBM MQ 管理指令，來指定 -localAddress 內容。

註：當指定 IBM MQ 內容時，適用下列限制：

名稱最多可有 48 個字元，但通道例外，它最多只能有 20 個字元。
您指定的內容值必須符合在配置 IBM MQ 資源時，所指定的值。如需相關資訊，請參閱 IBM MQ 資訊中心中的使用 Java 和系統管理區段。

如果 IBM MQ 功能的停用範圍會影響此 IBM MQ 傳訊提供者資源，則會出現一則參考訊息，指出 IBM MQ 已停用。在單一伺服器環境中，於停用 IBM MQ 功能之後重新啟動伺服器時，才會顯示此參考訊息。在網路部署環境中，會立即顯示參考訊息。如需相關資訊，請參閱在 WebSphere Application Server 中停用 IBM MQ 功能。

IBM MQ 啟動規格的內容如下。

管理

範圍

可讓應用程式看見這個資源定義的層次。

傳訊提供者、名稱空間連結或共用程式庫之類的資源可以定義在多個範圍，定義在較明確範圍的資源會改寫定義在較一般範圍的複本。

顯示的範圍只供參考，無法在這個畫面中改變。如果您要瀏覽或變更不同範圍的這項資源（或其他資源），請在 IBM MQ 啟動規格集合畫面中變更範圍，再按一下套用，之後，再按一下資源類型的鏈結。

參考資訊	值
資料類型	String

提供者

建立啟動規格時，所指派的 JMS 提供者。

對於所有利用這個畫面來建立的啟動規格，提供者都是 IBM MQ 傳訊提供者。

顯示提供者，只供參考。

參考資訊	值
資料類型	String

名稱

這個啟動規格在 WebSphere Application Server 中的識別名稱，以作為管理之用。

參考資訊	值
資料類型	String
範圍	在定義於 Cell 的這組啟動規格中，這個名稱必須是唯一的。

JNDI 名稱

JNDI 名稱可用來將啟動規格連結至 JNDI 名稱空間。

請依照慣例使用完整的 JNDI 名稱；比方說，在 jms/Name 格式中，Name 是資源的邏輯名稱。

參考資訊	值
資料類型	String

說明

這個啟動規格在 WebSphere Application Server 中的說明，以作為管理之用。

參考資訊	值
資料類型	String
預設值	空值

連線

配置連線所需的資訊，視所選啟動規格是否為利用「用戶端通道定義表 (CCDT)」所建立的而定。

如果所選啟動規格是利用 CCDT 來建立的，則只會顯示下列內容：

用戶端通道定義表 URL
佇列管理程式
SSL 配置

如果所選啟動規格不是利用 CCDT 來建立的，則會顯示下列內容：

佇列管理程式
傳輸
如果選取以個別的主機和埠值格式來輸入主機和埠資訊，則無法使用連線名稱清單內容，但可以使用下列內容：
- 主機名稱
- 埠
如果選取以連線名稱清單格式來輸入主機和埠資訊，則可以使用連線名稱清單內容，但無法使用下列內容：
- 主機名稱
- 埠
伺服器連線通道
如果您清除利用 SSL 來維護 IBM MQ 通訊安全性的勾選框，便無法使用下列內容：
- 集中管理
- 特定配置
- SSL 配置

如需設定 IBM MQ SSL 內容的相關資訊，請參閱 IBM MQ 資訊中心的 IBM MQ 使用 Java 區段中的 SSL 內容。

註：四個 IBM MQ 連線內容可用來配置 IBM MQ 傳訊提供者所用的 IBM MQ 資源配接器。這些內容會影響啟動規格所用的連線儲存區：

maxConnections
connectionConcurrency(設定這個內容時，只會影響 WebSphere Application Server 7 的節點。這個內容不會影響 WebSphere Application Server 第 8 版或更新節點。)
reconnectionRetryCount
reconnectionRetryInterval

如需這四個內容及其配置方式的相關資訊，請參閱資源配接器內容。

用戶端通道定義表 URL

指定 IBM MQ CCDT 之位置的 URL。

參考資訊	值
資料類型	String

佇列管理程式

如果指定的啟動規格是以 CCDT 為基礎，這個內容便會用來選取 CCDT 中的項目。否則，這個內容是指定所要連接的佇列管理程式名稱或佇列共用群組名稱。會建立指向指定 IBM MQ 資源的連線，以便接收訊息。

參考資訊

值

資料類型

String

範圍

如果這個啟動規格不是以 CCDT 為基礎，這個值必須是有效的佇列管理程式名稱。

如果這個啟動規格是以 CCDT 為基礎，這個值必須是下列其中一個項目：

有效的佇列管理程式名稱
星號 (*) 後面加上佇列管理程式名稱¹
星號 (*)
空白¹

¹當您在這個表單中，指定「佇列管理程式」內容值，來搭配使用 CCDT 時，以啟動規格建立的個別連線可能會連接不同的佇列管理程式。當 CCDT 包含多個用戶端連線通道定義以及一個相符的佇列管理程式名稱 (QMNAME) 參數，且這些連線通道定義針對不同的佇列管理程式定義了網路連線詳細資料，就會從多個佇列管理程式中選取。

如果指定的 Connection Factory 是以 CCDT 為基礎，且 CCDT 可以從多個佇列管理程式中選取，您可能無法回復廣域交易。因此，對於指定 CCDT 的 Connection Factory，您有兩種替代方案可選：

指定「佇列管理程式」內容時，避免目標佇列管理程式語義不明確，也就是說，指定給這個內容的值不得包含星號 (*)。
資源避免和列在廣域交易中的應用程式搭配使用。

傳輸

IBM MQ 連線傳輸類型。傳輸類型用來決定連接 IBM MQ 時，所用的確切機制。

參考資訊	值
資料類型	下拉清單
預設值	先連結，後用戶端
範圍	用戶端利用 TCP/IP 型網路連線，與 IBM MQ 佇列管理程式通訊。先連結，後用戶端嘗試佇列管理程式的連結模式連線。如果不可能，便回復透過用戶端傳輸。連結建立交叉記憶體連線來連接執行於相同節點的佇列管理程式。停用下列用戶端傳輸模式內容：主機名稱埠連線名稱清單伺服器連線通道如需配置`先連結，後用戶端`或`連結`傳輸類型的相關資訊，請參閱以原生程式庫資訊配置 IBM MQ 傳訊提供者。

以個別的主機和埠值格式來輸入主機和埠資訊

如果選取這個圓鈕，則表示使用主機名稱和埠內容所提供的資訊，來建立 IBM MQ 佇列管理程式連線。

選取這個選項會啟用主機名稱和埠內容，並且停用連線名稱清單內容。如果要輸入連線名稱清單資訊，請按一下以連線名稱清單格式來輸入主機和埠資訊。

只有在範圍內容指定 Cell 或叢集，或是範圍內容指定正在執行 WebSphere Application Server 8.0 版或更新版本的節點或伺服器時，才能使用這個圓鈕。

參考資訊	值
資料類型	圓鈕

主機名稱

要連接的 IBM MQ 佇列管理程式的主機名稱、IPv4 或 IPv6 位址。

參考資訊	值
資料類型	String

埠

IBM MQ 用來接聽的埠號。

參考資訊	值
資料類型	Integer
預設值	1414
範圍	這個值必須在 1-65535 的範圍中（頭尾包括在內）。

以連線名稱清單格式來輸入主機和埠資訊

如果選取這個圓鈕，則表示使用連線名稱清單內容所提供的資訊，來建立 IBM MQ 佇列管理程式連線。

連線名稱清單可用來連接單一佇列管理程式或多重實例的佇列管理程式。如需使用多重實例佇列管理程式的相關資訊，請參閱 IBM MQ 資訊中心。選取這個選項會啟用連線名稱清單內容，並且停用主機名稱和埠內容。如果要輸入個別的主機和埠資訊，請按一下以個別的主機和埠值格式來輸入主機和埠資訊。

只有在範圍內容指定 Cell 或叢集，或是範圍內容指定正在執行 WebSphere Application Server 8.0 版或更新版本的節點或伺服器時，才能使用這個圓鈕。

參考資訊	值
資料類型	圓鈕

連線名稱清單

當您希望啟動規格連接多重實例的佇列管理程式時，要使用的連線名稱清單，且其中指定主機名稱和埠的詳細資料。

這個內容只能用來容許連接多重實例的佇列管理程式。不得用來容許連接非多重實例的佇列管理程式，否則可能導致交易完整性問題。

參考資訊

值

資料類型

String

預設值

未設定

範圍

必須以下列格式，將這個欄位設定成字串：

host[(port)][,host(port)]

埠資訊是選用的，如果沒有指定，則預設值為 1414。

host 必須是有效的 TCP/IP 主機名稱，或是 IPv4 或 IPv6 位址。

port 必須是 1 到 65536（頭尾包括在內）範圍中的整數值。

例如 localhost(1234),remotehost1(1234),remotehost2

如果指定連線名稱清單內容，會自動將主機名稱或埠內容設為連線名稱清單中之第一項的主機名稱和埠號。因此，如果您指定 localhost(1234),remotehost1(1234),remotehost2，主機名稱會設為 localhost，埠會設為 1234。

只有在範圍內容指定 Cell 或叢集，或是範圍內容指定正在執行 WebSphere Application Server 8.0 版或更新版本的節點或伺服器時，才能使用這個內容。

如果是在混合 Cell 環境中使用，叢集或 Cell 範圍啟動規格的連線名稱清單內容中的資訊可供 WebSphere Application Server 7.0 版節點使用。確切的行為取決於節點的修正套件層次：

如果節點是在 WebSphere Application Server 7.0 版 Fix Pack 7 或更新的修正套件層次執行，則連線名稱清單內容可用來連接多重實例的佇列管理程式。

如果節點是在 7.0 版之前的修正套件層次執行，則無法辨識連線名稱清單內容，且會輸出類似下列範例的警告訊息：

[29/09/10 12:15:27:468 BST] 00000018 J2CUtilityCla W   J2CA0008W: cells/L3A3316Node01Cell/resources.xml#J2CResourceAdapter_1284547647859 資源使用的 com.ibm.mq.connector.inbound.ActivationSpecImpl 類別不包含 setConnectionNameList 方法。Processing continued.

在此情況下，會使用主機名稱和埠內容中的資訊來連接佇列管理程式。

伺服器連線通道

連接 IBM MQ 時所用的 IBM MQ 伺服器連線通道名稱。

參考資訊	值
資料類型	String
預設值	SYSTEM.DEF.SVRCONN
範圍	這個值必須是定義給所連接之 IBM MQ 佇列管理程式的伺服器連線通道。

利用 SSL 來維護與 IBM MQ 的通訊安全

這個選項決定是否利用 SSL (Secure Socket Layer) 通訊協定來維護與 IBM MQ 佇列管理程式或佇列共用群組的網路通訊安全。

當在應用程式伺服器環境中使用 IBM MQ 傳訊提供者啟動規格時，應用程式伺服器會管理 SSL 配置。如果要變更 SSL 配置參數，請利用管理主控台，導覽至安全 > SSL 憑證和金鑰管理畫面。

在 IBM MQ 傳訊提供者啟動規格的 SSL 配置中，您只能使用一個密碼組合。如果您指定了多個密碼組合，只會使用第一個。

參考資訊	值
資料類型	勾選框。如果清除這個勾選框，會停用下列 SSL 內容：集中管理特定配置 SSL 配置

集中管理

當利用 SSL 通訊協定來與 IBM MQ 通訊時，請選取這個圓鈕，指定 SSL 配置是取自集中管理的 WebSphere Application Server SSL 配置。

當您選取這個圓鈕時，會利用 IBM MQ 傳訊提供者啟動規格中的主機名稱和埠屬性，來選取適當的 SSL 配置。如果您利用連線名稱清單將主機和埠資訊提供給啟動規格，則表示使用清單中第一個元素的主機名稱和埠資訊，來選取適當的 SSL 配置。如果要提供將符合啟動規格的 SSL 配置，請參閱相關參照下所列的「動態出埠端點 SSL 配置設定」主題。

參考資訊	值
資料類型	圓鈕

特定配置

當您想指定利用 SSL 來維護與 IBM MQ 佇列管理程式或佇列共用群組的網路通訊安全時，所用的特定 SSL 配置，請選取這個圓鈕。

參考資訊	值
資料類型	圓鈕

SSL 配置

當利用 SSL 來維護與 IBM MQ 佇列管理程式或佇列共用群組的網路通訊安全時，所用的 SSL 配置。

如果選取集中管理圓鈕，且已明確定義 IBM MQ 傳訊提供者資源，便會停用這個內容。

如果 IBM MQ 傳訊提供者資源是以 CCDT 為基礎，一律會啟用這個內容。

如果這個 IBM MQ 傳訊提供者資源是以 CCDT 為基礎，則只有在 CCDT 中的相關項目已配置使用 SSL 時，才會使用這個參數。

另外，如果所選的 SSL 配置是 none，便會使用 IBM MQ 傳訊提供者的預設集中管理的 WebSphere Application Server SSL 配置。

參考資訊	值
資料類型	下拉清單

目的地

註： WAS_EndpointInitialState 內容是一個自訂內容。這個內容決定一旦訊息驅動 Bean 使用啟動規格來連接目的地，是否立即從 JMS 目的地開始耗用訊息。當您在這個內容窗格中完成變更，並且按一下套用來儲存配置之後，如果要設定自訂內容，請在「其他內容」之下的內容窗格中，按一下自訂內容。

目的地 JNDI 名稱

JMS 目的地的 JNDI 名稱，從中消費訊息來遞送到配置使用這個啟動規格的訊息驅動 Bean (MDB)。

參考資訊	值
資料類型	String

訊息選取器

指定將遞送哪些訊息的訊息選取器表示式。

參考資訊	值
資料類型	String

目的地類型

消費訊息的來源目的地類型（佇列或主題）。

參考資訊	值
資料類型	下拉清單
範圍	佇列目的 JNDI 名稱指向的 JMS 目的地是佇列。主題目的 JNDI 名稱指向的 JMS 目的地是主題。

可延續訂閱

選項，可指定要利用可延續或不可延續訂閱，將訊息遞送到訂閱主題的 MDB。

參考資訊	值
資料類型	勾選框
預設值	清除（不可延續）
範圍	已清除不可延續。已選取可延續。

訂閱名稱

可延續訂閱的名稱。只有在選取可延續訂閱勾選框時，才能夠使用。

參考資訊	值
資料類型	String

進階

用戶端 ID

連接 IBM MQ 傳訊提供者時，要指定的用戶端 ID。

參考資訊	值
資料類型	String

接受複製的可延續訂閱

選項，可決定不同伺服器是否能夠同時存取可延續訂閱的多重實例。

參考資訊	值
資料類型	勾選框
預設值	已清除
範圍	已選取不同伺服器可以同時存取可延續訂閱的多重實例。已清除不同伺服器不能同時存取可延續訂閱的多重實例。

提供者版本

IBM MQ 傳訊提供者版本。這用來決定是否連接到佇列管理程式的特定版本。另外，它也用來決定用戶端所需要的功能類型。

參考資訊

值

資料類型

String

範圍

輸入的值必須是空字串，或是下列格式之一：

n.n.n.n
n.n.n
n.n
n

其中 n 是大於或等於零的數值。

例如 6.0.0.0。

安全設定

鑑別別名

連接 IBM MQ 時要使用的使用者名稱和密碼。

參考資訊	值
資料類型	下拉清單
預設值	（無）
範圍	定義給 Cell 的所有鑑別別名及「（無）」值，此值指定不傳遞任何認證給 IBM MQ。

檔名： umj_pasm.html