通过

用于 DB2 配置的 BizTalk 适配器 - HIS

  • 项目

概述

Microsoft BizTalk Adapter for DB2 将BizTalk Server连接到在 Linux、UNIX 和 Windows 操作系统上运行的 IBM 大型机 DB2 for z/OS、IBM midrange DB2 for IBM i 和 IBM 服务器 DB2 中存储的重要数据。 该适配器基于适用于 DB2 的 Microsoft ADO.NET 数据提供程序，并支持各种功能，包括跨 SNA 和 TCP/IP 网络连接的分布式事务的发送端口和接收端口。 使用端口配置向导中定义的 SQL 命令，IT 专业人员可以轻松创建可高效集成 DB2 数据库的解决方案，而无需编写代码。

适配器提供两个main函数：

  • 对于单向和请求响应) (发送 操作，适配器将 SQL 命令和存储过程发送到 DB2 实例，并提供请求响应的选项。

  • 对于仅单向) (接收 操作，适配器会创建一个 SQL 命令或存储过程，用于轮询 DB2 对象并创建每行消息，然后将这些消息提交到 BizTalk 消息系统。

    此外，适用于 DB2 的 BizTalk 适配器使用标准 BizTalk 适配器跟踪工具作为故障排除机制。

创建 DB2 发送端口

使用属于 BizTalk Server 管理员组成员的帐户登录。

  1. 在“BizTalk Server管理”中，依次展开“BizTalk 组”、“应用程序”，然后选择应用程序。

  2. 右键单击“ 发送端口”，选择“ 新建”，然后选择“ 静态单向发送端口”。

  3. 在 “发送端口属性”中，将 “传输类型” 设置为 “DB2”。 选择“ 配置”，并输入以下属性：

    使用此选项 要执行此操作
    BulkCopyBatchSize BulkCopyBatchSize 属性指示适配器每个批处理事务要处理的行数。 此 可选 属性接受 整数 值。 默认值为 20。 值为 0 指示适配器在单个批处理中处理所有行。
    CommandTimeout CommandTimeout 属性设置适配器终止尝试执行命令并生成错误的等待时间。 此 可选 属性接受 整数 值。 默认值为 30 秒。 值为 0 表示没有限制， (尝试执行命令将无限期等待) 。
    连接字符串 用于连接到 DB2 数据库的连接字符串的名称。

    若要配置新的或现有的连接字符串，请单击省略号 (...) 。 这会启动数据源向导。

    若要访问“帮助”，请在向导页上单击“ 帮助 ”，或打开 Host Integration Server 帮助并查看 数据源向导 (DB2) 。
    DB2 集寄存器 DB2 Set Registers 属性指示适配器执行一个或多个 SQL SET 语句。 此可选属性接受 字符串 值。 默认值为 空字符串，表示无 语句。 支持的语法是 SET 语句命令的分号分隔列表，其中包含 SET 语句值的逗号分隔列表“<SET 命令 1> 空格 <SET 值 1> 分号; <SET 命令 2> 空格 <SET 值 a> 逗号 <SET 值 b> 分号“) 。 例如，输入“SET CURRENT PATH 'DSN8910'， 'HISDEMO'”。
    文档目标命名空间 发送到 DB2 的 XML 文档中使用的目标命名空间。
    响应根元素名称 从 DB2 接收的 XML 文档中使用的根元素名称。 (对于单向端口，此属性可能为空。)
    URI 统一资源标识符。 用于标识发送端口位置的名称。 默认值为 DB2：//。
    UseBulkCopy UseBulkCopy 属性指示适配器在大容量复制模式下处理发送端口 INSERT 命令以提高性能。 此 可选 属性接受 布尔 值。 默认值是 false秒。

  4. 选择“确定”，保存所做更改。

  5. 对于 “发送处理程序”，选择要运行适配器的主机实例，然后选择“ 发送管道”。

  6. 选择“确定”，保存所做更改。

  7. 在 “发送端口”中，右键单击新的发送端口，选择“ 登记 ”，然后选择“ 开始”。

创建 DB2 接收端口

