配置連接器

「連接器配置程式」工具提供一個圖形式使用者介面來配置連接器。 當您完成連接器配置內容值的指定作業之後,「連接器配置程式」會產生一個連接器 配置檔並將它放置於連接器的本端儲存庫中。

重要事項:
若商業整合配接器在 UNIX 上執行,您必須在 Windows 上使用「連接器配置程式」 建立配置檔,然後將這個檔案複製到您的 UNIX 機器。建立配置檔時,請遵循 UNIX 路徑和 檔案名稱使用慣例來設定內容。

當您執行 IBM WebSphere Business Integration Adapter 安裝程式時, 它就會載入 ProductDir\connectors\repository\ConnName 中連接器的連接器定義檔案。 此連接器定義檔提供一些配置檔內容的起始值。下一步是使用「連接器配置程式」來 建立連接器配置檔。連接器定義檔提供一些配置檔起始值時, 配置檔包含連接器的標準和應用程式特有內容,並指定其支援的商業物件。 附錄 C, 連接器的標準配置內容詳細說明這些內容。

如果您手動安裝了新連接器 (不是由 IBM 預先建置), 就必須使用「連接器配置程式」為該連接器建立新配置檔。
要訣

使用與您要配置的連接器之配接器使用手冊一起提供的下面資訊,它包含:

  • 使用「連接器配置程式」的完整指示
  • 有關連接器的標準內容、應用程式特有內容及記載與追蹤選項之支援設定的詳細資訊。

以下各節討論套用至每一個使用 WebSphere 訊息分配管理 系統的連接器之「連接器配置程式」設定。

指定連接器的本端儲存庫位置

您可以使用標準內容 RepositoryDirectory 來指定您要使用的本端儲存庫位置。 預設位置為 ProductDir\repository

指定連接器要使用的佇列

配置 WebSphere MQ 佇列中,您定義了一組供連接器與訊息分配管理 系統通訊的佇列。於「連接器配置程式」中,按一下標準內容標籤, 並使用下列標準內容將這些佇列指定給連接器:

設定佇列管理程式的連線模式

預設連線模式為連結模式。如下所示來指定用戶端模式:

  1. 於「連接器配置程式」中,按一下標準內容標籤。
  2. 指定下列值給標準內容 jms.MessageBrokerName: QueueMgrName:[Channel]:[HostName]:[PortNumber],其中變數代表下列所示:

    QueueMgrName
    佇列管理程式的名稱。

    Channel
    用戶端使用的通道。

    HostName
    佇列管理程式所在的機器名稱。

    PortNumber
    佇列管理程式用來接聽的埠號。

例如:

jms.MessageBrokerName = WMQIB.Queue.Manager:CHANNEL1:RemoteMachine:1456
 

設定同步執行的配置內容

若您的連接器使用同步執行,請按一下「標準內容」標籤並設定下列內容:

配置記載與追蹤選項

記載用來傳遞系統訊息、元件狀態變更、失敗,以及追蹤資訊。產生下列檔案:

表 12. 連接器記載與追蹤檔。
預設檔案名稱和路徑 說明

暫時日誌檔:

ProductDir\broker_name_connector_name_tmp.log

於啟動期間,連接器會產生一個暫時日誌檔。 此檔案包含啟動期間記載的所有訊息,包括傳遞至連接器組織架構的連接器內容和商業物件定義。 且檔案寫入產品的安裝目錄中。

連接器日誌檔:

UNIX:依預設,連接器將訊息記載到 STDOUT,然後將那些訊息 重新遞送至 ProductDir/logs/connector_manager_ConnNamelog

WINDOWS:依預設,連接器將訊息記載到 STDOUT, 但可經由配置來傳送到 ProductDir 目錄中的 本端目的地日誌檔。

連接器的日誌檔用來儲存連接器所發出的訊息。其亦包含有關 WebSphere MQ 通訊錯誤的訊息。

連接器訊息檔案:

ProductDir\connectors\messages\ConnName_LocaleName.txt

此檔案包含連接器所發出每一個訊息的完整內容。 您可以使用此檔案來查閱您在日誌檔中所看到的訊息 ID 內容。 若連接器配置檔中指定的語言環境不受支援,則會使用 ConnName.txt 檔。

追蹤檔案:

對於 UNIX 和 Windows 而言,預設值為 STDOUT。

包含所選取追蹤層次指定的追蹤訊息。

記載系統恆為作用中,並且提供連接器的精確監視。

若要進行問題疑難排解,您可以開啟追蹤。追蹤訊息可協助您監視 商業整合系統元件執行的動作。 追蹤層次定義寫入追蹤檔的詳細資料數目。追蹤層次越高,您接收的詳細資料就越多。 於下列情況中,追蹤與記載不同:

依預設,追蹤是關閉的,因為它會產生比您平常所需要更詳細的資訊。

如需使用 LogViewer 來檢視記載與追蹤的相關資訊,請參閱使用「日誌檢視器」來檢視連接器訊息

配置連接器記載

