如何为 MQSC 适配器配置接收端口和接收位置

使用 BizTalk Server 管理控制台为用于 WebSphere MQ 的 BizTalk 适配器配置接收端口和接收位置。 您必须以 BizTalk Server Administrators 组成员的帐户身份登录。 此外,还必须在单 Sign-On (SSO) 数据库中具有适当的权限。

配置接收端口和接收位置

  1. “程序”中,选择“Microsoft BizTalk Server”,然后选择“BizTalk Server管理”。

  2. 在控制台树中,展开 BizTalk 组,展开 应用程序,然后选择要为其创建接收端口的应用程序。

  3. 右键单击“ 接收端口”,指向“ 新建”,然后单击“ 单向接收端口”。

  4. “接收端口属性” 窗口中,配置端口的属性,然后单击“ 确定”。

  5. 在控制台树中,右键单击“ 接收位置”,指向“ 新建”,然后单击“ 单向接收位置”。

  6. “选择接收端口 ”窗口中,单击在上一步中创建的接收端口,然后单击“ 确定”。

  7. “接收位置属性” 窗口中,选择 MQSC 适配器作为传输类型,然后单击“ 配置”。

  8. 在适配器的 “传输属性” 窗口中,配置接收位置的属性 (引用此过程末尾的表) 。

    注意

    配置接收位置需要以下属性:

    通道名称 (这是区分大小写的属性。)

    连接名称

    传输类型

    队列 (这是一个区分大小写的属性。)

    队列管理器 (这是一个区分大小写的属性。)

    如果未指定通道名称属性,则必须提供客户端通道定义文件,使安装在BizTalk Server计算机上的 WebSphere MQ 客户端能够与远程队列管理器通信。 如果将安全套接字层 (SSL) 配置为使用事务消息传递,则还必须提供客户端通道定义文件。 有关详细信息,请参阅 如何配置客户端通道定义文件

  9. 完成属性配置后,单击“ 确定”。

  10. “接收位置属性”窗口的“接收处理程序”列表中,选择将运行接收位置BizTalk Server主机的实例。

    接收处理程序必须在此主机上运行。

  11. “接收管道 ”列表中,选择要用于在此接收位置接收消息的接收管道。

  12. 单击 “确定”

  13. “接收位置” 窗口中,右键单击“ 名称 ”列中的“接收位置”,然后选择“ 启用”。

    接收位置属性

    在“传输属性”窗口的“高级”部分中,可以设置以下属性。

    使用此选项 要执行此操作
    标头的数据偏移量 适配器使用 MQSeries 标头 (MQMD、MQXQH、MQIIH 和 MQCIH 结构) 的值,并在BizTalk Server上下文属性中填充相应的值。 默认情况下,适配器将从消息正文中删除这些 MQSeries 属性。 设置为 “否 ”可保留消息正文中的属性。

    默认值:
    事件日志错误阈值 针对某些错误条件要记录的相同错误的最大数目。 适配器继续运行,如果适配器恢复,它会在应用程序日志中记录事件。

    默认值:10
    命令 设置为“是”以保留消息从 MQSeries 队列接收并提交到 BizTalk Server MessageBox 时的顺序。

    对于发送端,适配器将消息发送到队列,顺序与从消息框接收消息的顺序相同。

    设置为 “否 ”不维护消息顺序。

    对于发送端排序,如果未使用业务流程,则必须在发送端口配置的传输高级选项中启用有序传递。

    对于接收方排序,如果使用业务流程,还必须在业务流程中将接收位置的 “有序传递 ”属性设置为 True

    有序交付可能会降低性能;除非需要订购交货,否则不建议这样做。

    默认值:
    出错时停止 设置为 “是” 以在出现错误时停止处理。 选择此选项将在出现错误时结束事务并禁用接收位置。

    默认值:
    挂起且不可恢复 设置为 “是 ”,可在出现错误时将消息移动到挂起的队列,并指示该消息是否可恢复。

    如果出现错误,启用此值不会保留有序传递,但允许接收位置继续接收消息。

    默认值:
    支持事务 如果设置为“是”,则 MQSC 适配器与BizTalk Server计算机上的 WebSphere MQ 扩展事务客户端 (扩展客户端) 协同工作,以防止消息丢失并保证消息的一次性传递。

    设置为 “否”时,可能会复制消息。 在这种情况下,适配器使用非事务性 WebSphere MQ 客户端 (基客户端) 与 MQSeries 集成。

    默认值:
    等待间隔 执行 MQGet 以从 MQSeries 队列检索消息时,可以设置等待间隔的 MQGMO 选项。 如果队列中没有消息,适配器将等待指定的时间 (秒) ,然后关闭客户端请求。 消息到达队列后,适配器就会开始检索消息。

    默认值:3

    在传输属性窗口的“通道定义”部分中,可以设置以下属性。

    使用此选项 要执行此操作
    通道名称 客户端与之通信的 MQSeries 服务器计算机上定义的通道的名称。 这必须是“服务器连接”通道类型。

    请注意,这是一个区分大小写的属性。
    连接名称 包含队列管理器和 MQSC 适配器从中接收消息的队列的 MQSeries 服务器的名称。

    对于 TCP 传输类型,要指定的格式为 SERVERNAME (PORT) 。 端口号等效于与队列管理器关联的侦听器中定义的端口号。

    还可以将服务器名称指定为 IP 地址。

    对于 LU6.2,请指定在主机集成服务器中配置的 LU 名称或 LU 池名称。
    心跳 检查以验证客户端/服务器连接是否正常工作的秒数。

    默认值:300
    密码 尝试使用远程 MCA 启动安全 LU 6.2 会话时 MCA 可以使用的密码。

    此可选属性的初始值为 null。
    SSL 密码规范 为适配器中配置的终结点将使用的 SSL 连接定义单个 CipherSpec。 WebSphere MQ SSL 通道定义的两端都必须包含 属性,此处指定的值应与通道服务器端指定的名称匹配。 该值是最大长度为 32 个字符的字符串。

    仅当为 MQSeries 客户端与远程队列管理器之间的通信配置 SSL 时,才是必需的。
    SSL 对等名称 用于从 WebSphere MQ 通道另一端的对等队列管理器或客户端检查证书的可分辨名称 (也称为 DN) 。 如果从对等方接收的可分辨名称与此值不匹配,则通道不会启动。

    仅当为 MQSeries 客户端和队列管理器之间的通信配置了 SSL 时才需要。
    传输类型 支持 TCP 和 LU6.2。

    默认值:TCP
    用户 ID MQSeries MCA 用于授权访问 MQSeries 资源的 MCA 用户标识符。

    初始值为 null。 这是一个可选属性。 当此属性为空时,MCA 会使用其默认用户标识符。

    在传输属性窗口的 MQSeries 部分中,可以设置以下属性。

    使用此选项 要执行此操作
    字符集 从 MQSeries 队列接收消息时,消息应转换为的字符集。 如果此属性设置为 None 以外的值,则适配器在执行 MQGet 时设置 MQGMO CONVERT 选项。

    :不转换。

    UCS-2 和 UTF-16:转换为这些字符集。 MQSeries 不区分这两个字符集。

    UTF-8:转换为 UTF-8 字符集。

    默认值:无
    允许分段 设置 MQSeries 以组合分段消息或按原样获取消息。 使用“无操作”将从 MQSeries 队列读取消息但不进行分段。 如果使用“完整消息”,则 MQSeries 在将消息传递到适配器前会组装已分段的消息。

    默认值: 无操作

    在传输属性窗口的“性能”部分中,可以设置以下属性。

    使用此选项 要执行此操作
    最大批大小 一批消息的最大大小(以 KB 为单位)。

    此属性和 Batch 中的最大消息数 协同工作,因此限制是适配器首先达到的值。

    默认值:100
    批中最大消息数 一批中消息的最大数量从 1 到 10,000。

    此属性和 最大批大小 协同工作,因此限制是适配器首先达到的值。

    默认值:10
    线程 每个接收位置使用的线程数。

    默认值:2

    在传输属性窗口的“队列定义”部分中,可以设置下表中列出的属性。

    使用此选项 要执行此操作
    队列 适配器将从中接收 (MQGet) 消息的 MQSeries 队列。

    支持传输队列、本地队列、别名队列。

    请注意,这是一个区分大小写的属性。
    队列管理器 MQSeries 队列管理器的名称,其中包含适配器将从中检索消息的队列。

    支持群集队列管理器。

    请注意,这是一个区分大小写的属性。
  14. 单击“确定”。

另请参阅

用于 WebSphere MQ 的 BizTalk 适配器
如何配置客户端通道定义文件
如何为 MQSC 适配器配置发送端口