演练:创建使用 MQSeries 适配器的 BizTalk 应用程序

本部分介绍如何创建使用 MQSeries 适配器的简单 Microsoft BizTalk Server 应用程序。

注意

该应用程序假定您已在安装 BizTalk Server 的计算机上安装了 IBM WebSphere MQ(面向 Windows 平台的服务器组件)。 并假定您尚未创建任何发送端口或接收位置。 如果已存在发送端口或接收位置,请在执行以下步骤时替换相应的名称。

该应用程序是一个简单的基于内容的路由应用程序,仅使用一个接收位置和一个发送端口。 接收位置从 IBM WebSphere MQ 队列读取消息。 发送端口从接收位置获取消息,然后将其发送到其他 IBM WebSphere MQ 队列。

若要创建该应用程序,必须创建 IBM WebSphere MQ 队列,设置 BizTalk Server 接收位置和发送端口,启动发送端口并启用接收位置,并在队列中放入测试消息。

如果您具有安装 IBM WebSphere MQ 所需的权限,可以通过适配器对话框创建 IBM WebSphere MQ 队列,并可以跳过下一过程。 如果您没有这样的访问权限,可以使用 IBM WebSphere MQ Explorer(IBM WebSphere MQ 浏览器,面向 Windows 平台的客户端组件)来创建队列。 若要通过 IBM WebSphere MQ Explorer(IBM WebSphere MQ 浏览器)管理单元创建队列,请执行以下步骤。

通过 IBM WebSphere MQ Explorer(IBM WebSphere MQ 浏览器)创建 IBM WebSphere MQ 队列

按照以下步骤,通过 IBM WebSphere MQ Explorer(IBM WebSphere MQ 浏览器)创建 IBM WebSphere MQ 队列:

  1. 单击“ 开始”,指向 “程序”,指向“ IBM WebSphere MQ”,然后单击“ WebSphere MQ 资源管理器”。

  2. 双击“ 队列管理器”,然后双击默认队列管理器。 默认队列管理器通常名为 QM_<machine_name> 其中 machine_name 是计算机的名称。

  3. 右键单击“ 队列”,指向“ 新建”,然后单击“ 本地队列”。

  4. 在“ 创建本地队列 ”对话框的“ 队列名称”中,键入 BTStoMQS,然后单击“ 确定”。

  5. 右键单击“ 队列”,指向“ 新建”,然后单击“ 本地队列”。

  6. 在“ 创建本地队列 ”对话框的“ 队列名称”中,键入 “MQStoBTS”,然后单击“ 确定”。

    以下步骤将创建接收位置和发送端口,然后启动该发送端口并启用该接收位置。 还将创建 IBM WebSphere MQ 队列。

创建接收位置和 MQSeries 队列

按照以下步骤创建接收位置和 MQSeries 队列:

  1. 在BizTalk Server管理控制台中,依次展开“BizTalk Server管理”、“BizTalk 组”、“应用程序”,然后展开默认应用程序 (BizTalk 应用程序 1) 。

  2. 右键单击“ 接收端口” 节点,单击“ 新建”,然后选择“ 单向端口”。

  3. 在“ 接收端口属性 ”对话框的“ 名称 ”框中,键入 “MQStoBTS”。

  4. 在左窗格中,单击“ 接收位置”,在右窗格中单击“ 新建”。

  5. 在“ 接收位置属性 ”对话框的“ 名称 ”框中,键入 “MQStoBTS”。

  6. 从“类型”选项旁边的下拉列表中选择“MQSeries”。

  7. 在“ 传输 ”部分中,单击“ 配置”。

  8. 在“ MQSeries 传输属性 ”对话框的“ 轮询间隔 ”框中,键入 1

  9. 在“ 队列定义 ”框中,单击省略号 (...) 按钮。

  10. 在“ 队列定义 ”对话框的“ 服务器名称 ”框中,键入计算机名称。

  11. 在“ 队列管理器 ”框中,选择默认队列管理器。

  12. 在“ 队列 ”框中,键入 “MQStoBTS”,然后单击“ 导出”。

  13. 在“ 导出 ”对话框中,单击“ 创建队列”,然后再次单击“ 确定 ”和“ 确定” 以返回到“ 接收位置属性 ”对话框。

  14. 在“ 接收处理程序 ”框中,选择“ BizTalkServerApplication”。

  15. 在“ 接收管道 ”框中,选择“ PassThruReceive”。

  16. 单击“确定”以应用更改。

创建发送端口和 MQSeries 队列

按照以下步骤创建发送端口和 MQSeries 队列:

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

  2. 在“ 发送端口属性 ”对话框的“ 名称 ”框中,键入 BTStoMQS。

  3. 从“类型”选项旁边的下拉列表中选择“MQSeries”。

  4. 在“ 传输 ”部分中,单击“ 配置”。

  5. 在“ MQSeries 传输属性 ”对话框的“ 队列定义 ”框中,单击省略号 (...) 按钮。

  6. 在“ 队列定义 ”对话框的“ 服务器名称 ”框中,键入计算机名称。

  7. 在“ 队列管理器 ”框中,选择默认队列管理器。

  8. 在“ 队列 ”框中,键入 BTStoMQS,然后单击“ 导出”。

  9. 在“ 导出 ”对话框中,单击“ 创建队列”,然后再次单击“ 确定 ”和“ 确定” 以返回到“ 发送端口属性 ”对话框。

  10. 在“ 发送管道 ”框中,选择“ PassThruTransmit”。

  11. 单击以在左窗格中选择“ 筛选器 ”,然后在右窗格中配置筛选器选项。

  12. “属性 ”下拉列表中,选择“ BTS”。ReceivePortName

  13. 在“ ”框中,键入 “MQStoBTS”。

  14. 单击“确定”以应用更改。

启用接收位置并启动发送端口

请遵循以下步骤来启用接收位置和启动发送端口:

  1. 右键单击 MQStoBTS 接收位置,然后单击“ 启用”。

  2. 右键单击 BTStoMQS 发送端口,然后单击“ 启动”。

    下一步将通过向接收队列发送测试消息来测试应用程序。

测试应用程序

按照以下步骤来测试应用程序:

  1. 单击“ 开始”,指向 “程序”,指向“ IBM WebSphere MQ”,然后单击“ WebSphere MQ 资源管理器”。

  2. 右键单击“ MQStoBTS”,然后单击“ 放置测试消息”。

  3. 在“ 消息数据 ”框中,键入测试消息。 单击 “确定”

    输入数据后,MQStoBTS 队列的当前深度为 1 (1) 。 应用程序处理消息时,计数将返回到零 (0 ) ,BTStoMQS的当前深度变为 1 (1) 。 您还可以查看消息的内容。

查看消息

请遵循以下步骤查看消息:

  1. 双击 BTStoMQS 队列。

  2. 双击该消息,然后选择“ 数据表 ”。 可以在“ 消息数据 ”框中查看消息的文本。

  3. 单击“确定”。

另请参阅

MQSeries 适配器概述
MQSeries 适配器的体系结构