.Net环境下操作IBM WebShpere 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）放入消息：
private 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
61
MQMessage 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）获取消息
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
582
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
