使用者指南
此頁面敘述如何配置您的 MQSeries Internet Gateway,以便使用您自己的 MQSeries 資源與應用程式。包括主題的如下:
關於將訊息傳送到 MQSeries Internet 閘道時會用到哪些 MQSeries 資源的資訊,可以從下列關鍵字查詢:
- MQIGwQueue
- MQSeries 應用程式佇列名稱 - 訊息會放置到哪一個佇列
- MQIGwReplyQueue
- MQSeries Gateway 佇列名稱 - MQSeries Internet Gateway 會從哪一個佇列擷取訊息
- MQIGwQueueManager
- 要使用的 MQSeries 佇列管理程式名稱
- MQIGwWaitInterval
- 閘道等候回應用的時間 (毫秒)。
- MQIGwWaitHTML
- 如果發生逾時,則會顯示的 HTML 檔案名稱。
此 HTML 應該會包含一個訊息,指示已經過了等候時間,另外也會包含一個按鈕,用於在以後擷取訊息回應。請參閱
撰寫 MQSeries Internet Gateway 的 HTML 表格逾時頁面 timedout.htm 簡例,這個檔案是放
在閘道檔案目錄。
- MQIGwContext
- 要將哪些上下文資訊傳送到應用程式。
此關鍵字可以送到下列的值:
- 無
- 無任何上下文資訊傳送到服務應用程式。
- 全部。
- 下列全部的上下文資訊會傳送到服務應用程式:
- AUTH_TYPE | - REQUEST_METHOD | - QUERY_STRING |
- HTTP_ACCEPT | - REMOTE_HOST | - REMOTE_USER |
- HTTP_REFERER | - REMOTE_ADDR | - REMOTE_IDENT |
- HTTP_USER_AGENT | - SCRIPT_NAME | - SERVER_SOFTWARE |
- HTTP_RESPONSE | - CONTENT_TYPE | - SERVER_NAME |
- HTTP_REASON | - CONTENT_LENGTH | - GATEWAY_INTERFACE |
- SERVER_PROTOCOL | - PATH_INFO |
- SERVER_PORT | - PATH_TRANSLATED |
按一下此處,查看設定此關鍵字後,傳回的資訊範例。
- MQIGwIniFile
- INI 檔案名稱,可以用來保留任何其它關鍵字的預設值。
這些關鍵字的值可以用下列方式提供:
- 全部的關鍵字都會在 HTML 表格有指定的值,這張 HTML 表格是用來傳送訊息到閘道。
請注意:如果您想使用儲存在 'INI"
檔案的值,這是唯一可以設定 MQIGwIniFile 的地方。(請參閱下列的 (2))。
- 關鍵字的值可以儲存在您自己的 'INI' 檔案
- 下列關鍵字的預設值是提供在 'dmq.ini' 檔案,而這個檔案是由
MQSeries Internet Gateway 提供,並且在 UNIX 平台可在 /var/mqm 找到,
在 OS/2 和 WindowsNT 可在 mqm\bin 找到。
- MQIGwReplyQueue
- DMQGATEWAY
- MQIGwWaitInterval
- 10000 ms
- MQIGwContext
- 全部
請注意:雖然任何關鍵字可以設定在上述任何或全部的地方,不過小心不要在任何一個地方重複定義一個以上的特定關鍵字,因為這
樣會導致意外的結果。
MQSeries Internet Gateway 會按照下列順序,搜尋不同關鍵字定義來源:
- HTML 表格
- 在 MQIGwIniFile 關鍵字指定的 'INI' 檔案
- dmq.ini 檔案
如果找不到下列關鍵字的有效值,則會使用基本的預設值:
- MQIGwQueueManager
- 基本的預設值是 MQSeries 預設佇列管理程式
請注意: 在 MVS 方面,並沒有預設的佇列管理程式,您必須使用上述的其中一種方法,設定 MQIGwQueueManager 的值。
- MQIGwWaitInterval
- 基本的預設值是不限定等候間隔
- MQIGwWaitHTML
- 基本的預設值是 'timedout.htm',這個檔案是儲存在閘道檔案目錄。
- MQIGwContext
- 基本的預設值是全部
如果找不到下列任何關鍵字的有效值,交易就無法完成,而且會顯示錯誤訊息:
- MQIGwQueue
- MQIGwReplyQueue
- MQIGwQueueManager
您可以變更 'dmq.ini' 的預設的關鍵字值,而且也可以建立自己的 'INI' 檔案來儲存自己的 'INI' 檔案。MQSeries Internet
Gateway 提供配置程式,協助您變更與建立預設值和自己的 'INI" 檔案。
請注意:強烈建議您使用此程式,不要使用編輯器來修改或
編輯檔案。編輯器很可能會損毀 'INI' 檔案的格式。
配置程式是以 HTML 檔案的形式提供給您,可以在 Web 瀏覽器執行。
請使用下列程序,執行您自己的配置。
- Open the MQSeries Internet Gateway file 'dmqcnf.htm' (請注意:如果2您正在
檢視的文件是安裝到您的 Web 伺服器機器,則程式只會從此連結執行)。
此檔案是儲存在 MQSeries 閘道目錄的文件目錄。
- 當畫面顯示的時候,
- 如果想要修改閘道提供的預設 INI 檔案 (dmq.ini),請按一下提出按鈕
- 要修改或建立其它 INI 檔案,請輸入檔案名稱,然後按一下提出
- 會顯示一個畫面,顯示在您已經選取之檔案裡面的關鍵字,以及目前的值。
-
- 如果要將所做的變更儲存到顯示在另存新檔欄位的檔案,請按一下引用
- 如果將修改的檔案儲存成新的名稱,請在另存新檔欄位輸入新名稱,然後按一下引用
關鍵字清單會隨您所做的變更而更新。
如果已經決定儲存到某個已經存在並包含部份關鍵字的檔案,就會顯示檔案裡面完成的關鍵字清單。
- 如果想新增其它關鍵字,或者進一步修改清單裡面的值,請重複上述的程序。
請注意:關鍵字名稱不可以使用內嵌的空格
。
如果修改 'dmq.ini' 檔案,則下次使用 MQSeries Internet Gateway 傳送 MQ 訊息的時候,就會將新的值當成預設值。如果已經修改或
建立自己的 'INI' 檔案,則下次使用表格來設定 MQIGwIniFile 關鍵字成您的 'INI' 檔案名稱時,就會使用新的值。
![[解說]](images/help.gif)
[ 首頁 |
訂購 |
搜尋 |
聯絡 IBM |
法律事誼 ]
(C) IBM Corporation 1997. 1999. All Rights Reserved