本人在用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 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

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