管理連接器

管理連接器可能包括啟動、暫停、停止及關閉連接器等作業。 如需配置連接器的相關資訊,包括設定內容、支援的商業物件及相關對映, 請參閱 System Implementation Guide

您可以從「系統監視器」或「系統管理程式」中啟動、暫停、停止及關閉連接器, 而且您可以在 Windows、OS/400 或 Linux 中使用 Script 以手動方式啟動連接器。

通用連接器管理程式 Script 會呼叫適當的 start_connector.bat Script 或 start_connector.sh Script,以處理連接器的實際連接器管理 (包括關閉)。 InterChange Server Express 產品會針對它所交付的每一個連接器, 提供一個 start_connector.bat Script 或 start_connector.sh Script。

本節包括下列主題:

檢視連接器狀態

啟動、停止和暫停連接器

為連接器配置流程控制的步驟

在 OS/400 上為配接器代理程式變更使用者設定檔的步驟

檢視連接器狀態

您可以登入「系統監視器」並開啟包含連接器狀態的檢視畫面,或使用「系統管理程式」的「InterChange Server 元件管理」檢視畫面,來檢視連接器的狀態。 若要使用「系統監視器」,請遵循連接到 InterChange Server Express 實例的步驟中的指示。

根據您所使用的工具,連接器狀態會以不同方式呈現。

使用系統監視器來檢視連接器狀態的步驟

請執行下列步驟,以在「系統監視器」中查看連接器狀態:

  1. 登入「系統監視器」(請參閱登入系統監視器的步驟)。
  2. 如果沒有顯示「系統概觀」檢視畫面,請按一下檢視畫面下的系統概觀鏈結。 畫面上會出現「系統概觀監視器」(請參閱圖 11)。

    安裝產品時,預設檢視畫面會設定為「系統概觀」,該檢視畫面所包含的預設監視器會設定為「系統概觀」。 這些預設值可加以變更,來符合您的監視需求。 如需指示,請參閱設定監視系統的檢視畫面

  3. 按一下伺服器名稱旁邊的三角形來顯示系統上的元件清單。
  4. 按一下執行中協同作業旁邊的三角形來顯示相關聯的連接器 (請參閱圖 25)。

    圖 25. 系統監視器,顯示連接器狀態的系統概觀


使用系統管理程式來檢視連接器狀態的步驟

請執行下列步驟,以在「系統管理程式」中檢視連接器狀態:

  1. 連接到包含您要檢視之連接器的 InterChange Server Express 實例。 如需連接到 InterChange Server Express 實例的指示,請參閱連接到 InterChange Server Express 實例的步驟
  2. 展開 InterChange Server Express 實例,然後展開「連接器」資料夾。

    連接器會出現在展開的「連接器」資料夾之下,並以不同顏色的燈號指示不同狀態。

    圖 26. 「InterChange Server 元件管理」檢視畫面中的「連接器」資料夾


表 5列示每一個連接器的顯示顏色所代表的連接器狀態, 並顯示在該狀態期間執行的動作。

表 5. 連接器狀態
連接器狀態 (色彩) 處理的訂閱要求 處理的服務呼叫要求 處理的訂閱遞送
作用中 (綠色)
已暫停 (黃色)
回復中或不明 (灰色)


不作用 (紅色)

啟動、停止和暫停連接器

本節說明如何啟動、停止及暫停連接器。

本節包含下列主題:

"連接器起始設定"

啟動、停止及暫停連接器的步驟

變更連接器狀態的系統管理程式指令

"在 Windows 上以手動方式啟動連接器的步驟"

在 OS/400 上以手動方式啟動連接器的步驟

在 Linux 上以手動方式啟動連接器的步驟

"關閉連接器"

"重新啟動連接器"

"設定連接器的自動及遠端重新啟動"

使用 OAD 作為 Windows 服務的步驟

連接器起始設定

第一次啟動連接器時,必須先起始設定該連接器。 起始設定連接器需要您以手動方式啟動它。如需以手動方式啟動連接器的指示, 請參閱在 Windows 上以手動方式啟動連接器的步驟

