版本注意事項

|20.1 安裝與架構 DB2 MQSeries 函數

|本節說明如何架構 DB2 環境以使用 DB2 MQSeries Function。 只要您成功完成下列程序，就可以從 SQL 使用 DB2 MQSeries Function。 |關於這些功能的說明，請至「版本注意事項」的 SQL Reference 一節。

|架構與啟用 DB2 MQSeries Function 的基本程序為： |

1. |安裝 MQSeries。
2. |安裝 MQSeries AMI。
3. |啟用與架構 DB2 MQSeries Function |

|此外，若要使用 DB2 MQSeries Function 提供的發佈/訂閱功能，您也必須安裝 MQSeries Integrator 或 MQSeries Publish/Subscribe Function。 |關於 MQSeries Integrator 的資訊，請至 |http://www.ibm.com/software/ts/mqseries/integrator。關於 MQSeries Publish/Subscribe 功能的資訊，請至種類 3 下的 |http://www.ibm.com/software/ts/mqseries/txppacs。

|20.1.1 安裝 MQSeries

|第一個步驟是要確定您的 DB2 伺服器上是否已安裝了 MQSeries 版本 5.1 與最新的 Fixpak (最低標準)。若您已安裝此版本的 MQSeries，請跳至下一步驟「安裝 MQSeriesy AMI」。 |DB2 版本 7.2 包括 DB2 使用的 MQSeries 伺服器之副本。 |安裝 MQSeries 或升級現存的 MQSeries 安裝之特定平台指令，可在特定的平台「快速入門」書籍中找到，其位在 http://www.ibm.com/software/ts/mqseries/library/manuals。請確定當您進行安裝程序時，要設定預設佇列管理程式。

|20.1.2 安裝 MQSeries AMI

|下個步驟是安裝 MQSeries 應用程式傳訊介面 (AMI)。 這是 MQSeries 程式設計介面的副檔名，它提供管理及程式設計一個清楚的隔離。 |DB2 MQSeries Function 需要此介面的安裝。若 MQSeries AMI 已安裝在您的 DB2 伺服器上，請跳至下一步驟 「啟用 DB2 MQSeries Function」。若尚未安裝 MQSeries AMI，則您可以從 DB2 7.2 |提供的安裝套裝軟體來安裝，或從 MQSeries 支援套裝軟體網站 |http://www.ibm.com/software/ts/mqseries/txppacs，下載 AMI 副本。 |您可以在「種類 3 - 產品副檔名」下找到 AMI。為了方便起見， |我們提供您 DB2 的 MQSeries AMI 之副本。此檔案位在 sqllib/cfg 目錄中。此檔案的名稱是作業系統相依項：
|

|遵循 AMI Readme 檔中簡述的正常 AMI 安裝程序，該檔在壓縮安裝映像檔中。

|20.1.3 啟用 DB2 MQSeries Function

|在此步驟期間，您將架構並啟用 DB2 MQSeries Function 的資料庫。 |enable_MQFunctions 公用程式是一個彈性的指令，會先檢查已設定適當的 MQSeries 環境，然後安裝並建立 DB2 MQSeries 功能的預設架構，以這些功能啟用指定的資料庫，並確認架構運作正常。 |

1. |針對 Windows NT 或 Windows 2000，請至步驟 5。
2. |在 UNIX 設定群組：若您在 UNIX 上啟用這些功能，您必須先將 DB2 案例擁有者 (通常是 de2inst1) 及與隔離 |UDF 相關的使用者 ID (通常是 db2fenc1)，新增到 MQSeries 群組 mqm 中。 |DB2 功能需要此設定以存取 MQSeries。
3. |在 UNIX 上設定 DB2 環境變數：將 AMT_DATA_PATH 環境變數新增到 DB2 瞭解的列示中。 |您可以編輯檔案 $INSTHOME/sqllib/profile.env，將 AMT_DATA_PATH 新增至 DB2ENVLIST。也可使用 db2set 指令。
4. |在 UNIX 上，重新啟動資料庫案例：若要讓環境變數變更生效，必須重新啟動資料庫案例。
5. |在 UNIX 上將目錄變更為 $INSTHOME/sqllib/cfg，在 Windows 上將目錄變更為 %DB2PATH%/cfg。
6. |執行指令 enable_MQFunctions 以架構並啟用 DB2 MQSeries 功能的資料庫。請參閱20.6, enable_MQFunctions，以取得此指令的完整說明。下列提供一些一般範例。 |在成功完成之後，將啟用指定的資料庫並測試架構。
7. |若要使用「命令行處理器」測試這些功能，請在您連接到已啟用的資料庫時，發出下列指令：

   |values DB2MQ.MQSEND('a test')  
   |values DB2MQ.MQRECEIVE()

   |第一個陳述式將傳送訊息 "a test" 至 DB2MQ_DEFAULT_Q 佇列，而第二個則將其接收回來。 |

|註:

執行 enable_MQFunctions 的結果，將建立預設 MQSeries 環境。將建立 MQSeries 佇列管理程式 DB2MQ_DEFAULT_MQM 及預設佇列 DB2MQ_DEFAULT_Q。若檔案 amt.xml、amthost.xml 及 amt.dtd |已不存在於 AMT_DATA_PATH 指向的目錄時，將建立這些檔案。 |若 amthost.xml 檔案不存在，且不包含 connectionDB2MQ 的定義，則會將行新增到有適當資訊的檔案中。原來的檔案之副本將被儲存為 DB2MQSAVE.amthost.xml。 |