配置中心以支持 JMS 传输协议

作为 WebSphere Business Integration Connect 安装的一部分,您已安装了 WebSphere MQ。WebSphere MQ 包含了 JMS 实现,您可以用该实现来设置 JMS 通信。

但是,缺省情况下,没有把 WebSphere MQ 配置成支持 JMS。本节提供了配置 JMS 的步骤。

为 JMS 创建目录

首先为 JMS 创建目录。例如,假定您想在 Windows 安装的 c:\temp 目录下创建一个名为 JMS 的目录。以下是您要执行的步骤:

  1. 打开 Windows 资源管理器。
  2. 打开 C:\temp 目录。
  3. 创建名为 JMS 的新文件夹。

修改缺省的 JMS 配置

在这节中,更新 JMSAdmin.config 文件(这是 WebSphere MQ 安装的一部分),以更改上下文工厂和提供程序 URL。

  1. 浏览至 WebSphere MQ 的 Java\bin 目录。例如,在 Windows 安装中,您将浏览至:C:\IBM\MQ\Java\bin
  2. 使用纯文本编辑器(比如“记事本” 或 vi)打开 JMSAdmin.config 文件
  3. 将字符 # 添加到下列行的前面:

    INITIAL_CONTEXT_FACTORY=com.sun.jndi.ldap.LdapCtxFactory
     PROVIDER_URL=ldap://polaris/o=ibm,c=us
     
  4. 除去下列行前面的字符 #:

    #INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory 
     #PROVIDER_URL=file:/C:/JNDI-Directory
     
  5. PROVIDER_URL=file:/C:/JNDI-Directory 这一行进行更改,使与在为 JMS 创建目录中设置的 JMS 目录名相同。例如,如果您设置了 c:/temp/JMS 目录,则这一行将类似于这样:

    PROVIDER_URL=file:/c:/temp/JMS
     
  6. 保存该文件。

创建队列和通道

在本节中,您将使用 WebSphere MQ 来创建收发文档所用的队列,并创建用于此次通信的通道。假定已经创建了队列管理器。 下列步骤中出现的 <queue manager name> 应该用您的实际队列管理器名替代。也可以假定在 TCP 端口 1414 上该队列管理器的侦听器已经启动。

  1. 打开命令提示符。
  2. 输入以下命令以启动 WebSphere MQ 命令服务器:

    strmqcsv <queue manager name>
     
  3. 输入下列命令,以启动 WebSphere MQ 命令环境:

    runmqsc <queue manager name>
     
  4. 输入下列命令以创建用于保存发送到中心的入站文档的 WebSphere MQ 队列:

    def ql(<queue_name>)
     

    例如,要创建名为 JMSIN 的队列,则输入:

    def ql(JMSIN)
     
  5. 输入下列命令以创建用于保存来自中心的文档的 WebSphere MQ 队列:

    def ql(<queue_name>)
     

    例如,要创建名为 JMSOUT 的队列,则输入:

    def ql(JMSOUT)
     
  6. 输入下列命令以创建用于在参与者和中心之间收发文档的 WebSphere MQ 通道:

    def channel(<channel_name>) CHLTYPE(SVRCONN)
     

    例如,要创建名为 java.channel 的通道,则输入:

    def channel(java.channel) CHLTYPE(SVRCONN)
     
  7. 输入下列命令,以退出 WebSphere MQ 命令环境:

    end 
     

将 Java 运行时添加到环境中

输入下列命令,将 Java 运行时添加到系统路径中:

set PATH=%PATH%;<path to installation directory>\_jvm\jre\bin
 

其中 installation directory 指的是安装 WebSphere Business Integration Connect 的目录。

定义 JMS 配置

要定义 JMS 配置,请执行下列步骤:

  1. 转到 WebSphere MQ Java 目录(<path to Websphere MQ installation directory>\java\bin)
  2. 通过输入下列命令来启动 JMSAdmin 应用程序:

    JMSAdmin
     
  3. 通过输入来自 InitCtx>命令提示符中的下列命令来定义新的 JMS 上下文:

    define ctx(jms)
     

    change ctx(jms)
     
  4. 从 InitCtx/jms>命令提示符,输入以下 JMS 配置:

    define qcf(WBICHub)
         tran(CLIENT)
         host(<your_IP_address>) 
         port(1414) 
         chan(java.channel) 
         qmgr(<queue manager name>)
     

    define q(<name>) queue(<queue name>) qmgr(<queue manager name>)
     

    define q(<name>) queue(<queue name>) qmgr(<queue manager name>)
     

    end 
     

下面的 JMSAdmin 对话用于将队列连接工厂定义为 WBICHub,该工厂具有IP 地址 sample.ibm.com,MQ 队列管理器就驻留在该地址(<queue manager name> of sample.queue.manager)。该示例使用创建队列和通道中创建的 JMS 队列名和通道名。请注意,用户输入跟在>命令提示符后面。

InitCtx> define ctx(jms)
 InitCtx> change ctx(jms) 
 InitCtx/jms> define qcf(WBICHub) 
     tran(CLIENT)
     host(sample.ibm.com) 
     port(1414) 
     chan(java.channel) 
     qmgr(sample.queue.manager) 
 InitCtx/jms> define q(inQ) queue(JMSIN) qmgr(sample.queue.manager) 
 InitCtx/jms> define q(outQ) queue(JMSOUT) qmgr(sample.queue.manager) 
 InitCtx/jms>end 
 

Copyright IBM Corp. 1997, 2004