为主机应用程序配置 BizTalk 适配器
用户可以通过“主机应用程序 BizTalk 适配器配置”对话框定义和管理与远程 IBM CICS、IMS 或 iSeries 系统的连接。 用户单击“连接字符串”属性值字段时，该对话框会启动。 可以通过“主机应用程序 BizTalk 适配器配置”对话框添加 TI .NET 程序集。 可以在映射过程中使用它导入、导出和删除映射，编辑连接字符串以及查看 TI .NET 程序集的属性。
“主机应用程序配置”对话框的组件包括工具栏、菜单、数据网格和结果窗格。 本主题通过以下部分介绍了可在其中执行的各种任务。
从旧版 Host Integration Server 升级
工具栏和菜单命令
可以通过工具栏和上下文相关菜单访问用于创建和管理连接字符串的命令。 在数据网格中的任意位置右键单击，即可启动上下文相关菜单。 例如，右键单击连接字符串，即可查看、编辑、删除、导入和导出映射。 双击连接字符串，可以让此连接字符串进入编辑模式。 按 DELETE 键可删除当前选定的项，按 F1 键可打开连接帮助。
以下列表说明了用户可以执行的操作：
从全局程序集缓存 (GAC) 添加 TI .NET 程序集，也可以通过本地文件路径将程序集添加到映射中。 列将填充程序集所反射的默认值。 如果用户未输入所需的值，默认连接字符串将无法使用。
删除选定的映射。 用户将看到一个用于确认删除的对话框。
在选择某个映射后，编辑映射的连接字符串部分。 启动“连接字符串”对话框，以编辑连接字符串。
可通过“将映射导出到 XML”备份映射。 以后可以使用“导入映射”功能还原这些映射。 借助导入/导出功能，可以在各个终结点之间共享映射。
通过“导入映射或 RE”，可以导入“主机应用程序 BizTalk 适配器配置”对话框导出的 XML。 在选择某个映射后，也可以导入通过 TI 管理器导出的 RE 定义。
“查看 TI .NET 程序集的属性”可显示程序集的属性。 XML 标记会显示此程序集支持的输入/输出文档的名称。 方法名称是标记名称的一部分，但它不可用于查找映射。 所有属性为只读属性。
“映射数据网格”窗口
“映射数据网格”对话框包含以下项：
状态（完整或不完整）。 如果连接字符串缺少连接信息，用户将看到一个警告，其中显示一个带有白色感叹号的红色圆圈。 用户添加缺少的信息后，此警告会消失。
作为映射一部分使用的 TI 程序集的 ClassName 和接口名称。
程序集名称。 如果程序集是从 GAC 加载的，则为程序集的强名称；如果程序集是本地程序集，则为程序集的完整路径。 用户添加程序集时，此字段将自动填充，并且它是只读字段。
“远程环境”可定义连接字符串。 它表示从主机应用程序 BizTalk 适配器接收请求的远程系统的特性。 此连接字符串由远程环境类型、编程模型、远程主机标识、网络传输和用于与远程主机通信的其他设置组成。
远程终结点 DNS 名称或远程 IBM 主机的 IP 地址。
结果窗格显示当前所选映射的连接字符串值。
创建和管理映射
此部分介绍了用户可以执行的任务。
添加程序集以创建连接字符串
在工具栏上，单击“文件夹”图标，然后选择“从 GAC 添加程序集”或“添加本地程序集” 。 “从 GAC 添加程序集”将启动一个对话框，其中会列出可在 GAC 中选择的所有程序集。 如果选择“添加本地程序集”，则可以浏览本地安装的程序集。
此外，用户还可以通过菜单中的“添加 GAC”或“添加本地程序集”选项来添加程序集 。
删除连接字符串
选择要删除的单个映射或多个映射。 单击工具栏上的 [X] 图标，可以删除选定的映射。 用户将看到一个对话框，并可在其中确认删除。
也可以通过菜单中的“删除映射”选项来删除映射。
编辑连接字符串
连接字符串用于水化 RE 实例。 用户指定程序集时，它会填充默认值。 双击选定的映射，选择“编辑”，或选择“编辑连接字符串”菜单，可启动“连接字符串”对话框。 这样便可以编辑指定 RE 的连接字符串。 如果用户未输入所需的值，将会看到错误标记。
RE 对象会验证至少需要提供的属性值。 如果用户未设置所需的属性值，系统会标记相应的连接字符串单元。 本主题的“连接字符串设置和映射”部分中列出了所需的属性。 RE 验证的范围有限，而不适当的值可能导致 TI 运行时错误。
此对话框会通过网格显示可编辑的属性和不可编辑的属性。 底部的只读文本框显示基于在属性网格上输入的值创建的连接字符串。 系统根据 RE 对象定义的公共方法和该对象本身定义的值收集属性。 用户可通过提供的某些类型转换器和属性编辑器编辑属性值。
“远程环境”可显示连接到主机所需的属性。 这些属性通过属性网格显示，并带有星号 (*) 标识。 如果用户丢失了一个或多个属性，数据网格中将显示一个带有白色感叹号的红色圆圈。 此警告将告诉用户，可以在运行时通过重写来提供缺少的属性。
安全设置由预定义的安全枚举控制，用户可以使用 OR 运算符组合这些枚举，从而生成新的安全设置。
“关”标记专门用于“客户端”、“包”和“用户”。 如果用户选中上述其他三个选项中的任意一个，则将清除“关”选项。 选中“关”时，将全部清除上述其他三个选项。
SSOApplication 编辑器是从旧版本中移植的，它有一些细微的变化。 用户可以直接在属性网格中指定关联应用程序，也可以使用编辑器选取已经创建的应用程序。
连接字符串设置和映射
下表列出的支持的属性用于定义主机环境和编程模型。 星号表示必需的属性。
默认值由 RE 对象本身设置，它们还会执行有限的验证。
SNA 用户数据
| 属性 | 值 |
|---|---|
| 属性 | 值 |
| CodePage | 37 |
| 区域设置 | 2052 |
| **LocalLUName* | |
| **ModeName* | PA62TKNU |
| 名称 | SNAUserData。 只读。 |
| **RemoteLUName* | |
| 安全性 | 关 |
| SSOApplication | |
| SynLevel2Supported | 错误 |
| TimeOut | 0 |
*必填字段。
SNA 链接
| 属性 | 值 |
|---|---|
| 属性 | 值 |
| AdministrationFlags | 0 |
| CodePage | 37 |
| 区域设置 | 2052 |
| **LocalLUName* | |
| MirrorTranId | CSMI |
| **ModeName* | PA62TKNU |
| 名称 | SNALink。 只读。 |
| **RemoteLUName* | |
| 安全性 | 关 |
| SSOApplication | |
| SyncLevel2Supported | 错误 |
| TimeOut | 0 |
*必填字段。
HTTP 用户数据
| 属性 | 值 |
|---|---|
| 属性 | 值 |
| AliasTransactionId | |
| AllowRedirects | 错误 |
| CodePage | 37 |
| **HttpPort* | |
| **IPAddress* | |
| 区域设置 | 2052 |
| 名称 | HttpUserData。 只读。 |
| 安全性 | 关 |
| SSOApplication | |
| TimeOut | 0 |
| UserAgent | |
| UseSsl | 错误 |
*必填字段。
HTTP 链接
| 属性 | 值 |
|---|---|
| 属性 | 值 |
| AliasTransactionId | |
| AllowRedirects | 错误 |
| CodePage | 37 |
| Converter | |
| **HttpPort* | |
| **IPAddress* | |
| 区域设置 | 2052 |
| MirrorProgramName | |
| 名称 | HttpLink。 只读。 |
| 安全性 | 关 |
| SSOApplication | |
| TimeOut | 0 |
| UseConverter | 错误 |
| UserAgent | |
| UseSsl | 错误 |
*必填字段。
IMS LU6.2
| 属性 | 值 |
|---|---|
| 属性 | 值 |
| CodePage | 37 |
| 区域设置 | 2052 |
| **LocalLUName* | |
| **ModeName* | PA62TKNU |
| 名称 | IMSLU62。 只读。 |
| **RemoteLUName* | |
| 安全性 | 关 |
| SSOApplication | |
| TimeOut | 0 |
*必填字段。
IMS 连接
| 属性 | 值 |
|---|---|
| 属性 | 值 |
| CodePage | 37 |
| ImsFormatModName | |
| **IPAddress* | |
| ItocExitName | |
| 区域设置 | 2052 |
| 名称 | IMSConnect。 只读。 |
| OtmaSystemId | |
| 安全性 | 关 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*必填字段。
TRM 用户数据/链接
| 属性 | 值 |
|---|---|
| 属性 | 值 |
| CodePage | 37 |
| ConcurrentServerTransactionId | MSCS |
| **IPAddress* | |
| 区域设置 | 2052 |
| 名称 | TRMUserData。 只读。 |
| 安全性 | 关 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*必填字段。
ELM 用户数据/链接
| 属性 | 值 |
|---|---|
| 属性 | 值 |
| CodePage | 37 |
| **IPAddress* | |
| 区域设置 | 2052 |
| 名称 | ELMUserData。 只读。 |
| 安全性 | 关 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*必填字段。
分发程序调用
| 属性 | 值 |
|---|---|
| 属性 | 值 |
| CodePage | 37 |
| **IPAddress* | |
| 区域设置 | 2052 |
| 名称 | DistributedProgramCall。 只读。 |
| 安全性 | 关 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*必填字段。
系统 Z 套接字用户数据/链接
| 属性 | 值 |
|---|---|
| 属性 | 值 |
| CodePage | 37 |
| **IPAddress* | |
| 区域设置 | 2052 |
| 名称 | SystemzSocketsUserData。 只读。 |
| 安全性 | 关 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*必填字段。
系统 I 套接字用户数据
| 属性 | 值 |
|---|---|
| CodePage | 37 |
| **IPAddress* | |
| 区域设置 | 2052 |
| 名称 | SystemSocketUserData。 只读。 |
| 安全性 | 关 |
| SSOApplication | *TCPPorts |
| TimeOut | 0 |
*必填字段。
导入映射
单击“导入映射或 RE”图标，可以导入“主机应用程序适配器配置”导出的映射。 选择“导入映射”，或从“文件”菜单中选择“导入映射” 。 然后可以浏览到“主机应用程序 BizTalk 适配器配置”对话框导出的 XML。 选择要导入的文件。 导入过程不会重写现有映射。
导入 RE 定义
使用此选项导入 TI 管理器导出的 RE 定义。 选择映射后，单击“导入映射或 RE”图标。 选择“导入 RE”，或从“文件”菜单中选择“导入 RE”。 然后可以浏览到 TI 管理器导出的 XML。 用户将看到一个对话框，其中列出了可以选择的 RE 定义。 只有 RE 定义的程序模型与所选映射的程序模型相同时，此对话框才会显示它。
导出映射
单击“将映射导出到 XML”图标，或从“文件”菜单中选择“导出映射”，可以将映射导出到 XML 文件。 然后可以浏览到保存相应文件的位置。 可以使用“导入映射”功能导入此文件。
程序集属性
可以查看程序集的相关属性以及此程序集支持的输入/输出文档的 XML 标记名称。 方法名称是标记名称的一部分，但它不可用于查找映射。 所有属性为只读属性。 选择映射，然后单击“程序集属性”图标，或从菜单中选择“显示程序集属性”。
从旧版 Host Integration Server 升级
本部分介绍如何使用连接字符串迁移现有的 BAHA 应用程序：
如果 BAHA 使用了默认 RE，则使用 TI 管理器导出配置，然后使用“连接字符串”对话框导入配置。
如果它使用的是非默认 RE，则在 TI 管理器中将部署对象与新 RE 关联，并从 TI 管理器导出此配置。 使用“连接字符串”对话框导入此配置。
如果不使用连接字符串，也无法在 BizTalk Server 管理控制台中切换 RE，因为“主机类型”对话框已被删除。
不支持通过 BizTalk Server 管理控制台重写 RE。 可以使用消息上下文来重写 RE，但我们不建议这样做。 建议使用连接字符串。
如果指定了非默认 SSO 应用程序，则可以使用 TI 管理器将 RE 与非默认 SSO 应用程序关联，并继续使用静态 RE。 或者，也可以在连接字符串中指定它。
导入 TI 管理器导出的 XML
只有执行迁移时才需要使用 TI 管理器。 可以将 RE 的定义和 WIP 对象导出到 XML 文件，然后可通过“连接字符串”对话框导入该文件。
警告
映射中使用的 TI .NET 程序集必须将“包括上下文参数”属性设置为 True，否则 TI 方法调用将在运行时失败。
“主机应用程序 BizTalk 适配器配置”利用 Host Integration Server 2009 引入的动态 RE 功能。 使用动态 RE 时，只要主机连接信息已知，就可以在调用方法之前指定 TI 运行时所需的主机信息。 无需在 TI 管理器中部署 .NET 客户端程序集，也无需将它与预定义的 RE 关联，即可调用其方法。
对于 BAHA，连接信息可以内置于连接字符串中，之后系统会分析此连接字符串并将其设置为在运行时创建的 RE 对象。 配置托管主机应用程序适配器的端口时，可以指定有关 RE 的信息。 此信息会存储为由 BizTalk 管理工具管理的端口配置信息的一部分。 通过此方法，使用 BAHA 将 .NET 应用程序与主机应用程序集成，用户只需使用 TI 设计器来创建 TI .NET 客户端程序集。 所有其他任务都可在 BizTalk Server 中完成。
下表介绍了工具栏菜单和操作。
| 工具栏/菜单 | 操作 |
|---|---|
| 添加程序集以创建连接字符串 | 从 GAC 中添加 TI .NET 程序集，或使用本地文件路径将程序集添加到映射。 所有列将填充程序集所反射的默认值。 如果某些所需的值未输入，默认连接字符串将无法使用。 |
| 删除连接字符串 | 删除选定的映射。 用户将看到一个用于确认删除的对话框。 |
| 编辑连接字符串 | 选择映射后，编辑映射的连接字符串部分，启动“连接字符串”对话框，以编辑连接字符串。 |
| 将映射导出到 XML | 通过导出，可以备份映射。 以后可以使用“导入映射”功能导入映射。 通过导入/导出功能，可以在各个终结点之间轻松共享映射。 |
| 导入映射或 RE | 用于导入“主机应用程序 BizTalk 适配器配置”对话框导出的 XML。 在选择某个映射后，也可使用它来导入 TI 管理器导出的 RE 定义。 |
| 查看 TI .NET 程序集的属性 | 显示程序集的相关属性以及此程序集支持的输入/输出文档的 XML 标记名称。 方法名称是标记名称的一部分，但它不可用于查找映射。 所有属性为只读属性。 |