設定主應用程式的 BizTalk 配接器
[BizTalk Adapter for Host Application Configuration] 對話方塊可讓您定義和管理遠端 IBM CICS、IMS 或 iSeries 系統的連線。 當您按一下 [ 連接字串 ] 屬性值欄位時，就會啟動它。 您可以使用 BizTalk Adapter for Host Application Configuration 對話方塊來新增 TI .NET 元件。 您可以使用它做為對應的一部分，以匯入、匯出和刪除對應、編輯連接字串，以及檢視 TI .NET 元件的屬性。
[ 主應用程式組態 ] 對話方塊元件包括工具列、功能表、資料格和結果窗格。 本主題包含下列各節，描述您可以執行的各種工作。
工具列和功能表命令
您可以透過工具列和快顯功能表存取建立和管理連接字串的命令。 您可以在資料方格中的任何位置按一下滑鼠右鍵，以顯示內容相關的功能表。 例如，當您以滑鼠右鍵按一下連接字串時，可以檢視、編輯、刪除、匯入和匯出對應。 您可以按兩下連接字串，以在編輯模式中啟動它。 DELETE 鍵會刪除目前選取的專案，而 F1 鍵會開啟線上說明。
下列清單描述您可以執行的動作：
從全域組件快取新增TI .NET 元件， (GAC) ，或使用本機檔案路徑將元件新增至對應。 資料行會填入從元件反映的預設值。 如果您未輸入必要的值，預設連接字串將無法使用。
刪除 選取的對應。 隨即會出現一個對話方塊，以確認刪除。
選取對應時，編輯對應連接字串部分。 啟動 [連接字串]對話方塊以編輯連接字串。
將對應匯出至 XML 允許備份對應。 您稍後可以使用匯入對應功能來還原它們。 匯入/匯出功能可讓您在端點之間共用對應。
匯入對應或 RE 可讓您匯入 BizTalk Adapter for Host Application Configuration 對話方塊匯出的 XML。 您也可以在選取對應時，匯入 TI 管理員匯出的 RE 定義。
檢視 TI .NET 元件的屬性 會顯示元件屬性。 XML 標記會顯示這個元件支援的輸入/輸出檔案名稱。 方法名稱是標籤名稱的一部分，但在尋找對應時不會使用它。 所有屬性都是唯讀的。
對應 DataGrid 視窗
[ 對應 DataGrid ] 對話方塊包含下列專案：
狀態 (完成或不完整) 。 如果連接字串遺漏連線資訊，則會出現紅色圓圈以白色驚嘆號表示的警告。 新增遺漏的資訊之後，警告就會消失。
用於對應之 TI 元件的ClassName和介面名稱。
元件 名稱。 如果元件是從 GAC 載入，則為元件的強式名稱，如果是本機組件，則為元件的完整路徑。 新增元件時會自動填入此欄位，而且是唯讀的。
遠端環境會定義連接字串。 這代表從 BizTalk 主機應用程式配接器接收要求的遠端系統特性。 連接字串包含遠端環境類型、程式設計模型、遠端主機識別、網路傳輸和其他與遠端主機通訊時所使用的設定。
遠端端點 遠端 IBM 主機的 DNS 名稱或 IP 位址。
結果窗格會顯示目前所選對應連接字串的值。
建立和管理對應
本節說明您可以執行的工作。
新增元件以建立連接字串
在工具列上，按一下資料夾圖示，然後 選取 [從 GAC 新增元件 ] 或 [ 新增本機組件]。 從 GAC 新增元件 將會啟動對話方塊，其中列出您可以在 GAC 中選取的所有元件。 如果您選取 [新增本機組件]，您可以流覽本機安裝的元件。
您也可以使用 [ 新增 GAC ] 或從功能表中 新增本機組件選項來新增元件 。
刪除連接字串
選取要刪除的對應或對應。 按一下工具列上的 [X] 圖示，即可刪除選取的對應。 隨即顯示對話方塊，以便確認刪除。
您也可以使用功能表中的 [ 刪除對應 ] 選項來刪除對應。
編輯連接字串
連接字串是用來凍結 RE 實例。 當指定元件時，它會填入預設值。 按兩下選取的對應，選取 [編輯]，或選取 [編輯連接字串] 功能表以啟動 [連接字串]對話方塊。 這可讓您編輯所指定 RE 的連接字串。 如果未輸入必要的值，就會顯示錯誤旗標。
RE 物件會驗證所需的最小屬性值。 如果未設定必要的屬性值，則會標示連接字串儲存格。 必要屬性會列在本主題的 連接字串設定和對應 一節中。 RE 驗證在範圍內受到限制，而不適當的值可能會導致 TI 執行時間錯誤。
對話方塊會在方格中顯示可編輯和不可編輯的屬性。 底部的唯讀文字方塊會顯示根據屬性方格上輸入的值所建立的連接字串。 屬性會根據 RE 物件所定義的公用方法收集，其值是由物件本身所定義。 提供某些類型轉換器和屬性編輯器，以利編輯屬性值。
遠端環境 會顯示連線到主機所需的屬性。 這些是以屬性方格中的星號 (*) 表示。 如果遺漏一或多個屬性，資料方格上會顯示具有白色驚嘆號的紅色圓圈。 此警告會通知您，遺漏的屬性可以在執行時間使用覆寫來提供。
安全性設定是由預先定義的安全性列舉所控制，這些列舉可使用 OR 運算子來形成新的安全性設定。
Off旗標是用戶端、套件和使用者專屬的。 核取其他三項的任一項時，將會清除[關閉]。 核取 [關閉 ] 時，將會清除所有其他三個選項。
SSOApplication 編輯器會從具有次要變更的舊版移植。 您可以直接在屬性方格中指定分支機搆應用程式，或使用編輯器來挑選已經建立的應用程式。
連接字串設定和對應
下表顯示定義主機環境和程式設計模型的支援屬性。 星號表示必要的屬性。
預設值是由 RE 物件本身所設定，而且會執行有限的驗證。
SNA 使用者資料
| 屬性 | 值 |
|---|---|
| 屬性 | 值 |
| CodePage | 37 |
| 地區設定 | 1033 |
| **LocalLUName* | |
| **ModeName* | PA62TKNU |
| 名稱 | SNAUserData。 唯讀。 |
| **RemoteLUName* | |
| 安全性 | 關閉 |
| SSOApplication | |
| SynLevel2Supported | False |
| TimeOut | 0 |
*必要欄位。
SNA 連結
| 屬性 | 值 |
|---|---|
| 屬性 | 值 |
| AdministrationFlags | 0 |
| CodePage | 37 |
| 地區設定 | 1033 |
| **LocalLUName* | |
| MirrorTranId | CSMI |
| **ModeName* | PA62TKNU |
| 名稱 | SNALink。 唯讀。 |
| **RemoteLUName* | |
| 安全性 | 關閉 |
| SSOApplication | |
| SyncLevel2Supported | False |
| TimeOut | 0 |
*必要欄位。
HTTP 使用者資料
| 屬性 | 值 |
|---|---|
| 屬性 | 值 |
| AliasTransactionId | |
| AllowRedirects | False |
| CodePage | 37 |
| **HttpPort* | |
| **IPAddress* | |
| 地區設定 | 1033 |
| 名稱 | HttpUserData。 唯讀。 |
| 安全性 | 關閉 |
| SSOApplication | |
| TimeOut | 0 |
| UserAgent | |
| UseSsl | False |
*必要欄位。
HTTP 連結
| 屬性 | 值 |
|---|---|
| 屬性 | 值 |
| AliasTransactionId | |
| AllowRedirects | False |
| CodePage | 37 |
| 轉換器 | |
| **HttpPort* | |
| **IPAddress* | |
| 地區設定 | 1033 |
| MirrorProgramName | |
| 名稱 | HttpLink。 唯讀。 |
| 安全性 | 關閉 |
| SSOApplication | |
| TimeOut | 0 |
| UseConverter | False |
| UserAgent | |
| UseSsl | False |
*必要欄位。
IMS LU6.2
| 屬性 | 值 |
|---|---|
| 屬性 | 值 |
| CodePage | 37 |
| 地區設定 | 1033 |
| **LocalLUName* | |
| **ModeName* | PA62TKNU |
| 名稱 | IMSLU62。 唯讀。 |
| **RemoteLUName* | |
| 安全性 | 關閉 |
| SSOApplication | |
| TimeOut | 0 |
*必要欄位。
IMS 連線
| 屬性 | 值 |
|---|---|
| 屬性 | 值 |
| CodePage | 37 |
| ImsFormatModName | |
| **IPAddress* | |
| ItocExitName | |
| 地區設定 | 1033 |
| 名稱 | IMSConnect。 唯讀。 |
| OtmaSystemId | |
| 安全性 | 關閉 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*必要欄位。
TRM 使用者資料/連結
| 屬性 | 值 |
|---|---|
| 屬性 | 值 |
| CodePage | 37 |
| ConcurrentServerTransactionId | Msc |
| **IPAddress* | |
| 地區設定 | 1033 |
| 名稱 | TRMUserData。 唯讀。 |
| 安全性 | 關閉 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*必要欄位。
ELM 使用者資料/連結
| 屬性 | 值 |
|---|---|
| 屬性 | 值 |
| CodePage | 37 |
| **IPAddress* | |
| 地區設定 | 1033 |
| 名稱 | ELMUserData。 唯讀。 |
| 安全性 | 關閉 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*必要欄位。
分散式程式呼叫
| 屬性 | 值 |
|---|---|
| 屬性 | 值 |
| CodePage | 37 |
| **IPAddress* | |
| 地區設定 | 1033 |
| 名稱 | DistributedProgramCall。 唯讀。 |
| 安全性 | 關閉 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*必要欄位。
系統 Z 通訊端使用者資料/連結
| 屬性 | 值 |
|---|---|
| 屬性 | 值 |
| CodePage | 37 |
| **IPAddress* | |
| 地區設定 | 1033 |
| 名稱 | SystemzSocketsUserData。 唯讀。 |
| 安全性 | 關閉 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*必要欄位。
系統 I 通訊端使用者資料
| 屬性 | 值 |
|---|---|
| CodePage | 37 |
| **IPAddress* | |
| 地區設定 | 1033 |
| 名稱 | SystemSocketUserData。 唯讀。 |
| 安全性 | 關閉 |
| SSOApplication | *TCPPorts |
| TimeOut | 0 |
*必要欄位。
匯入對應
若要匯入 BizTalk Adapter for Host Application Configuration 所匯出的對應，請按一下 [ 匯入對應] 或 [RU ] 圖示。 選取 [匯入對應]，或從 [檔案] 功能表中選取 [匯入對應]。 然後，您可以流覽 BizTalk Adapter for Host Application Configuration 對話方塊所匯出的 XML。 選取要匯入的檔案。 匯入程式不會覆寫現有的對應。
匯入 RE 定義
使用此方法匯入 TI 管理員匯出的 RE 定義。 選取對應時，按一下 [ 匯入對應] 或 [RU] 圖示。 選取[匯入 RU]，或從 [檔案] 功能表中選取 [匯入 RU]。 然後，您可以流覽 TI 管理員所匯出的 XML。 隨即會顯示對話方塊，其中列出您可以選取的 RE 定義。 只會顯示與所選對應具有相同程式模型的 RE 定義。
匯出對應
若要將對應匯出至 XML 檔案，請按一下 [匯出對應至 XML圖示]，或從 [檔案] 功能表選取 [匯出對應]。 然後，您可以流覽至可儲存檔案的位置。 您可以使用匯入 對應 功能匯入此檔案。
元件屬性
您可以檢視元件的相關屬性，以及這個元件所支援的輸入/輸出檔的 XML 標記名稱。 方法名稱是標記名稱的一部分，但在尋找對應時不會使用它。 所有屬性都是唯讀的。 選取對應，然後按一下元件屬性圖示，或從功能表中選取 [顯示元件屬性 ]。
從舊版主機整合伺服器升級
本節說明如何移轉現有的 B，應用程式以使用連接字串：
如果預設 RE 是用於 B，請使用 TI 管理員匯出組態，然後使用 [ 連接字串 ] 對話方塊匯入組態。
如果使用非預設 RE，請將部署物件與 TI 管理員中的新 RE 產生關聯，並在 TI 管理員中匯出組態。 使用 [ 連接字串] 對話方塊匯入組態。
您無法在 BizTalk Server 管理中切換 RU，而不要使用連接字串，因為已移除 [主機類型] 對話方塊。
不支援透過 BizTalk Server 管理重新覆寫。 雖然您可以使用訊息內容來達成 RE 覆寫，但不建議這麼做。 建議您使用連接字串。
如果指定了非預設 SSO 應用程式，您可以使用 TI 管理員將 RE 與非預設 SSO 應用程式產生關聯，並繼續使用靜態 RE。 或者，您可以在連接字串中指定。
匯入 TI 管理員匯出的 XML
除非您執行移轉，否則不需要 TI 管理員。 您可以將 RU 和 WIP 物件的定義匯出至 XML 檔案，此檔案可由 [連接字串 ] 對話方塊匯入。
警告
用於對應的 TI .NET 元件必須將 Include CoNtext Parameter 屬性設定為 True，否則 TI 方法呼叫會在執行時間失敗。
BizTalk Adapter for Host Application Configuration 會使用 Host Integration Server 2009 中引進的動態 RE 功能。 使用動態 RE 時，只要已知主機連線資訊，就可以在叫用 方法之前指定 TI 執行時間所需的主機資訊。 在叫用 .NET 用戶端元件之前，不需要在 TI Manager 中部署並與預先定義的 RE 相關聯。
對於 B，連線資訊可以內建在剖析並設定為在執行時間建立的 RE 物件連接字串。 設定主應用程式配接器的埠時，可以指定 RE 的相關資訊。 它會儲存為 BizTalk 系統管理設施所管理之埠組態資訊的一部分。 使用此方法時，使用 BTY 將 .NET 應用程式與主應用程式整合，您只需要使用 TI Designer來建立 TI .NET 用戶端元件。 所有其他工作都可以在 BizTalk Server中完成。
下表描述工具列功能表和動作。
| 工具列/功能表 | 動作 |
|---|---|
| 新增元件以建立連接字串 | 從 GAC 新增 TI .NET 元件，或使用本機檔案路徑將元件新增至對應。 所有資料行都會填入從元件反映的預設值。 如果未輸入某些必要值，則預設連接字串將無法使用。 |
| 刪除連接字串 | 刪除選取的對應。 隨即會顯示對話方塊以確認刪除。 |
| 編輯連接字串 | 選取對應時，編輯對應連接字串部分啟動[連接字串] 對話方塊，以編輯連接字串。 |
| 將對應匯出至 XML | 匯出允許備份對應。 稍後可以使用匯入對應功能來匯入對應。 匯入/匯出功能可讓您輕鬆共用端點之間的對應。 |
| 匯入對應或 RU | 用來匯 入 BizTalk Adapter for Host Application Configuration 對話方塊匯出的 XML。 也用來匯入 TI 管理員在選取對應時匯出的 RE 定義。 |
| 檢視 TI .NET 元件的屬性 | 顯示元件的相關屬性，以及此元件支援的輸入/輸出檔的 XML 標記名稱。 方法名稱是標記名稱的一部分，但在尋找對應時不會使用。 所有屬性都是唯讀的。 |