若連接器未啟動,請檢查並確定進行啟動的指令行是否併入現行的 InterChange Server Express 名稱。如需詳細資訊, 請參閱 Windows 版、Linux 版或 OS/400 版的 WebSphere Business Integration Server Express 安裝手冊。

啟動、停止及暫停連接器的步驟

起始設定連接器之後,您就可以利用系統監視器或系統管理程式來啟動、停止及暫停它。

請執行下列步驟,以在「系統監視器」中啟動、停止及暫停連接器:

  1. 在檢視「系統概觀」檢視畫面時 (請參閱圖 25),選取連接器左邊的勾選框來指定該連接器。
  2. 從檢視畫面左上角的圖示群組中選取「啟動」、「暫停」或「停止」圖示 (請參閱圖 27)。

圖 27. 系統監視器,啟動、暫停、重新啟動或關閉元件的圖示


請執行下列步驟,以在「系統管理程式」中啟動、停止及暫停連接器:

  1. 在「系統管理程式」中,跳至「InterChange Server 元件管理」檢視畫面中的「連接器」資料夾 (請參閱圖 26)。
  2. 用滑鼠右鍵按一下連接器名稱,然後選取啟動 ConnectorName暫停 ConnectorName停止 ConnectorName

變更連接器狀態的系統管理程式指令

下列清單說明您可用來變更連接器狀態的指令,並說明它們的處理動作:

啟動 ConnectorName
如果所選取的連接器已暫停或已停止,則會啟動它。 連接器會輪詢應用程式,且連接器控制程式會讀取持續性佇列。 同時會處理流程。

暫停 ConnectorName
如果所選取的連接器正在執行或已停止,則會暫停它。 連接器會停止輪詢應用程式,且連接器控制程式會停止讀取新要求,但是會繼續處理事件。

停止 ConnectorName
如果所選取的連接器正在執行或已暫停,則會停止它。 連接器會停止輪詢應用程式,要求會失敗並產生異常狀況訊息。 連接器控制程式會停止讀取持續性佇列。 此時不處理流程及要求。

關閉 ConnectorName
關閉所選取的連接器。連接器程序停止。

啟動 ConnectorName
重新啟動所選取的連接器。只有在連接器的 OADAutoRestartAgent 內容設定為 True 時,才能使用此動作。 請參閱"設定連接器的自動及遠端重新啟動"

在 Windows 上以手動方式啟動連接器的步驟

當您安裝 IBM WebSphere Business Integration Adapters 時, 即會在 IBM WebSphere 程式功能表中建立每一個已安裝之連接器的捷徑。連接器定義於 InterChange Server Express 儲存庫, 當您載入儲存庫時即會載入。

啟動 InterChange Server Express 會自動起始設定儲存庫中所定義的每一個連接器。 每當 InterChange Server Express 執行時,就可以使用連接器。

註:
若是第一次使用連接器,您必須先配置它,然後才能啟動連接器。如需配置指示, 請參閱您使用之連接器的配接器手冊。

請執行下列其中一項步驟,以啟動連接器:

您可以修改連接器捷徑或 start_connector.bat 檔案, 以自訂每一個連接器的啟動。請使用表 6中所列出的連接器啟動參數,以自訂連接器的啟動。-

表 6. 連接器啟動參數
參數 功能
-b 導致配接器代理程式當作背景程序來執行。 這會防止代理程式嘗試從系統輸入讀取資料以取得 'q' (quit) 字元。 從系統輸入讀取的代理程式將對 iSeries 子系統內執行的代理程式造成效能瓶頸。
-c configFile 啟動時使用的配置檔名稱。 若檔案名稱指定相對路徑,則啟動 Script 會在安裝產品的目錄中尋找檔案。 只有在使用本端連接器配置檔時,此參數才是必要的。 若您不是使用本端配置檔,請輸入 IBM WebSphere InterChange Server Express 使用的配置檔名稱 (依預設,是 InterchangeSystem.cfg)
-c 若使用者指定的配置檔不存在,則使用預設的配置檔。
-d 指定 C++ 連接器程式庫檔案的名稱,它是一個動態鏈結程式庫 (DLL)。這個 DLL 名稱不包括 .dll 副檔名。啟動 Script 為所有 C++ 連接器指定這個選項。
-f pollFrequency 輪詢頻率是輪詢動作之間的毫秒數。
  • 若要指定毫秒數,請提供 pollFrequency 的值。
  • 若要讓連接器只有當您在連接器的「指令提示」視窗中鍵入值 p 時才進行輪詢, 請指定 -fkey 選項。
  • 若連接器配置為只處理商業物件要求,而不處理應用程式事件,則輪詢是不必要的; 您可以指定 -fno 以停用輪詢。

