一、MQI的基本数据类型
| 数据类型 | 说明 |
| MQBYTE | 单字节数据 |
| MQBYTEn | 16，24，32，64字节的字符串 |
| MQCHAR | 单字节字符 |
| MQCHARn | 包含4，8，12，16，20，28，32，48，64，128，256个单字节字符的字符串 |
| MQHCONN | 连接句柄，32 位 |
| MQHOBJ | 对象句柄，32 位 |
| MQLONG | 32 位带符号二进制整数 |
| PMQLONG | 指向MQLONG 类型数据的执政 |
二、MQI API
1、 连接到队列管理器
MQCONN(&QMgrName , &Hconn , &CompCode , &Reason)
MQCONNX(&QMgrName , ConnectOpts , &Hconn , &CompCode , &Reason)
入口参数：
Char[] QMgrName ：队列管理器名，如果为空串，则表示连接到默认队列管理器
ConnectOpts ：控制MQCONNX 行为的选项
出口参数
MQLONG ComCode ：完成码
MQLONG Reason ：原因码
MQHCONN Hconn ：队列管理器的连接句柄
ConnectOpts
2、 打开WebSphere MQ 对象
可以打开的三种WebSphere MQ对象类型有：队列，过程定义，队列管理器
MQOPEN(Hconn,&ObjDesc,Options,&Hobj,&ComCode,&Reason)
入口参数：
MQCONN Hconn ：MQCONN 调用返回的连接句柄
MQOD ObjDesc ：打开对象的描述，它以对象描述结构的形式出现
MQLONG Options ：控制调用行为的一个或多个选项
出口参数：
MQLONG ComCode ：完成码
MQLONG Reason ：原因码
MQHOBJ Hobj ：访问对象的对象句柄
MQOD ObjDesc ：调用后返回的对象描述结构
3、 关闭WebSphere MQ 对象
MQQCLOSE（Hconn，&Hobj，Options，&comCode，&reason）
入口参数：
MQHCONN Hconn ：连接句柄
MQHOBJ Hobj ：被关闭对象地句柄
MQLONG Options：关闭选项(如果关闭的不是永久动态队列的话，为MQCO_NONE)
MQLONG 结果代码:（完成代码CompCode和原因代码reason）
MQHOBJ Hobj （对象句柄，重置为MQHO_UNUSABLE_HOBJ ）
4、 断开与队列管理器的连接
MQDISC(&Hconn,&CompCode,&Reason)
入口参数：
MQHCONN Hconn: 提供到队列管理器的连接句柄
出口参数：
MQLONG 结果代码:（完成代码CompCode和原因代码reason
MQHCONN Hconn( 连接句柄设置为MQHC_UNUSABLE_HCONN)
5、 将消息放入队列
（1 ）、将多个消息放入一个已经打开的队列
MQPUT （Hconn ，&MsgDesc ，PutMsgOpts ，BufferLength ，Buffer ，&CompCode ，&Reason ）
该函数调用前，队列必须先试用MQOO_OUTPUT 选项打开
入口参数：
MQHCONN Hconn ：连接句柄，由MQCONN 调用返回
MQHOBJ Hobj ：队列句柄，由MQOPEN 返回
MQMD MsgDesc ：消息的描述
MQPMO PutMsgOpts ：控制信息，其形式为一个放置消息选项结构
MQLONG BufferLength ：消息所包含数据的长度
char[] Buffer ：消息本身
出口参数：
结果代码：CompCode （完成代码）Reason （原因代码）
MsgDesc：已经根系的消息描述起河选项
（2 ）、将单一消息放入一个队列，而不显式打开队列
如果仅将单一消息PUT 到队列中，我们可以调用MQPUT1 ，不需要MQOPEN 打开队列即可将单个信息放入队列
MQPUT1(Hconn ,&MsgDesc,&PutMsgOpts,BufferLength,Buffer,&CompCode,&Reason)
6、 从队列获取消息
MQGET(Hconn,Hobj,&MsgDesc,&GetMsgOpts,BufferLength,Buffer,&DataLength,&CompCode,&Reason)
为了执行MQGET 调用，必须用MQOO_Input_shared 或MQOO_Input_Exclusive 选项打开队列，才可能使用这个调用。从队列获得消息是物理顺序还是逻辑顺序，取决于MQOPEN 调用和MQGET 调用所采用的选项
此调用的入口参数如下：
MQHCONN Hconn ：连接句柄，由MQCONN 调用返回
MQHOBJ Hobj ：队列句柄，由MQOPEN 调用返回
MQMD MsgDesc ：消息的描述
MQGMO GetMsgOpts ：控制信息，以获取消息选项（MQGMO ）结构的形式
MQLONG BufferLength ：消息所包含数据的长度
Char[] Buffer ：消息本身
出口参数：
结果代码：CompCode ：完成代码。Reason ：原因代码
char[] Buffer ：消息本身
MQMD MsgDesc ：已经更新的消息描述器和选项
MQLONG DataLength ：消息的实际长度
7、 从队列浏览消息
（1 ）、调用MQOPEN 来打开要浏览的队列，选中MQOO_BROWSE(O_options) 选项
（2 ）、调用MQGET ，并选中MQGMO_BROWSE_NEXT （gmp.Options ）选项，以便逐步浏览随后的许多消息，在任何新的MQGET 调用之前将MsgId 和CorrelId 设为空
（3 ）、调用MQCLOSE 关闭队列
8、 查询对象属性
MQINQ(Hconn,Hobj,SelectorCount,Selectors,IntAttrCount,&IntAttrs,CharAttrLength,&CharAttrs,&CompCode,&Reason)
入口参数如下：
MQHCONN Hconn ：连接句柄，由MQCONN 调用返回
MQHOBJ Hobj ：队列句柄，由MQOPEN 调用返回
MQLONG SelectorCount ：选择器数量
MQLONG[] Selectors ：属性选择器数组
MQLONG IntAttrCount ：被查询的整数数量
MQLONG[] IntAttrs ：整型变量数组，调用向其返回指定的整型
MQLONG CharAttrLength ：字符属性缓存区的长度
Char[] CharAttrs ：字符缓存区，调用把被调查字符属性的值放入其中
出口参数如下：
MQLONG[] IntAttrs ：一系列拷贝到数组中的整型值
CHAR[] CharAttrs ：字符属性返回其中的缓存区
结果代码（CompCode ：完成代码，Reason ：原因代码）
就字符属性而言，所得的缓存区由长度固定的属性值一个接一个地填充。如果这些属性中的任何一个实际值小于属性的固定长度，那么其余的空间由空白区填充。如果任何对象（在这种情况下，对象就是队列）请求的属性不适合于该类型的队列，那么空间由星号（* ）填充
9、 设置对象属性
MQSET(Hconn,Hobj,SelectorCount,Selectors,IntAttrCount,IntAttrs,CharAttrLength,CharAttrs,CompCode,Reason)
入口参数如下：
MQHCONN Hconn ：连接句柄，由MQCONN 调用返回
MQHOBJ Hobj ：队列句柄，由MQOPEN 调用返回
MQLONG SelectorCount ：选择器数量
MQLONG[] Selectors ：属性选择器数组
MQLONG IntAttrCount ：被查询的整数数量
MQLONG[] IntAttrs ：整型变量数组，调用向其返回指定的整型
MQLONG CharAttrLength ：字符属性缓存区的长度
Char[] CharAttrs ：字符缓存区，调用把被调查字符属性的值放入其中
出口参数如下：
结果代码（CompCode ：完成代码，Reason ：原因代码）
MQSET （selectors ）可以设定的属性：
InhibitGet（远程队列不适合）
DistList
InhibitPUT
TriggerControl
TriggerType
TriggerDepth；
TriggerMsgPriority
TriggerData
10、 MQI中的事物处理
MQCMIT(Hconn，&CompCode，&Reason)
MQBACK(Hconn,&CompCode,&Reason)
(1) 局部工作单元
在MQPUT和MQGET调用中的PutMessageOpt(PMO)设为Mqpmo_Syncpoint或GetMessageOpt(GMO)设为Mqgmo_SyncPoint代码
不调用MQBEGIN
工作单元中的每个操作都必须设定MQPMO(PutMessageOpt) 或MQGMO(Mqpmo_Syncpoint) 选项
(2) 全局工作单元
调用MQBEGIN(Hconn,BeginOptions,CompCode,Reason) 来启动全局单元
如果局部工作单元已经启动，那么MQBEGIN 调用会失败，返回MQRC_UOW_IN_PROGRESS 原因。
11、 MQI中的消息分组
组中的每个消息都必须有MQMF_MSG_IN_GROUP 标志，但是最后一条消息则应具有MQMF_LAST_MSG_IN_GROUP 标志。组中消息的顺序存储在MQMD 结构的MsgSeqNumber 字段中，它由队列管理器自动生成
md.Version=MQMD_VERSION_2;
md.MsgFlags=MQMF_MSG_IN_GROUP
md.GroupId=MY_GROUP_ID;
md.Encoding=MQENC_NATIVE:
md.CodedCharSetId=MQCCSI_Q_MGR