.Net环境下操作IBM WebShpere MQ

简介:

本人在用C#连接UNIX下的Websphere时,总是会有代号2059的错误。但本人在测试环境下,用的是windows安装环境下的Websphere没有错误,百思不得其解,后看到此文,发现要设置一下环境变量,(由于Queue Manager的CCSID使用819,故增加系统的环境变量),后来成功。

转发此文。

.Net环境下操作IBM WebShpere MQ

http://www.cnblogs.com/mshwu/articles/1068198.html

大约在两年前项目使用了IBM MQ,本人积累了部分在.Net环境下操作IBM MQ的经验。现将经验与大家分享。

IBM WebShpere MQ 简单介绍:

具体的详细信息大家可以在IBM的网站和网上有许多的学习资料。

IBM MQ是实现了消息队列的一个中间件,它可以运行在现在所有流行的平台上。在我们的项目中主要使用的是AS400和UNIX平台上。

在IBM MQ中主要分为以下几个对象:

Queue Manager

队列管理器

主要负责管理队列、通道等,类似与Oracle中的Oracle实例的概念,在一台服务器中可以定义多个Queue Manager。

Queue

队列

是存放Message的对象,是我们主要操作的对象。类似与Oracle中的表的概念。

Message

消息

实际放入Queue中的消息,该消息可以存储字符串、Stream等对象。

Channel

通道

是我们的应用以及两个Queue Manager操作的链接对象

Process

过程

Queue的分类:

Local Queue

本地队列

主要存储消息的对象

Remote Queue

远程队列

和另外一个Queue Manager通讯的队列

Mode Queue

模板队列

建立一个队列模板,通过这个模板可以建立与模板相同属性的动态队列。

Dynamic Queue

动态对了(临时队列)

可以在程序中创建和删除的临时队列

Channel类型:

在我们介绍中只使用了类型为SVRCONN的通道。

.Net连接Queue Manager的关键要素:

.Net的程序需要以下几个关键要素才能连接的一个Queue Manager上。

1、 Address & Port

MQ的服务器地址以及要连接的Queue Manager的监听端口,默认端口1414。

2、 Queue Manager Name

要连接的Queue Manager的名字,区分大小写,默认全部大写。

3、 Channel Name

SVRCONN类型的Channel的名字,需要注意的是该Channel的属性MCAUSER必须设置为一个足够权限的系统用户,否则不能连接成功。

4、 CCSID

CCSID是Queue Manager的编码字符集,需要Queue Manager的CCSID与你的.Net操作系统的CCSID互相兼容或者一致才能成功连接。默认情况下UNIX平台的Queue Manager的CCSID为819,而简体中文版的Windows的CCSID为1381。这两个编码字符集是不能兼容的,所以需要调整。

调整有两种方式:

1) 调整Queue Manager的CCSID,调整成与1381兼容的即可,不一定需要调整成1381

2) 在不能调整Queue Manager时需要配置Windows的环境变量,在Windows的环境变量中增加MQCCSID的环境变量,值需要与Queue Manager的CCSID一致或兼容。

在我们介绍的例子中使用环境如下:

Server:Sun OS 5.9

Address

192.168.128.115

Port

1414(默认端口)

Queue Manager Name

SGS.MGR

Channel Name

SGS.CHANNEL

Queue Manager的属性如下(注意红色部分):

Display Queue Manager details.

DESCR( ) DEADQ( )

DEFXMITQ( ) CHADEXIT( )

CLWLEXIT( ) CLWLDATA( )

REPOS( ) REPOSNL( )

COMMANDQ(SYSTEM.ADMIN.COMMAND.QUEUE) QMNAME(SGS.MGR)

CRDATE(2007-04-02) CRTIME(16.24.23)

ALTDATE(2007-04-02) ALTTIME(16.24.23)

QMID(SGS.MGR_2007-04-02_16.24.23) TRIGINT(999999999)

MAXHANDS(256) MAXUMSGS(10000)

AUTHOREV(DISABLED) INHIBTEV(DISABLED)

LOCALEV(DISABLED) REMOTEEV(DISABLED)

PERFMEV(DISABLED) STRSTPEV(ENABLED)

CHAD(DISABLED) CHADEV(DISABLED)

CLWLLEN(100) MAXMSGL(4194304)

CCSID(819) MAXPRTY(9)

CMDLEVEL(510) PLATFORM(UNIX)

SYNCPT DISTL(YES)

Channel的属性如下(注意红色部分):

Display Channel details.

CHANNEL(SGS.CHANNEL) CHLTYPE(SVRCONN)

