定义侦听器端

    我们的应用示例代码需要定义侦听器端口来监听队列 / 主题目标， 并驱动消息 Bean（MDB）接受消息。

    首先，我们需要登录到 WAS 管理控制台，展开 Servers > Application servers， 选择 server1。然后在 Communications 栏目下展开 Messaging， 单击 Message Listener Service > Listener Ports 链接进入 Listener Ports 控制面板， 可以新建、删除、启动、停止 Listener Port。如下图所示：

    我们可以点击 New 按钮进入新建页面并设置相应属性。 需要配置的 Listener Ports 的属性如下列表：

    PositionNameConnection factory JNDI nameDestination JNDI nameMaximum retriesHQBCP.HQ1.MR.LSRBCP.HQ1.QCFBCP.MR2HQ.Q5HQBCP.HQ2.MR.LSRBCP.HQ2.QCFBCP.MR2HQ.Q5CPBCP.WLSub.LSRBCP.WLSub.TCFBCP.WL.T5

    这里需要特别说明的是 Maximum retries 属性。 该属性指定了侦听器向 MDB 尝试分发一个消息的最大次数。 该属性的缺省值是 0，表示当第一次出现消息无法分发时，侦听器端口将被关闭。 因此，我们需要配置 MQ 的 Backout threshold 属性， 使得有害消息在导致侦听器停止工作之前由 MQ 转发到专门的错误队列中。 在应用实例中，我们需要在 MQ Explorer 中分别对队列 BCP.MR2HQ.Q、 以及 WMQ 默认的订阅队列（SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE 和 SYSTEM.JMS.ND.CC.SUBSCRIBER.QUEUE）进行配置。 设置 Backout threshold 属性值设置为 3，并设置相应的 Backout requeue queue 属性值为某个用于存放有害消息的本地队列（如图 3.3）。

    有关有害消息的处理的详细介绍，请参阅参考资料： 《WebSphere Application Server 处理有害消息的方法》。