websphere mq 相关

java中如何使用MQ

java 中使用websphere websphere mq : 用于传输信息 具有跨平台的功能。1 安装websphere mq 并启动2 websphere mq 建立 queue Manager (如：MQSI_SAMPLE_QM)3 建立queue 类型选择 Local类型 的 （如lq ）3 建立channels 类型选择Server Connection （如BridgeChannel）

package test.mq;
import com.ibm.mq.*;
/* * ?????mq ?java ? */
public class FirstMqTest
{// public static void main(String[] args[])
{// FirstMqTest first = new FirstMqTest();// first.test();// }
public static void main(String args[])
{ FirstMqTest first = new FirstMqTest(); first.test(); }
public void test()
{
String qManager = "MQSI_SAMPLE_QM";
//QueueManager name
String qName = "lq";
//Queue Name try
{ //configure connection parameters
MQEnvironment.hostname="172.16.17.123";
//MQ Server name or IP
MQEnvironment.port=1414;
//listenr port
MQEnvironment.channel="BridgeChannel";
//Server-Connection Channel M
QEnvironment.CCSID =1381;
// Create a connection to the QueueManager
System.out.println("Connecting to queue manager: "+qManager);
MQQueueManager qMgr = new MQQueueManager(qManager);
// Set up the options on the queue we wish to open
int openOptions = MQC.MQOO_INPUT_AS_Q_DEF | MQC.MQOO_OUTPUT;
// Now specify the queue that we wish to open and the open options
System.out.println("Accessing queue: "+qName);
MQQueue queue = qMgr.accessQueue(qName, openOptions);
// Define a simple WebSphere MQ Message ...
MQMessage msg = new MQMessage();
// ... and write some text in UTF8
format msg.writeUTF("Hello, World!");
// Specify the default put message options
MQPutMessageOptions pmo = new MQPutMessageOptions();
// Put the message to the queue
System.out.println("Sending a message...");
/* * ?????? mq ????? * */
for(int j=0;j%26lt;5;j++)
{ String str ="test11111111111";
str = str+j; msg.writeUTF(str);
queue.put(msg, pmo); }
queue.put(msg, pmo);
// Now get the message back again. First define a WebSphere MQ message
// to receive the data
MQMessage rcvMessage = new MQMessage();
// Specify default get message options
MQGetMessageOptions gmo = new MQGetMessageOptions();
// Get the message off the queue.
System.out.println("...and getting the message back again");
queue.get(rcvMessage, gmo);
// And display the message text...
String msgText = rcvMessage.readUTF();
System.out.println("The message is: " + msgText);
// Close the queue
System.out.println("Closing the queue");
queue.close();
// Disconnect from the QueueManager
System.out.println("Disconnecting from the Queue Manager");
qMgr.disconnect();
System.out.println("Done!");
}
catch (MQException ex) {
System.out.println("A WebSphere MQ Error occured : Completion Code " + ex.completionCode + " Reason Code " + ex.reasonCode); }
catch (java.io.IOException ex)
{
System.out.println("An IOException occured whilst writing to the message buffer: " + ex);
}
}

}

MQ通讯协议

MQ使用TCP/IP，SNA，NETBIOS，DECNET等几种网络协议，现在通常使用前两种网络协议，使用后两种协议的人已经不多了。通讯机制从底层向上是这样的：
网络层：MQ服务器运行在指定的IP（如果用TCP/IP协议），LU（SNA协议）或者网络名（NETBIOS，DECNET）上。

数据链路层：主要使用TCP数据包，新的MQ版本也有使用UDP数据包的。或者用SNA协议里的3270数据流。

网络服务层：TCP或UDP数据包被送到预先定义好的MQ网络侦听服务，如默认的TCP/1414端口上，网络侦听服务会根据配置启动相应的通道进程，这些进程不会再协商出动态的新端口，所有连接入这个队列服务器的TCP链接都指向这个指定的端口上，连接的另一端（也就是发起连接的一方）由SOCKET调用得到一个动态的端口。

应用协议层：MQ的消息头与消息体的数据被MQ软件以其特有的方式组织成只有MQ认识的数据格式，如果你一定要问协议的名字，在IBM内部被称为MCP（message channel protocol），但这个名字对用户基本上没有什么意义。新版本的MQ也可以使用HTTPR。

MQ的通讯模式（摘录）

MQ 的通讯模式 1) 点对点通讯：点对点方式是最为传统和常见的通讯方式，它支持一对一、一对多、多对多、多对一等多种配置方式，支持树状、网状等多种拓扑结构。 2) 多点广播：MQ适用于不同类型的应用。其中重要的，也是正在发展中的是"多点广播"应用，即能够将消息发送到多个目标站点(Destination List)。可以使用一条MQ指令将单一消息发送到多个目标站点，并确保为每一站点可靠地提供信息。MQ不仅提供了多点广播的功能，而且还拥有智能消息分发功能，在将一条消息发送到同一系统上的多个用户时，MQ将消息的一个复制版本和该系统上接收者的名单发送到目标MQ系统。目标MQ系统在本地复制这些消息，并将它们发送到名单上的队列，从而尽可能减少网络的传输量。 3) 发布/订阅(Publish/Subscribe)模式：发布/订阅功能使消息的分发可以突破目的队列地理指向的限制，使消息按照特定的主题甚至内容进行分发，用户或应用程序可以根据主题或内容接收到所需要的消息。发布/订阅功能使得发送者和接收者之间的耦合关系变得更为松散，发送者不必关心接收者的目的地址，而接收者也不必关心消息的发送地址，而只是根据消息的主题进行消息的收发。在MQ家族产品中，MQ Event Broker是专门用于使用发布/订阅技术进行数据通讯的产品，它支持基于队列和直接基于TCP/IP两种方式的发布和订阅。 4) 群集(Cluster)：为了简化点对点通讯模式中的系统配置，MQ提供Cluster(群集)的解决方案。群集类似于一个域(Domain)，群集内部的队列管理器之间通讯时，不需要两两之间建立消息通道，而是采用群集(Cluster)通道与其它成员通讯，从而大大简化了系统配置。此外，群集中的队列管理器之间能够自动进行负载均衡，当某一队列管理器出现故障时，其它队列管理器可以接管它的工作，从而大大提高系统的高可靠性。