若要配置連接器記載選項,請按一下追蹤/日誌檔標籤並指定下列項目:

  1. 若要讓日誌訊息遞送至 STDOUT,請按一下目的主控台 (STDOUT) 勾選框。
  2. 若要讓日誌訊息遞送至檔案,請按一下目的檔案勾選框, 並指定要使用的日誌檔完整路徑名稱。 您可以指定「目的主控台」和「目的檔案」選項,讓日誌訊息遞送至主控台和檔案。
  3. 如果您指定使用日誌檔,則亦請指定下列選項:
    1. 若要限制日誌檔大小,請將日誌檔大小設定為數值和測量單位。
    2. 若要允許日誌檔無限成長,請按一下無限制勾選框。
    3. 如果您已設定日誌檔的大小上限且要使用檔案保存,請將保存檔數目設為您要維護的保存檔數目。

如需管理日誌檔的詳細資訊,請參閱管理日誌檔和追蹤檔

配置連接器追蹤

若要配置連接器追蹤選項,請:

  1. 按一下追蹤/日誌檔標籤。
  2. 若要讓追蹤訊息遞送至 STDOUT,請勾選目的主控台 (STDOUT)
  3. 若要讓追蹤訊息遞送至檔案,請勾選目的檔案,並指定要使用的 追蹤檔完整路徑名稱。您可以指定目的主控台目的檔案選項,讓追蹤訊息遞送至主控台和檔案。
  4. 如果您指定使用追蹤檔,則亦請指定下列選項:
    1. 若要限制追蹤檔大小,請將追蹤檔大小設定為數值和測量單位。
    2. 若要允許追蹤檔無限成長,請勾選無限制
    3. 如果您已設定追蹤檔的大小上限且要使用檔案保存,請將保存檔數目設為您要維護的保存檔數目。
  5. 若要設定追蹤層次,請:
    1. 按一下標準內容標籤。
    2. AgentTraceLevel 內容設定為表 13中 列示的其中一值。

如需連接器不同追蹤層次所產生資訊的詳細資料,請參閱您要配置之連接器的配接器使用手冊。 您可將連接器追蹤設定為下列其中一個層次:

表 13. 連接器追蹤層次。
追蹤層次 說明
1 追蹤商業物件的起始設定以及傳送和接收。
2 列印層次 1 的訊息。另外,在相同類型的事件中,提供的資訊比層次 1 更加詳細。
3 列印層次 1 和 2 的訊息。另外,追蹤連接器代理程式與 傳訊驅動程式之間的訊息交換。
4 列印層次 1 到 3 的訊息。另外,追蹤連接器內部層次之間商業物件的傳遞。
5 列印層次 1 到 4 的訊息。另外,追蹤連接器內部層次之間管理訊息的傳遞。

新建或變更的追蹤層次會在您重新啟動連接器後生效。

如需保存追蹤檔的詳細資訊,請參閱管理日誌檔和追蹤檔

配置連接器啟動檔案、捷徑及環境變數

啟動連接器和設定作業所需的程序皆視執行連接器的所在平台而定。

若為 Windows

當您在 Windows 上安裝 WebSphere Business Integration Adapters 時, 會在 WebSphere Business Integration Adapters 程式功能表建立所安裝每一個連接器的 捷徑 (開始 > 程式集 > IBM WebSphere Business Integration Adapters > 配接器 > 連接器)。您必須使用附錄 D, 連接器啟動選項中列示的 啟動選項來自訂下列項目:

若為 UNIX

於 UNIX 環境中,您執行 connector_manager_connName Script 來啟動連接器, 此 Script 是一般連接器管理程式 Script (ProductDir/bin/connector_manager ) 的封套。 此封套包含下列資訊:

若您已建立自訂配接器或已使用 ESD 安裝配接器,則在第一次啟動連接器之前, 您必須執行下列動作:

  1. 執行「連接器 Script 產生器」工具,以連接器的配置檔名稱更新 connector_manager_connName Script。 如需執行此工具的詳細資訊,請參閱附錄 E, 使用「連接器 Script 產生器」工具

    或者,您可瀏覽至 ProductDir/bin 目錄, 並編輯 connector_manager_connName 檔案, 以指定連接器的配置檔名稱。於此檔案中,尋找 AGENTCONFIG_FILE 變數並將其設為 配置檔的完整路徑名稱,如下所示:

    AGENTCONFIG_FILE=ConfigFile
     
  2. 若需要的話,可更新您的 PATH 環境變數以包含 ProductDir/bin 目錄。
  3. 確定 CWSharedEnv.sh 檔來自您帳戶的 Shell 啟動 Script (例如 .cshrc)。

自訂啟動 Script

一般連接器管理程式 Script 會呼叫適當的 start_connector.sh Script, 其為管理特定連接器的實際 Script。每個 WebSphere Business Integration 配接器都包括 start_connector.sh Script。您可以修改 start_connector.sh Script, 使其包含附錄 D, 連接器啟動選項中列示的所有受支援啟動選項。

註:
如需建立連接器啟動檔的相關資訊,請參閱 Connector Development Guide for C++Connector Development Guide for Java

Copyright IBM Corp. 1997, 2003