此參數的值會置換任何儲存庫定義。 您可以指定 -fkey-fno,但不能同時指定兩者。

-j 指定以 Java 撰寫連接器。 若您指定 -l className,則此參數是選用的。
-l className 指定 Java 連接器廣域類別的名稱,它是連接器基礎類別的延伸規格。 啟動 Script 為所有 Java 連接器指定這個選項。
-n connectorName 指定要啟動的連接器名稱。
-p password 指定連接器用來存取 InterChange Server Express 的密碼。
-s serverName 指定伺服器的名稱。這是必要的參數。名稱有區分大小寫。
-t 開啟連接器內容 SingleThreadAppCalls。這個內容保證連接器組織架構對應用程式特有的連接器程式碼所發出的所有呼叫中, 都附有一個事件觸發的流程。 預設值是 false。重要事項:請勿變更此內容的出貨值。 每一個連接器都有適當的執行緒作業模型設定。 只有在啟動您所建立的連接器時,才能指定此選項。
-x connectorProps 將應用程式特有的連接器內容傳送至連接器。 請使用格式 prop_name=value 來輸入每一個值。

在 OS/400 上以手動方式啟動連接器的步驟

在 OS/400 上執行的連接器代理程式通常是以下列三種方式之一來啟動和停止。

執行下列其中一個步驟,在 OS/400 上以手動方式啟動連接器:

在 Linux 上以手動方式啟動連接器的步驟

執行下列其中一個步驟,在 Linux 上以手動方式啟動連接器:

關閉連接器

本節包含下列主題:

在系統監視器中關閉連接器的步驟

在系統管理程式中關閉連接器的步驟

關閉連接器會停止連接器程序。 關閉連接器之前,請先暫停或停止每一個使用該連接器的協同作業物件 (協同作業必須配置為暫停;如需如何執行此作業的詳細資料,請參閱協同作業文件)。 如果在「協同作業一般內容」視窗中選取了發生嚴重的錯誤時暫停勾選框, 則發生嚴重錯誤時,協同作業會自動暫停。 然後,這類協同作業的最新未處理事件會移至事件提交佇列。

您可以執行「永久」或「暫時」關閉連接器。 您可以啟用或停用 (預設值) 自動重新啟動,以控制關閉的類型:

如需啟用或停用自動重新啟動的指示,請參閱"設定連接器的自動及遠端重新啟動"

關閉連接器的指示是根據您用來監視系統的工具而定:

在系統監視器中關閉連接器的步驟

請執行下列步驟,以在「系統監視器」中關閉連接器:

  1. 從「系統概觀」檢視畫面中,選取您想要關閉的連接器之協同作業物件左邊的勾選框,然後按一下檢視畫面左上角的「暫停」按鈕,即可選取您想要關閉的連接器協同作業物件 (請參閱圖 27)。請針對與連接器相關聯的每一個協同作業,執行此作業。
  2. 選取您想要關閉之連接器的勾選框,然後按一下檢視畫面左上角的「關閉」按鈕 (請參閱圖 27)。

在系統管理程式中關閉連接器的步驟

請執行下列步驟,以在「系統管理程式」中關閉連接器:

  1. 展開「InterChange Server 元件管理」檢視畫面中的「協同作業物件」資料夾 (請參閱圖 30)。
  2. 用滑鼠右鍵按一下與連接器相關聯的協同作業物件,然後按一下 暫停 CollaborationName。 請針對與連接器相關聯的每一個協同作業,執行此作業。

    協同作業物件圖示會變更為有兩條垂直線的圖示。

  3. 從「InterChange Server 元件管理」檢視畫面中已展開的「連接器」資料夾中, 用滑鼠右鍵按一下連接器,然後按一下關閉 ConnectorName