TRPTYPE(TCP) DESCR( )

SCYEXIT( ) MAXMSGL(4194304)

SCYDATA( ) HBINT(300)

MCAUSER(mqm) ALTDATE(2007-04-02)

ALTTIME(16.30.23)

SENDEXIT( )

RCVEXIT( )

SENDDATA( )

RCVDATA( )

由于Queue Manager的CCSID使用819,故增加系统的环境变量:


环境准备:

1、 安装IBM WebSphere MQ Client for Windows。(MQ客户端)

2、 安装WebSphere MQ classes for Microsoft .NET.msi。(.Net插件)

3、 在你的.Net项目中引用 amqmdnet.dll,该dll在.Net插件安装目录中可以找到。

开始编写代码:

连接Queue Manager

//MQ管理实例 
 
 private MQQueueManager      mqQMgr=null;// MQQueueManager instance 
 
 
 
private void CreateMng() 
 
 
 
 if(this.mqQMgr==null) 
 
 
 
 try 
 
 {     this.log("Create Queue Manager");                       
 
 
 
 //通过MQ管理名创建MQ管理实例 
 
 //判断是远程连接还是本地连接 
 
 if(!this.checkBox1.Checked)  //本地连接 (服务器连接) 
 
 this.mqQMgr = new MQQueueManager(this.tbQMng.Text); 
 
 else //远程连接(客户端连接) 
 
 
 
 string hostname = this.tbConnection.Text; //Server地址 
 
 string channel = this.tbChannel.Text;   //Channel 名 
 
 string qManager = this.tbQMng.Text;   //Queue Manager名 
 
 
 
 //初始化环境变量 
 
 
 
                                          MQEnvironment.Hostname = hostname; 
 
                                          MQEnvironment.Channel = channel; 
 
                                          MQEnvironment.Port = Int32.Parse(this.textBox1.Text); //端口号 
 
 
 
 this.mqQMgr =new MQQueueManager(qManager); 
 
 
 
                                   } 
 
 
 
 this.log("Create Queue Manager Sucess"); 
 
                            } 
 
 catch(MQException ex) 
 
 
 
 this.mqQMgr=null; 
 
 this.log("Create Queue Manager Failed!"+ex.Message+"reason:" + Convert.ToString( ex.Reason,16)); 
 
                            } 
 
                     } 
 
              } 
 

向本地队列(SGS.IN.01)放入消息:

  1private void button1_Click(object sender, System.EventArgs e) 
  2 
  3 
  4 
  5 //定义队列 
  6 
  7                     MQQueue             mqQueue=null; 
  8 
  9 
 10 
 11 this.CreateMng();  //连接Queue Manager 
 12 
 13 
 14 
 15 try 
 16 
 17 
 18 
 19 if(this.mqQMgr==null) 
 20 
 21 return; 
 22 
 23 
 24 
 25 this.log("Create MQQueue"); 
 26 
 27 
 28 
 29 //通过MQ管理创建队列实例 
 30 
 31                            mqQueue=this.mqQMgr.AccessQueue(this.tbQName.Text,MQC.MQOO_OUTPUT | MQC.MQOO_FAIL_IF_QUIESCING | MQC.MQOO_INQUIRE);   
32 
 33//本例中this.tbQName.Text=”SGS.IN.01” 
 34 
 35 
 36 
 37 
 38 
 39 this.log("Create MQQueue Sucess"); 
 40 
 41 
 42 
 43                     } 
 44 
 45 catch(MQException ex) 
 46 
 47 
 48 
 49 
 50 
 51 this.log("Create MQQueue Failed!!"+ex.Message+"reason:" + Convert.ToString( ex.Reason,16)); 
 52 
 53 return; 
 54 
 55                     } 
 56 
 57 
 58 
 59 //要放入队列中的消息 
 60 
 61MQMessage mqMsg =null;  
62 
 63 try 
 64 
 65 
 66 
 67 int count=Int32.Parse(this.tbCount.Text); 
 68 
 69 
 70 
 71 //创建消息操作实例 
 72 
 73                            MQPutMessageOptions mqPutMsgOpts = new MQPutMessageOptions(); 
 74 
 75 
 76 
 77 
 78 
 79 for(int i=0;i<count;i++) 
 80 
 81 
 82 
 83 this.log("Create Message"); 
 84 
 85 //创建消息实例 
 86 
 87                                   mqMsg = new MQMessage(); 
 88 
 89 
 90 
 91                                   System.Xml.XmlDocument doc = new System.Xml.XmlDocument(); 
 92 
 93                                   doc.Load(this.tbMsg.Text); 
 94 
 95 string msg=doc.OuterXml;  //以字符串的形式放入一个XML 
 96 
 97 
 98 
 99                                   mqMsg.WriteString(msg); 