MQ的资料

一． MQ基本操作 MQ中有几个很重要的组件：队列管理器（QueueManager）、队列（Queue）和通道（Channel）。其基本的操作方法如下：创建队列管理器 crtmqm –q QMgrName -q是指创建缺省的队列管理器 删除队列管理器 dltmqm QmgrName 启动队列管理器 strmqm QmgrName 如果是启动默认的队列管理器，可以不带其名字 停止队列管理器 endmqm QmgrName 受控停止 endmqm –i QmgrName 立即停止 endmqm –p QmgrName 强制停止 显示队列管理器 dspmq –m QmgrName 运行MQSeries命令 runmqsc QmgrName 如果是默认队列管理器，可以不带其名字 往队列中放消息 amqsput QName QmgrName 如果队列是默认队列管理器中的队列，可以不带其队列管理器的名字 从队列中取出消息 amqsget QName QmgrName 如果队列是默认队列管理器中的队列，可以不带其队列管理器的名字 启动通道 runmqchl –c ChlName –m QmgrName 启动侦听 runmqlsr –t TYPE –p PORT –m QMgrName 停止侦听 endmqlsr -m QmgrName MQSeries命令 定义死信队列 DEFINE QLOCAL（QNAME） DEFPSIST（YES） REPLACE 设定队列管理器的死信队列 ALTER QMGR DEADQ（QNAME） 定义本地队列 DEFINE QL（QNAME） REPLACE 定义别名队列 DEFINE QALIAS(QALIASNAME) TARGQ(QNAME) 远程队列定义 DEFINE QREMOTE（QRNAME） + RNAME（AAA） RQMNAME（QMGRNAME） + XMITQ（QTNAME） 定义模型队列 DEFINE QMODEL（QNAME） DEFTYPE（TEMPDYN） 定义本地传输队列 DEFINE QLOCAL(QTNAME) USAGE(XMITQ) DEFPSIST(YES) + INITQ（SYSTEM.CHANNEL.INITQ）+ PROCESS(PROCESSNAME) REPLACE 创建进程定义 DEFINE PROCESS（PRONAME） + DESCR（‘STRING’）+ APPLTYPE（WINDOWSNT）+ APPLICID（’ runmqchl -c SDR_TEST -m QM_ TEST’） 其中APPLTYPE的值可以是：CICS、UNIX、WINDOWS、WINDOWSNT等 创建发送方通道 DEFINE CHANNEL（SDRNAME） CHLTYPE（SDR）+ CONNAME（‘100.100.100.215(1418)’） XMITQ（QTNAME） REPLACE 其中CHLTYPE可以是：SDR、SVR、RCVR、RQSTR、CLNTCONN、SVRCONN、CLUSSDR和CLUSRCVR。创建接收方通道 DEFINE CHANNEL（SDR_ TEST） CHLTYPE（RCVR） REPLACE 创建服务器连接通道 DEFINE CHANNEL（SVRCONNNAME） CHLTYPE（SVRCONN） REPLACE 显示队列的所有属性 DISPLAY QUEUE（QNAME） [ALL] 显示队列的所选属性 DISPLAY QUEUE（QNAME） DESCR GET PUT DISPLAY QUEUE（QNAME）MAXDEPTH CURDEPTH 显示队列管理器的所有属性 DISPLAY QMGR [ALL] 显示进程定义 DISPLAY PROCESS（PRONAME） 更改属性 ALTER QMGR DESCR（‘NEW DESCRIPTION’） ALTER QLOCAL（QNAME） PUT（DISABLED） ALTER QALIAS（QNAME） TARGQ（TARGQNAME） 删除队列 DELETE QLOCAL（QNAME） DELETE QREMOTE（QRNAME） 清除队列中的所有消息 CLEAR QLOCAL（QNAME） 二．配置一个能够通信的远程连接以上讲述了MQ的基本命令操作，但只知道这些是没有实际意义的。MQ的最终目的是实现远程通信，所以下面就以一个具体的例子来说明如何实现远程连接。这个例子的目的是建立可以实现消息传递的一对MQ服务器，它们分别基于NT和UNIX平台。 首先在NT端建一队列管理器 crtmqm –q QM_NT 启动队列管理器 strmqm QM_NT 运行MQ控制台命令 runmqsc QM_NT 创建死信队列 DEFINE QL(NT.DEADQ) DEFPSIST(YES) REPLACE 更改队列管理器属性，设置其死信队列 ALTER QMGR DEADQ（NT.DEADQ）创建进程定义 DEFINE PROCESS（P_NT）+ APPLTYPE（WINDOWSNT）+ APPLICID（’ runmqchl -c SDR_NT -m QM_NT’） 创建本地传输队列 DEFINE QL(QT_NT) USAGE(XMITQ) DEFPSIST(YES) + INITQ（SYSTEM.CHANNEL.INITQ）+ PROCESS(P_NT) REPLACE 创建远程队列定义，对应于UNIX机器上的本地队列Q_UNIX，传输队列为QT_NT DEFINE QREMOTE（QR_NT）+ RNAME（Q_UNIX） RQMNAME（QM_UNIX）+ XMITQ（QT_NT）创建发送方通道，其传输队列为QT_NT，远程主机地址为10.10.10.2，侦听端口为1414 DEFINE CHANNEL（SDR_NT） CHLTYPE（SDR）+ CONNAME（‘10.10.10.2(1414)’） XMITQ（QT_NT） REPLACE 创建服务器连接通道 DEFINE CHANNEL（S_NT） CHLTYPE（SVRCONN） REPLACE 在UNIX端创建队列管理器 crtmqm –q QM_UNIX 启动队列管理器 strmqm QM_UNIX 添加侦听程序 修改/etc/services文件，加入一行： MQSeries 1414/tcp #MQSeries channel listener 修改/etc/inetd.conf文件，加入一行（启动侦听程序） MQSeries stream tcp nowait mqm /usr/lpp/mqm/bin/amqcrsta amqcrsta –m QM_UNIX 运行以下命令，以使修改起作用 refresh –s inetd 运行MQ控制台命令 runmqsc QM_UNIX 创建死信队列 DEFINE QL(UNIX.DEADQ) DEFPSIST(YES) REPLACE 更改队列管理器属性，设置其死信队列 ALTER QMGR DEADQ（UNIX.DEADQ）创建接收方通道，其名字必须与远程发送方相同 DEFINE CHANNEL（SDR_NT） CHLTYPE（RCVR） REPLACE 创建本地队列 DEFINE QL（Q_UNIX） DEFPSIST(YES) REPLACE 创建服务器连接通道 DEFINE CHANNEL（S_UNIX） CHLTYPE（SVRCONN） REPLACE 经过以上操作之后，远程连接的配置工作完成。接下来需要验证配置是否正确。 在NT端启动发送方通道 runmqchl –c SDR_NT –m QM_NT 或 start chl(SDR_NT) 从NT端发送消息到UNIX端 amqsput QR_NT QM_NT 在UNIX端接收消息 /usr/mqm/samp/bin/amqsget Q_UNIX QM_UNIX 若能收到消息，说明配置成功。另，在NT下一般情况下在建立队列管理器时会自动建立侦听器，启动队列管理器时则会自动启动侦听程序。当然也可以手动配置侦听程序。修改winntsystem32driversetcservices文件，在文件中加入一行： MQSeries 1414/tcp #MQSeries channel listener 启动侦听程序 runmqlsr –t tcp –p 1414 –m QM_NT 以上说明了怎样建立简单的单向传输网络。消息从NT端传送到UNIX端。建立从UNIX端到NT端的远程连接和以上相仿，要建立双向的传输网络也是同样的道理。 三．配置JNDI 用JMS实现消息的发送和接收时，经常会用到JNDI。因为JNDI这种方式比较灵活，对于编程也比较简单。在安装了MQSeries Client for Java之后，在javabin目录下找到JMSAdmin.config文件。该文件主要用来说明Context的存储方式及存储地址，对应于文件中的两个参数INITIAL_CONTEXT_FACTORY和PROVIDER_URL。典型的 JMSAdmin.config文件内容如下： #INITIAL_CONTEXT_FACTORY=com.sun.jndi.ldap.LdapCtxFactory INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory #INITIAL_CONTEXT_FACTORY=com.ibm.ejs.ns.jndi.CNInitialContextFactory # #PROVIDER_URL=ldap://polaris/o=ibm,c=us PROVIDER_URL=file:/d:/temp #PROVIDER_URL=iiop://localhost/ # SECURITY_AUTHENTICATION=none INITIAL_CONTEXT_FACTORY表示JMSAdmin Tool使用的服务提供商。当前有三种受支持的值。com.sun.jndi.ldap.LdapCtxFactory用于 LDAP，如果使用它就必须安装一个LDAP服务器。com.sun.jndi.fscontext.RefFSContextFactory用于文件系统上下文，它只需要使用者提供存放上下文的文件路径。com.ibm.ejs.ns.jndi.CNInitialContextFactory是专门为 websphere提供的，它需要和websphere的CosNaming资源库一起使用。 PROVIDER_URL表示会话初始上下文的URL，由JMSAdmin tool实现的所有JNDI操作的根。它和INITIAL_CONTEXT_FACTORY一一对应。 ldap://hostname/contextname 用于LDAP file:[drive:]/pathname 用于文件系统上下文 iiop://hostname[:port]/[?TargetContext=ctx] 用于访问websphere CosNaming名称空间最后还有一个参数SECURITY_AUTHENTICATION，用于说明JNDI是否把安全性凭证传递给了您使用的服务供应商。只有当使用了LDAP 服务供应商时，才使用此参数。此参数有三个值，none（匿名认证）、simple（简单认证）和CRAM-MD5认证机制。如果没有提供有效值，缺省值为none。 确认配置文件之后，可以在javabin目录下启动JMSAdmin控制台。也可以在任何目录下用下面的命令来启动控制台： JMSAdmin –cfg MQ_J***A_INSTALL_PATHjavabinJMSAdmin.config 其中MQ_J***A_INSTALL_PATH为MQSeries Client for Java安装的根目录。若启动失败，则好好检查一下您的环境变量是否设置正确。根据我个人的经验，除了把com.ibm.mq.jar和 com.ibm.mqjms.jar加入到环境变量外，还要把fscontext.jar和providerutil.jar加入到环境变量。进入JMSAdmin控制台后，您可以自由定义sub context。对于子上下文的操作，主要有一下命令： display ctx define ctx(ctxname) change ctx(ctxname) change ctx(=up) change ctx(=init) delete ctx(ctxname) 当然，在这里的主要任务并非是用来定义sub context，而是用来定义以下几个对象： MQQueueConnectionFactory MQTopicConnectionFactory MQQueue MQTopic （还有其它的一些对象，如MQXAQueueConnectionFactory等，不常用到，在此不作说明。）可以使用很多动词来操纵目录名称空间中的受管理对象。ALTER、DEFINE、DISPLAY、DELETE、COPY和MOVE，它们的用法都算比较简单，这里只列举一二以作说明。 例一：定义一QueueConnectionFactory，连接主机10.10.10.18，端口1414 DEFINE QCF(EXAMPLEQCF)+ DESC(Example Queue Connection Factory)+ TRAN(CLIENT)+ HOST(10.10.10.18)+ QMGR(QM_EXAMPLE)+ CHAN(S_EXAMPLE)+ PORT(1414)+ CCSID(1381) 例二：定义一Queue，其对应于MQ中的Q_EXAMPLE DEFINE Q(EXAMPLEQL)+ DESC(Local queue)+ QMGR(QM_EXAMPLE)+ QUEUE(Q_EXAMPLE)+ CCSID(1381) 四．用JMS实现MQ编程 上面我们说明了怎样用JMSAdmin Tool定义MQ对象的上下文。我们的最终目的是要用JMS来实现MQ编程，以实现在程序中对MQ队列进行收、发消息。所以，下面我们将重点讨论一下MQ 的JMS实现。如果您对JMS编程很熟悉，那么您也就会用JMS来实现MQ编程，因为用JMS来编写MQ程序与编写一般的JMS程序没有太大的差别。举个例子，当我们想发送一条消息到MQ的队列中，再从该队列中取回消息时，我们编程时主要有四个步骤。首先我们要初始化在程序中要用到的对象，然后才可以发送消息到队列中去，再就是收取消息了，最后要清除那些永久对象。这些都和普通的JMS程序相当。程序的源代码如下： import java.util.Hashtable; import javax.jms.*; import javax.naming.*; import javax.naming.directory.*; public class sample { protected QueueConnectionFactory factory=null; protected QueueConnection connection; protected QueueSession queueSession; protected TextMessage outMessage; protected QueueSender queueSender; protected QueueReceiver queueReceiver; public static final String qcfLookup="EXAMPLEQCF"; public static final String qLookup="EXAMPLEQL"; public static final String icf = "com.sun.jndi.fscontext.RefFSContextFactory"; public String url ="file:/d:/temp"; public void sampleInit() throws Exception { Hashtable environment = new Hashtable(); environment.put(Context.INITIAL_CONTEXT_FACTORY, icf); environment.put(Context.PROVIDER_URL, url); environment.put(Context.REFERRAL, "throw"); Context ctx=new InitialDirContext(environment); factory = (QueueConnectionFactory)ctx.lookup(qcfLookup); Queue q1=null; q1=(Queue)ctx.lookup(qLookup); connection = factory.createQueueConnection(); queueSession = connection.createQueueSession(false, Session.AUTO_ACKNOWLEDGE); queueSender = queueSession.createSender(q1); queueSender.setDeliveryMode(DeliveryMode.NON_PERSISTENT); outMessage = queueSession.createTextMessage(); queueReceiver = queueSession.createReceiver(q1); connection.start(); } public void sendMessageOut(String message) throws JMSException { outMessage.setText(message); queueSender.send(outMessage); } public String receiveMessage() throws Exception{ return ((TextMessage)queueReceiver.receive()).getText(); } public void sampleClose() throws JMSException { queueSession.close(); connection.close(); } public static void main(String[] args){ String rec; sample sp = new sample(); try { sp.sampleInit(); sp.sendMessageOut("Hello World!"); java.lang.Thread.sleep(4000); rec=sp.receiveMessage(); System.out.println("Receive text is : "+rec); sp.sampleClose(); }catch(Exception e) { e.printStackTrace(); } } } 五．远程管理 MQ在WINDOWS平台下具有图形化管理界面，但在UNIX平台下却只能通过命令行来进行操作。这样就给使用者带来很大的不便。我们都希望能通过图形界面来进行管理配置。为了实现我们的想法，我们就必须建立远程管理。 实现远程管理有以下几个步骤： 1．被管理队列管理器上的命令队列SYSTEM.ADMIN.COMMAND.QUEUE存在并可用。对于MQ 2版本应执行 amqscoma.tst 脚本来创建。 2．使用strmqcsv命令来启动被管理队列管理器上的命令服务器。 3．确定被管理队列管理器上的服务器连接通道SYSTEM.ADMIN.SVRCONN是否存在，如果不存在则创建它。 4．一般Unix、Linux平台中MQ默认的字符集为819，而Windows平台为1381，所以你必须改变其字符集，使两边的字符集相同。一般改被管理的字符集。 5．如果被管理队列管理器上的操作用户与管理队列管理器上的操作用户不同，那么你首先要确认管理队列管理器上的操作用户在被管理队列管理器上存在并且有管理MQ的权限，再者，你需要修改服务器连接通道SYSTEM.ADMIN.SVRCONN的MCAUSER属性为管理队列管理器上的操作用户。 6．启动被管理队列管理器上的侦听器。做完这些工作之后，直接在管理队列管理器的MQ管理工具中显示被管理队列管理器即可。然后你就可以象操作本地队列管理器一样，在被管理队列管理器上定义你需要的MQ对象。 六．通道维护 在配置远程连接的时候，我们曾经创建过进程定义。那我们为什么要去创建进程定义呢？这就涉及MQ通道维护的概念。通道长时间没有消息触发就会自动断开连接，不再保持运行状态。时间的长短可以由自己设定，默认值为6000秒。消息请求再次来临的时候，就必须再次启动通道。有些通道，如服务器连接通道、接收方通道等是自动触发启动的。当消息请求发送到通道后，通道立即启动，进入运行状态。但也有一些通道不会自动启动，最典型的就是发送方通道。当有消息请求需要使用通道进行消息传递的时候，发送方通道也不会自动启动并把消息发送到远程队列，而是把消息留在了与其相关联的传输队列中。但是，在实际应用中我们又不可能每过一段时间去启动一次通道，或当有消息来再去启动通道。那应该怎么办？首先我们创建一个进程定义，这个进程定义的目的就是用来启动发送方通道。然后我们在传输队列的进程名称属性栏指定刚才定义的进程定义名称，再把触发器控制开关打开。这样，当有消息进入传输队列后，传输队列的触发器会启动触发执行指定的进程，从而启动发送方通道，把消息传输到远程队列中去。