注意:
請不要使用 Ctrl+C 或 ENDJOB CL 指令,來關閉連接器。這麼做是為了預防連接器以有次序的方式關閉。 此外,如果您使用 Ctrl+C (ENDJOB CL 指令),或如果您使用 『q』 或其他手動方法來執行關閉, 且已啟用 Object Activation Daemon (OAD),則 OAD 會立即重新啟動連接器。

重新啟動連接器

當您在「系統監視器」或「系統管理程式」的「InterChange Server 元件管理」 檢視畫面中,使用「關閉連接器」動作之後,就可以使用本節所說明的上述程序來重新啟動連接器。 只有在您已啟用連接器的自動及遠端重新啟動時 (請參閱設定連接器的自動及遠端重新啟動),才能使用此動作。

本節包含下列主題:

使用系統監視器來重新啟動連接器的步驟

使用系統管理程式來重新啟動連接器的步驟

使用系統監視器來重新啟動連接器的步驟

請執行下列步驟,以在「系統監視器」中重新啟動連接器:

  1. 從「系統概觀」檢視畫面 (請參閱圖 25) 中,選取您要重新啟動之連接器左邊的勾選框。
  2. 按一下檢視畫面左上角的「重新啟動代理程式」按鈕 (請參閱圖 27)。

使用系統管理程式來重新啟動連接器的步驟

請執行下列步驟,以在「系統管理程式」中重新啟動連接器:

  1. 從「系統管理程式」的「InterChange System 元件管理」檢視畫面中,展開「連接器」資料夾 (請參閱圖 26)。
  2. 用滑鼠右鍵按一下您要重新啟動的連接器,然後按一下啟動 ConnectorName

設定連接器的自動及遠端重新啟動

運用 IBM WebSphere MQ 觸發的 Object Activation Daemon (OAD),您可以啟用連接器來支援自動及遠端重新啟動功能, 讓連接器能夠處理下列狀況:

本節包含下列主題:

在 Windows 上設定連接器的自動及遠端重新啟動的步驟

在 Linux 上設定連接器的自動及遠端重新啟動的步驟

在 OS/400 上設定連接器的自動及遠端重新啟動的步驟

為 MQ 觸發的 OAD 啟用連接器的步驟

在 Windows 上設定連接器的自動及遠端重新啟動的步驟

請執行下列步驟,在 Windows 平台上設定連接器的自動及遠端重新啟動:

  1. 安裝 IBM WebSphere MQ。

    使用 MQ 觸發的 OAD 需要安裝 MQ 觸發的監視器和特定佇列的配置。 此監視器會安裝成 WebSphere MQ 軟體的一部分。這些佇列是由特殊的 mqtriggersetup.bat Script 所建立及配置。

    重要事項:
    WebSphere MQ 觸發的監視器必須存在於連接器代理程式所在的機器上。 如果有多個連接器代理程式位於單一機器上,則只需要有一個「MQ 觸發監視器」。
  2. 啟動「MQ 觸發監視器」。
    若要啟動 MQ 觸發的 OAD,您必須啟動「MQ 觸發監視器」, 您可以用下列其中一種方式來進行:
  3. 配置連接器以進行自動及遠端重新啟動。請參閱以下的為 MQ 觸發的 OAD 啟用連接器的步驟
  4. 對於每一個需要重新啟動的連接器,執行 mqtriggersetup.bat Script (位於 bin 目錄),例如:
    mqtriggersetup.bat WebSphereICS.queue.manager JDBC WebSphereICS D:/IBM/WebSphereServer/connectors/JDBC/start_JDBC.bat

在 Linux 上設定連接器的自動及遠端重新啟動的步驟

請執行下列步驟,在 Linux 平台上設定含連接器的自動及遠端重新啟動:

檔案的引數如下:

例如:

mqtriggersetup
 WebSphereICS.queue.manager
 JDBC
 /home/smbadmin/IBM/WebSphereItemSync/connectors/JDBC/start_JDBC.sh
 JDBC WebSphereICS
 

在 OS/400 上設定連接器的自動及遠端重新啟動的步驟

