创建 JMS 队列

JMS 传输协议使用 JMS 队列来保存在 Business Integration Connect 和后端系统之间传递的消息。就 WebSphere MQ V5.3 而言,创建 JMS 队列包括下面的步骤:

  1. 创建 MQ 队列管理器
  2. 创建 MQ 通道和传输队列
  3. 创建 MQ JMS 本地队列

创建 MQ 队列管理器

如果还没有为 Business Integration Connect 和后端系统定义队列管理器,您必须在创建 MQ JMS 队列之前创建 MQ 队列管理器。 如果您正在做 JMS 集成,则需要队列管理器。 你必须决定是安装新的队列管理器还是使用一个现成的。现有的队列管理器可以是 Business Integration Connect 的队列管理器、后端系统队列管理器或其它现有的队列管理器。参阅 WebSphere MQ 文档获取关于如何创建队列管理器的指示信息。

注:
如果您的后端系统和 Business Integration Connect 驻留在不同的机器,队列管理器可以驻留在任一机器。 Business Integration Connect 和后端系统在访问队列管理器时指定机器的主机名。

本章中的样本假设 WebSphere MQ 队列管理器存在并且具有以下名称:

bcg.queue.manager
 

创建 MQ 通道和传输队列

一旦队列管理器存在,请确保下面的对象已经创建:

要创建 MQ 通道和传输队列,使用 WebSphere MQ 命令环境“runmqsc”,它由 WebSphere MQ 提供。该工具提供命令行界面,您可以输入队列管理命令。

注:
创建这些 MQ 对象的方法依赖于您使用的平台。请参阅 WebSphere MQ 文档以获取关于创建这些对象的指示信息。

要使用 runmqsc 工具来创建您的 MQ 通道和传输队列,请遵循以下步骤:

  1. 打开命令提示符并转至下列目录:
    WebSphereMQ_Root\java\bin
     

    其中 WebSphereMQ_Root 是 WebSphere MQ 的安装目录。

  2. 输入下面命令以启动 WebSphere MQ 命令环境:
    runmqsc queueManager
     

    其中 queueManager 是您的 WebSphere MQ 队列管理器的名称。

    注:
    必须mqm 用户的身份登录以使用 runmqsc 工具。
  3. runmqsc 的命令行,您可以输入下面的命令:
    1. 定义 JMS 传输队列:
      define qlocal(transQueueName) usage(xmitq) put(enabled)
       get(enabled)
       

      其中 transQueueName 是期望的 JMS 传输队列名称。

    2. 定义发送方通道:
      define channel(sndrChannelName) chltype(sdr) xmitq(transQueueName)
       conname('remote m/c ip')
       stop channel(sndrChannelName)
       

      其中 sndrChannelName 是期望的 JMS 发送方通道名称,而 transQueueName 是步骤 3a 中创建的 JMS 传输队列的名称。

    3. 定义接收器通道:
      define channel(rcvrChannelName) chltype(rcvr) xmitq(transQueueName)
       stop channel(rcvrChannelName)
       

      其中 rcvrChannelName 是期望的 JMS 接收器通道名称并且 transQueueName 是您在步骤 3a 中创建的 JMS 传输队列的名称。

  4. 您可以让 WebSphere MQ 命令环境保持打开状态,因为您在后面的队列管理命令中将需要它。

图 30显示创建 bcg.queue.manager 队列管理器托管的样本 JMS 通道和传输队列。

图 30. 创建样本 JMS 通道和传输队列的命令

runmqsc bcg.queue.manager
 
   define qlocal(TRANSQ) usage(xmitq) put(enabled) get(enabled) 
    define channel(SENDER) chltype(sdr) xmitq(TRANSQ) 
       conname('remote m/c ip')
    stop channel(SENDER)
    define channel(RECEIVER) chltype(rcvr)
    stop channel(RECEIVER)
 

图 30 中的命令创建以下 MQ 对象:

创建 MQ JMS 本地队列

要创建 MQ JMS 本地队列,使用 WebSphere MQ 命令环境“runmqsc”。

注:
您必须在 Business Integration Connect 所驻留的机器上创建这些 MQ JMS 队列。

要使用 runmqsc 工具来创建您的本地 MQ 队列,遵循这些步骤:

  1. runmqsc 的命令行,您可以输入下面的命令:
    1. 定义从后端系统接收消息的 JMS 入站队列:
      define qlocal(inQueueName)
       

      其中 inQueueName 是期望的 JMS 入站队列名称。

    2. 定义将消息发送给后端系统的 JMS 出站队列:
      define qlocal(outQueueName)
       

      其中 outQueueName 是期望的 JMS 出站队列名称。

  2. 退出 WebSphere MQ 命令环境:
    end
     

    您可以让命令提示符保持打开状态,因为您在后面的配置步骤中将需要它。

注:
如果您与 Business Integration Connect 的交互仅包括与后端系统通信的一个方向,您可以只创建 Business Integration Connect 支持该方向的队列。

图 31 显示创建 bcg.queue.manager 队列管理器托管的样本 JMS 队列。

图 31. 创建样本 JMS 队列的命令

   define qlocal(JMSIN)
    define qlocal(JMSOUT)
  
 

图 31 中的命令创建了下列 JMS 队列:

Copyright IBM Corp. 1997, 2004