使用属于 BizTalk Server 管理员组成员的帐户登录。

  1. 在“BizTalk Server管理”中，依次展开“BizTalk 组”、“应用程序”，然后选择应用程序。

  2. 右键单击“ 接收端口”，选择“ 新建”，然后选择“ 单向接收端口”。 配置属性，然后选择“ 确定”。

  3. 右键单击“ 接收位置”，选择“ 新建”，然后选择“ 单向接收位置”。 选择刚创建的接收端口，然后单击“ 确定”。

  4. 在 “接收位置属性”中，将 “传输类型” 设置为 “DB2”。 选择“ 配置”，并输入以下属性：

    使用此选项 要执行此操作
    CommandTimeout CommandTimeout 属性设置适配器终止尝试执行命令并生成错误的等待时间。 此可选属性接受整数值。 默认值为 30 秒。 值为 0 表示没有限制， (尝试执行命令将无限期等待) 。
    连接字符串 输入将用于连接到 DB2 数据库的连接字符串的名称。

    若要配置新的或现有的连接字符串，请单击省略号 (...) 。 这会启动数据源向导。 若要访问“帮助”，请在向导页上单击“ 帮助 ”，或打开 Host Integration Server 帮助并查看 数据源向导 (DB2) 。
    DB2 集寄存器 DB2 Set Registers 属性指示适配器执行一个或多个 SQL SET 语句。 此可选属性接受字符串值。 默认值为空字符串，表示无 语句。 支持的语法是 SET 语句命令的分号分隔列表，其中包含 SET 语句值的逗号分隔列表“<SET 命令 1> 空格 <SET 值 1> 分号; <SET 命令 2> 空格 <SET 值 a> 逗号 <SET 值 b> 分号“) 。 例如，输入“SET CURRENT PATH 'DSN8910'， 'HISDEMO'”。
    文档根元素名称 从 DB2 接收的 XML 文档中使用的根元素名称。
    文档目标命名空间 从 DB2 接收的 XML 文档中使用的目标命名空间。
    SQL 命令 为每个轮询间隔执行一次的 select 或存储过程命令。
    更新命令 在处理接收操作中的每一行之后执行的命令。 它可以是删除 SQL 命令中表中的行的 delete 语句，也可以是静态修改一行或多行的 update 命令。 指定此选项后，SQL 命令必须是 Select 语句，并且必须访问单个表。
    URI 标识接收端口位置的名称。 默认值为 DB2：//。
    轮询间隔 轮询请求之间的单位数。 允许的范围是 1 - 65535。
    轮询度量单位 轮询请求之间) 使用的度量单位 (秒、分钟或小时。 默认值为秒。

  5. 选择“确定”，保存所做更改。

  6. 对于 “接收处理程序”，请选择要运行适配器的主机实例。 接收处理程序必须在此主机上运行。 选择 “接收管道”。 . 选择“确定”，保存所做更改。

  7. 在 “接收位置”中，右键单击接收位置，然后单击 “启用”。

创建 DB2 适配器架构

  1. 打开 BizTalk Visual Studio 项目。

  2. 右键单击项目，选择 “添加”，选择“ 添加生成的项”，然后选择“ 添加”。

  3. 在 “添加生成的项 ”对话框中，选择“ 添加适配器元数据”。

  4. 在“添加适配器向导”的 “选择适配器” 页上，选择“ DB2”。 在“端口”列表中，选择配置的发送端口或接收位置，然后选择“ 下一步”。

  5. 在 DB2 适配器架构生成向导中：

    1. 在“数据库信息”中，创建连接字符串，或选择现有连接字符串。

    2. 在 “架构信息”中，定义要在架构中使用的默认命名空间、根元素和端口类型。

      如果选择“ 接收端口”，则只需要请求文档根元素名称。 如果选择“ 发送端口”，则请求和响应文档根元素名称均是必需的。

    3. 在“ 语句类型信息”中，选择要发出的数据库命令的类型。

      如果在上一页上选择了接收端口，则可以选择 SELECT SQL 语句或存储过程。 如果在上一页上选择了“发送端口”，则可以选择发出 updategram、存储过程或 SELECT 语句。

    4. 在 “语句信息”中，输入有关 DB2 数据库的详细信息。 根据之前输入的信息，可以使用以下属性：

      1. 在“语句 信息”对话框中接收 Select 语句 ，在“SQL 脚本编辑”框中键入 SQL SELECT 语句。 （可选）单击“ 浏览 ”以加载包含 语句的文本文件。

      2. 在“语句信息”对话框中接收存储过程，单击存储过程名称。 在“参数”列表中，单击每个所需参数的“ 值 ”复选框。

      3. 在“语句信息”对话框中发送 Updategram，单击表名称。 在 “参数” 列表中，针对所需的每一列单击“ 值 ”复选框。 使用 BulkCopy 时，必须单击“每个 值 ”复选框以选择所有列。

      4. 在“语句信息”对话框中发送存储过程，单击存储过程名称。 在 “参数” 列表中，单击每个所需参数的“ 值 ”复选框。

      5. 在“语句信息”对话框中发送 Select 语句，在“SQL 脚本编辑”框中键入 SQL SELECT 语句。 （可选）单击“ 浏览 ”以加载包含 语句的文本文件。

  6. 选择“ 完成 ”以完成向导。

你现在有了一个架构。