請執行下列步驟,在 OS/400 平台上設定連接器的自動及遠端重新啟動:

  1. 執行具有必要引數的 mqtriggersetup.sh,來新增及配置佇列以傳輸觸發事件。 這個檔案位於安裝產品的目錄,例如,/QIBM/ProdData/WBIServer43/bin。檔案的引數如下:

    例如:

    mqtriggersetup.sh
     InstanceName.QUEUE.MANAGER
     JDBC
     /QIBM/UserData/WBIServer43/QWBIDFT/connectors/JDBC/start_JDBC.sh
     InstanceName
     QWBIJDBCC
     

    其中 InstanceName 是 InterChange Server Express 實例的名稱,以大寫字母輸入。

  2. 啟用「WebSphere MQ 觸發監視器」。例如:
    STRMQMTRM INITQNAME(INITIATION.QUEUE)
     MQMNAME(InstanceName.QUEUE.MANAGER)
     

    其中 InstanceName 是 InterChange Server Express 實例的名稱,以大寫字母輸入。

  3. 授予 QMQM 使用者設定檔下列物件的 *USE 權限:
    配接器的工作說明 (*JOBD) (例如,QWBISVR43/QWBIJDBCC for JDBC)

為 MQ 觸發的 OAD 啟用連接器的步驟

請執行下列步驟,以在您設定 OAD 內容之前,針對連接器啟動「快速連接器配置程式」:

  1. 啟動 InterChange Server Express。
  2. 開啟「系統管理程式」。
  3. 按兩下「整合元件程式庫」下的連接器。 這樣會開啟「快速連接器配置程式」。
  4. 在「標準內容」標籤上,設定標準內容,如表 7 所示。


    表 7. 在「快速連接器配置程式」中配置標準內容
    名稱 可能的值 說明 預設值
    OADAutoRestartAgent truefalse 如果這個內容設為 True,則異常關閉之後,MQ 觸發的 OAD 會自動嘗試重新啟動連接器。 它也可以用來從遠端啟動連接器代理程式。此值是動態的。 false
    OADMaxNumRetry 數字 嘗試次數上限。 10,000
    OADRetryTimeInterval 分鐘 每一次重試之間的分鐘數。如果連接器代理程式在此時間間隔內未啟動,會再次嘗試重新啟動代理程式。 10

從「快速連接器配置程式」中,您可以採取下列任一動作:

使用 OAD 作為 Windows 服務的步驟

註:
本主題只適用於 Windows 平台。

如果您使用 OAD 配置連接器來進行自動重新啟動或遠端啟動, 請不要配置連接器使其以自動 Windows 服務的方式來執行。 相反的,請安裝 WebSphere MQ 觸發監視器以執行為 Windows 服務。 當系統啟動時,OAD 會自動啟動為 Windows 服務;而當 InterChange Server Express 重新啟動時,它會透過 OAD 來啟動連接器。

重要事項:
依預設,連接器會安裝成必須以手動方式啟動的 Windows 服務。 如果連接器的 Windows 服務從手動變更為自動,則遠端重新啟動功能無法運作。

請執行下列步驟,以將 WebSphere MQ 觸發監視器安裝成 Windows 服務:

  1. 選取開始 > 程式集 > IBM WebSphere MQ > WebSphere MQ 服務
  2. 用滑鼠右鍵按一下 WebSphere Business Integration Server Express 使用的佇列管理程式,然後按一下新建 > 觸發監視器。 畫面上會出現「建立觸發監視服務」對話框。
  3. 按一下參數標籤。在佇列名稱欄位中,輸入字串 『INITIATION.QUEUE』。 在說明直欄中,「觸發監視器」會以該佇列管理程式的服務之一的方式出現。
  4. 執行「Windows 服務安裝程式」工具。選取服務元件清單中的 InterChange Server Express
  5. 服務相依關係欄位中,輸入 OAD Windows 服務的名稱。

完成這些步驟之後,您就可以使用 Windows 中的「服務」工具來啟動和停止常駐程式。

為連接器配置流程控制的步驟

流程控制是一個可配置的服務,可讓您管理連接器流程和協同作業物件佇列。 配置流程控制的參數可為全系統或個別元件,或兩者。 若您配置兩者,個別元件配置將取代全系統配置。 如需配置全系統流程控制的指示,請參閱配置全系統流程控制的步驟。本節說明如何配置連接器的流程控制。