100 
101 //制定消息格式为String 
102 
103                                   mqMsg.Format = MQC.MQFMT_STRING; 
104 
105 
106 
107 this.log("Create Message Sucess. Message:"+msg); 
108 
109 
110 
111 
112 
113 this.log("Begin Put Message"); 
114 
115 //发送消息 
116 
117                                   mqQueue.Put(mqMsg,mqPutMsgOpts); 
118 
119 this.log("Put Message Sucess"); 
120 
121 
122 
123                            } 
124 
125                     } 
126 
127 catch (Exception ex) 
128 
129 
130 
131 this.log(ex.Message); 
132 
133                     } 
134 
135              } 
136

从本地队列(SGS.IN.01)获取消息

  1 private void button2_Click(object sender, System.EventArgs e) 
  2 
  3 
  4 
  5 //定义队列 
  6 
  7                     MQQueue             mqQueue=null; 
  8 
  9 
 10 
 11 this.CreateMng(); 
 12 
 13 
 14 
 15 try 
 16 
 17 
 18 
 19 this.log("Create MQQueue"); 
 20 
 21 //通过MQ管理实例创建队列实例,制定队列操作类型 
 22 
 23                            mqQueue= this.mqQMgr.AccessQueue(this.tbQName.Text,MQC.MQOO_INPUT_AS_Q_DEF+MQC.MQOO_FAIL_IF_QUIESCING); 
 24 
 25 this.log("Create MQQueue Sucess"); 
 26 
 27                     } 
 28 
 29 catch (Exception ex) 
 30 
 31 
 32 
 33 this.log("Create MQQueue Failed!!"+ex.Message); 
 34 
 35 return; 
 36 
 37                     } 
 38 
 39 
 40 
 41 //定义队列消息 
 42 
 43                     MQMessage mqMsg =null; 
 44 
 45 try 
 46 
 47 
 48 
 49 int count=Int32.Parse(this.tbCount.Text); 
 50 
 51 //定义消息操作 
 52 
 53                            MQGetMessageOptions mqGetMsgOpts=null; 
 54 
 55 
 56 
 57 //队列消息操作类型实例化 
 58 
 59                            mqGetMsgOpts = new MQGetMessageOptions(); 
 60 
 61 //设置消息操作超时 
 62 
 63                            mqGetMsgOpts.WaitInterval=15000; 
 64 
 65 
 66 
 67 bool isContinue = true; 
 68 
 69 while(isContinue && count>0) 
 70 
 71 
 72 
 73 //实例化消息 
 74 
 75                                   mqMsg = new MQMessage(); 
 76 
 77 try 
 78 
 79 
 80 
 81 this.log("Begin get message"); 
 82 
 83 //从消息队列得到消息 
 84 
 85                                          mqQueue.Get(mqMsg,mqGetMsgOpts); 
 86 
 87 this.log("Begin get message Success"); 
 88 
 89 
 90 
 91 //比较消息格式 
 92 
 93 if(mqMsg.Format.CompareTo(MQC.MQFMT_STRING) == 0) 
 94 
 95 
 96 
 97 //MQC.MQFMT_RF_HEADER_2 
 98 
 99 this.log("Message:"+mqMsg.ReadString(mqMsg.MessageLength)); 
