IBM 書籍 [返回圖書館] [內容] [上一個主題] [主題底端] [下一個主題] [解說]

使用者指南


配置 MQSeries Internet Gateway

此頁面敘述如何配置您的 MQSeries Internet Gateway,以便使用您自己的 MQSeries 資源與應用程式。

包括主題的如下:


MQSeries Internet Gateway 關鍵字

關於將訊息傳送到 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 檔案名稱,可以用來保留任何其它關鍵字的預設值。
這些關鍵字的值可以用下列方式提供:
  1. 全部的關鍵字都會在 HTML 表格有指定的值,這張 HTML 表格是用來傳送訊息到閘道。
    請注意:如果您想使用儲存在 'INI" 檔案的值,這是唯一可以設定 MQIGwIniFile 的地方。(請參閱下列的 (2))。

  2. 關鍵字的值可以儲存在您自己的 'INI' 檔案

  3. 下列關鍵字的預設值是提供在 'dmq.ini' 檔案,而這個檔案是由 MQSeries Internet Gateway 提供,並且在 UNIX 平台可在 /var/mqm 找到, 在 OS/2 和 WindowsNT 可在 mqm\bin 找到。
    MQIGwReplyQueue
    DMQGATEWAY
    MQIGwWaitInterval
    10000 ms
    MQIGwContext
    全部
請注意:雖然任何關鍵字可以設定在上述任何或全部的地方,不過小心不要在任何一個地方重複定義一個以上的特定關鍵字,因為這 樣會導致意外的結果。

MQSeries Internet Gateway 會按照下列順序,搜尋不同關鍵字定義來源:

  1. HTML 表格
  2. 在 MQIGwIniFile 關鍵字指定的 'INI' 檔案
  3. dmq.ini 檔案
如果找不到下列關鍵字的有效值,則會使用基本的預設值:
MQIGwQueueManager
基本的預設值是 MQSeries 預設佇列管理程式
請注意: 在 MVS 方面,並沒有預設的佇列管理程式,您必須使用上述的其中一種方法,設定 MQIGwQueueManager 的值。

MQIGwWaitInterval
基本的預設值是不限定等候間隔

MQIGwWaitHTML
基本的預設值是 'timedout.htm',這個檔案是儲存在閘道檔案目錄

MQIGwContext
基本的預設值是全部
如果找不到下列任何關鍵字的有效值,交易就無法完成,而且會顯示錯誤訊息:

設定關鍵字

您可以變更 'dmq.ini' 的預設的關鍵字值,而且也可以建立自己的 'INI' 檔案來儲存自己的 'INI' 檔案。

MQSeries Internet Gateway 提供配置程式,協助您變更與建立預設值和自己的 'INI" 檔案。
請注意:強烈建議您使用此程式,不要使用編輯器來修改或 編輯檔案。編輯器很可能會損毀 'INI' 檔案的格式。

配置程式是以 HTML 檔案的形式提供給您,可以在 Web 瀏覽器執行。

請使用下列程序,執行您自己的配置。

  1. Open the MQSeries Internet Gateway file 'dmqcnf.htm' (請注意:如果2您正在 檢視的文件是安裝到您的 Web 伺服器機器,則程式只會從此連結執行)。

    此檔案是儲存在 MQSeries 閘道目錄的文件目錄

  2. 當畫面顯示的時候,

  3. 會顯示一個畫面,顯示在您已經選取之檔案裡面的關鍵字,以及目前的值。

  4. 關鍵字清單會隨您所做的變更而更新。

    如果已經決定儲存到某個已經存在並包含部份關鍵字的檔案,就會顯示檔案裡面完成的關鍵字清單。

  5. 如果想新增其它關鍵字,或者進一步修改清單裡面的值,請重複上述的程序。

    請注意:關鍵字名稱不可以使用內嵌的空格 。

如果修改 'dmq.ini' 檔案,則下次使用 MQSeries Internet Gateway 傳送 MQ 訊息的時候,就會將新的值當成預設值。如果已經修改或 建立自己的 'INI' 檔案,則下次使用表格來設定 MQIGwIniFile 關鍵字成您的 'INI' 檔案名稱時,就會使用新的值。

[返回圖書館] [內容] [上一個主題] [主題頂端] [下一個主題] [解說]


[ 首頁 | 訂購 | 搜尋 | 聯絡 IBM | 法律事誼 ]
(C) IBM Corporation 1997. 1999. All Rights Reserved