註:
個別連接器或協同作業物件的配置變更是動態的,表示它們不需要重新啟動 InterChange Server Express。 流程控制的全系統配置變更需要重新啟動 InterChange Server Express。

若要監視流程控制在系統中的運作方式,您可以檢視「流程控制」監視器和檢視畫面 (「系統監視器」所提供的一部分), 或是在「系統管理程式」的「InterChange Server 元件管理」檢視畫面中,檢視協同作業物件或連接器的統計資訊。 如需使用「系統監視器」中的「流程控制」監視器和檢視畫面的詳細資訊,請參閱複查預設監視器的步驟使用預設檢視畫面的步驟。如需從「InterChange Server 元件管理」檢視畫面中檢視流程控制的詳細資訊, 請參閱檢視協同作業物件統計資訊的步驟檢視連接器統計資訊的步驟

請執行下列步驟,以針對連接器配置流程控制:

  1. 在「系統管理程式」中,導覽至您要配置流程控制的連接器,然後按兩下該連接器。 即會開啟「快速連接器配置程式」(請參閱圖 28)。

    圖 28. 快速連接器配置程式,標準內容標籤


  2. 在「標準內容」標籤中,按一下 MaxEventCapacity 內容的資料格。
  3. 將此值變更您要為連接器排入佇列的事件數目上限。 這個內容的有效值範圍是從 1 到 2147483647。
  4. 按一下檔案 > 儲存 > 至專案。 下列訊息會出現在「快速連接器配置程式」的下半部: 連接器 'ConnectorName' 順利儲存。

在 OS/400 上為配接器代理程式變更使用者設定檔的步驟

依預設,OS/400 上的配接器代理程式是在 QWBISVR43 使用者設定檔下執行。因此,這個使用者設定檔必須具有讀取及可能更新應用程式資訊的權限。 如果您沒有給予設定檔 QWBISVR43 這個權限,則可以變更針對配接器代理程式程序所使用的使用者設定檔。

請執行下列步驟,來變更配接器代理程式程序的使用者設定檔:

  1. 使用如下的 CHGJOBD CL 指令來變更配接器代理程式的工作說明:
    CHGJOBD JOBD(QWBISVR43/jobdname) USER(newid)
    其中 jobdname 是配接器代理程式的工作說明名稱, 而 newid 則是您想要配接器代理程式在其下執行的使用者設定檔。 newid 使用者設定檔應該已經對應用程式資訊具有權限。
  2. 使用下列 CL 指令,將配接器工作說明的權限給予使用者設定檔:
    GRTOBJAUT OBJ(QWBISVR43/jobdname) OBJTYPE(*JOBD) USER(newid)
    其中 jobdname 是配接器代理程式的工作說明名稱, 而 newid 則是您想要配接器代理程式在其下執行的使用者設定檔。
  3. 使用下列 CL 指令,將 QWBISVR43 程式庫的權限給予使用者設定檔:
    GRTOBJAUT OBJ(QWBISVR43) OBJTYPE(*LIB) USER(newid)
    其中 newid 是您想要配接器代理程式在其下執行的使用者設定檔。
  4. 使用下列 CL 指令,將 QWBISVR43 子系統說明的權限給予使用者設定檔:
    GRTOBJAUT OBJ(QWBISVR43/QWBISVR43) OBJTYPE(*JOBD) USER(newid)
    其中 newid 是您想要配接器代理程式在其下執行的使用者設定檔。
  5. 使用下列 CL 指令,將 QWBISVR43 程式庫中 QWBISVR43 類別的權限給予使用者設定檔:
    GRTOBJAUT OBJ(QWBISVR43/QWBISVR43) OBJTYPE(*CLS) USER(newid)
    其中 newid 是您想要配接器代理程式在其下執行的使用者設定檔。
  6. 使用下列 CL 指令,將配接器啟動 Script 所在的配接器目錄的權限給予使用者設定檔:
    CHGAUT OBJ('/pathToStartupScript') USER(newid) DTAAUT(*RWX)
    其中 pathToStartupScript 是配接器的啟動 Script 路徑, 而 newid 則您想要配接器代理程式在其下執行的使用者設定檔。

Copyright IBM Corp. 2004