100 
101                                          } 
102 
103 else //if (mqMsg.Format.CompareTo(MQC.MQFMT_RF_HEADER_2)==0) 
104 
105 
106 
107 this.log("MessageType:"+mqMsg.Format+"\r\n"); 
108 
109 string msg=mqMsg.ReadString(mqMsg.MessageLength); 
110 
111 
112 
113 
114 
115 this.log(msg); 
116 
117                                          } 
118 
119//                                        else 
120 
121//                                        { 
122 
123//                                               this.log("MessageType:"+mqMsg.Format+"\r\n"); 
124 
125//                                               byte[] buffer = new byte[mqMsg.MessageLength]; 
126 
127//                                               buffer=mqMsg.ReadBytes(mqMsg.MessageLength); 
128 
129// 
130 
131//                                               this.log("byteMessage:"+System.Text.Encoding.UTF8.GetString(buffer)); 
132 
133//                                        } 
134 
135                                   } 
136 
137 catch (MQException mqe) 
138 
139 
140 
141 // 判断异常原因,队列中没有消息 
142 
143 if ( mqe.Reason == MQC.MQRC_NO_MSG_AVAILABLE )  
144 
145 
146 
147 this.log("Have no message  "+mqe.Message); 
148 
149                                                 isContinue=false; 
150 
151                                          } 
152 
153 
154 
155 // treat truncated message as a failure for this sample 
156 
157 if ( mqe.Reason == MQC.MQRC_TRUNCATED_MSG_FAILED ) 
158 
159 
160 
161 
162 
163                                                 isContinue=true; 
164 
165                                          } 
166 
167                                   } 
168 
169 
170 
171                                   count--; 
172 
173                            } 
174 
175                     } 
176 
177 catch (Exception ex) 
178 
179 
180 
181 this.log(ex.Message); 
182 
183                     } 
184 
185              } 
186 
187 
188 
189关闭Queue Manager的连接: 
190 
191 private void button3_Click(object sender, System.EventArgs e) 
192 
193 
194 
195 if (this.mqQMgr!=null) 
196 
197 
198 
199 this.mqQMgr.Disconnect(); 
200 
201 this.mqQMgr=null; 
202 
203                     } 
204 
205              } 
206 
207

现介绍这些,以后我会对模板对了和动态队列做一些介绍,希望对大家有所帮助。














本文转自cnn23711151CTO博客,原文链接: http://blog.51cto.com/cnn237111/669047,如需转载请自行联系原作者






相关实践学习
RocketMQ一站式入门使用
从源码编译、部署broker、部署namesrv,使用java客户端首发消息等一站式入门RocketMQ。
消息队列 MNS 入门课程
1、消息队列MNS简介 本节课介绍消息队列的MNS的基础概念 2、消息队列MNS特性 本节课介绍消息队列的MNS的主要特性 3、MNS的最佳实践及场景应用 本节课介绍消息队列的MNS的最佳实践及场景应用案例 4、手把手系列:消息队列MNS实操讲 本节课介绍消息队列的MNS的实际操作演示 5、动手实验:基于MNS,0基础轻松构建 Web Client 本节课带您一起基于MNS,0基础轻松构建 Web Client
相关文章
|
3月前
|
开发框架 前端开发 .NET
七天.NET 8操作SQLite入门到实战 - (1)第七天BootstrapBlazor UI组件库引入
七天.NET 8操作SQLite入门到实战 - (1)第七天BootstrapBlazor UI组件库引入
|
5月前
|
开发框架 算法 .NET
一个简单高效低内存的.NET操作Excel开源框架 - MiniExcel
一个简单高效低内存的.NET操作Excel开源框架 - MiniExcel
|
4月前
|
XML API 数据库
七天.NET 8操作SQLite入门到实战 - 第六天后端班级管理相关接口完善和Swagger自定义配置
七天.NET 8操作SQLite入门到实战 - 第六天后端班级管理相关接口完善和Swagger自定义配置
|
9月前
|
数据库 开发工具
国产化之 .NET Core 操作达梦数据库DM8的两种方式1
国产化之 .NET Core 操作达梦数据库DM8的两种方式1
163 0
|
11天前
|
安全 数据库 数据安全/隐私保护
七天.NET 8操作SQLite入门到实战 - 第五天引入SQLite-net ORM并封装常用方法
七天.NET 8操作SQLite入门到实战 - 第五天引入SQLite-net ORM并封装常用方法
|
11天前
|
开发框架 .NET API
七天.NET 8操作SQLite入门到实战 - 第四天EasySQLite前后端项目框架搭建
七天.NET 8操作SQLite入门到实战 - 第四天EasySQLite前后端项目框架搭建
|
11天前
|
存储 SQL 关系型数据库
七天.NET 8操作SQLite入门到实战 - 第三天SQLite快速入门
七天.NET 8操作SQLite入门到实战 - 第三天SQLite快速入门
|
4月前
|
SQL Shell 数据库
七天.NET 8操作SQLite入门到实战 - 第二天 在 Windows 上配置 SQLite环境
七天.NET 8操作SQLite入门到实战 - 第二天 在 Windows 上配置 SQLite环境
|
5月前
|
缓存 开发框架 算法
.NET操作Excel高效低内存的开源框架 - MiniExcel
.NET操作Excel高效低内存的开源框架 - MiniExcel
53 0
.NET操作Excel高效低内存的开源框架 - MiniExcel
|
5月前
|
开发框架 前端开发 JavaScript
一个.Net简单、易用的配置文件操作库
一个.Net简单、易用的配置文件操作库
25 0