创建 WMQ 侦听器
WMQ 非受控侦听器可配置为侦听其将接受请求的远程 WebSphere MQ 队列(命令队列)。每个正确格式化的侦听器命令都将导致响应发送至定义为其回复队列的 WebSphere MQ 队列。
将命令请求置于指定的 WebSphere MQ 队列上。该命令将指示要执行的动作(例如,将值写入变量)。完成后,将响应传送至已配置的回复队列。
假设
在开始创建侦听器之前,假设:
- IBM WebSphere MQ 版本 5.1 或更高版本的安装和配置适合您的操作环境和局域网。
- WebSphere MQ 管理员已创建队列管理器和关联队列,并为您提供它们的名称。
- WebSphere MQ 管理员已创建通信信道,并为您提供了该信道的名称。
流程
要创建 WMQ 侦听器,请按照以下步骤操作:
- 在工作台左侧窗格中,展开要将侦听器添加到的节点。
- 展开 Enterprise(企业),右键单击 Listeners(侦听器)图标以显示其弹出菜单,然后单击 New(新建)。
随即显示 Listener(侦听器)窗口。 - Name(名称)框使您可以键入侦听器的唯一名称。名称长度最多为 64 个字符,可以包括字母、数字和下划线字符。不允许使用空格。
- 在 Listener Type(侦听器类型)下拉列表中,选择 WMQ。
Parameters(参数)选项卡
更改 Parameters(参数)以适应参数,这些参数的值标识侦听器的名称、信道名称及其他连接设置。预计您将从 WebSphere MQ 管理员那里获取信息,以便正确填写参数值。
下面介绍创建 WMQ 侦听器的参数值。
参数 | 描述 |
---|---|
Host(主机) | 此项为安装 WebSphere MQ 的计算机的主机名或 IP 地址。 |
Port(端口) | 此项为 WebSphere MQ 侦听器将用于侦听的 TCP/IP 端口标识符。 |
User(用户) | 此项为用于访问队列管理器的用户 ID。WebSphere MQ 管理员具有此信息。 |
Password(密码) | 此项为用于访问队列管理器的密码。WebSphere MQ 管理员具有此信息。 |
Manager(管理器) | 此项为队列管理器的名称。WebSphere MQ 管理员已创建此队列管理器并将其命名。此项为节点将连接到的队列管理器。队列管理器名称的示例格式为 ACME.QUEUE.MANAGER。名称必须为大写字母。 |
Command Queue(命令队列) | 此项为命令队列。节点将从此队列中读取请求。 |
Channel(信道) | 此项为信道的名称。WebSphere MQ 管理员已定义此信道并将其命名。 |
Correlation ID(关联 ID) | 可选。关联 ID 值使您可以从队列中获取特定消息。侦听器将仅接受包含关联 ID 值的消息。参见 ** 关联 ID 备注。 |
Controlled Listener(受控侦听器) | 选中此复选框,可使侦听器受获取来自受控侦听器的消息动作的控制。 获取来自受控侦听器的消息动作确定侦听器何时应从远程队列获取下一个请求。Controlled Listener(受控侦听器)复选框与 Delay (seconds)(延迟(秒))参数(下一个)结合使用。有关更多信息,请参见创建受控侦听器和从受控侦听器获取消息动作。 |
Delay (Seconds)(延迟(秒)) | 与 Controlled Listener(受控侦听器)参数(上一个)配合使用。 侦听器接收到来自获取来自受控侦听器的消息动作的请求后,检查远程队列中是否有下一个请求。如果没有可用的请求,则侦听器将等待 Delay (seconds)(延迟(秒))中指定的秒数。如果请求失败,则向获取来自受控侦听器的消息动作返回一个值,指示超时。有关更多信息,请单击创建受控侦听器。 |
Reply(回复) | 选中该复选框以指示回复队列 节点将所有响应加入此队列中。但是,如果企业应用程序指定不同的回复队列,则回复队列将替代此处指定的回复队列。 |
Queue(队列) | 要将回复发送到的队列的名称。 |
Extended Attributes(扩展静态属性) | 使用此按钮可显示 MQMD Header Fields(MQMD 标头字段)选项卡,该选项卡使您可以替代回复消息的某些默认 WebSphere MQ 扩展静态属性。通常,将这些静态属性设置为在 MQ 请求时收到的静态属性。 |
Correlation ID note(关联 ID 备注)
在同一节点或多个节点上配置多个侦听器,并且这些侦听器连接至同一命令队列时,应将侦听器配置为具有唯一的关联 ID。这样可确保每个侦听器都不会意外获取用于共享同一命令队列的另一个侦听器的消息。
企业应用程序需要将 WebSphere MQ 请求放入具有与侦听器配置的关联 ID 匹配的关联 ID 的命令队列。
单击 Reply Extended Attributes(回复扩展静态属性)按钮时,MQMD Header Fields(MQMD 标头字段)选项卡将变为可用。此选项卡使您可以替代回复消息的某些默认 WebSphere MQ 扩展静态属性。
测试并保存 WMQ 侦听器
Listener(侦听器)窗口还具有 Save(保存)、Validate(验证)和 Cancel(取消)按钮。
- 要测试连接,请单击 Validate(验证)。
为测试 WMQ 侦听器,节点必须能够连接至专为该侦听器创建的远程 WebSphere MQ 命令队列和回复队列。
- 如果没有收到错误消息,请单击 Save(保存)。新侦听器将保存到该节点,并添加至 Listener(侦听器)选项卡中。
验证侦听器指示该侦听器是否有错。可以保存包含错误的侦听器。以后,可以编辑侦听器以更正错误。