服务端TongLINKQ8.0系统开发手册_JMS编程参考

TongTech®TongLINK/Q8.0系统开发手册-JMS编程参考2011年1月TongLINK/QV8.0系统开发手册_JMS编程参考北京东方通科技股份有限公司地址：北京市海淀区彩和坊路10号1+1大厦2、3层客户服务热线：400-650-7088Email：版权声明版权©1993-2011东方通科技版权所有。版权保护说明未经东方通科技公司书面许可，本文档不得整体或部分地复印、复制、翻译或缩减成任何电子介质或计算机可以阅读的格式。本文档中的信息可能不加通知进行修改。商标©1993-2011东方通科技版权所有。TongTech、TongLINK/Q、TongEASY、TongWeb、TongIntegrator、TongSEC、TongWorkflow、TongGTP、MBP是东方通科技的注册商标。其他所有的公司和产品名称可能为第三方所有。前言本手册主要介绍TongLINK/QJMS应用体系结构、JAVA目录说明、使用TLQJMS程序的步骤、TLQJMS程序配置说明、TLQJMS环境设置、编写TLQJMS程序、编写发布订阅应用、JMS消息、JMS中的加密&压缩、JMS的接口、使用基于TLQJMS的MDB及常见问题等进行说明。通过阅读此手册能快速了解JMS相关应用编写及用法等。1.阅读对象本手册面向消息中间件TongLINKQ8.0产品用户以及对消息中间件感兴趣的读者。2.手册约定本手册遵循以下约定：z手册中所有的队列控制单元简称为QCU。z手册中所有的消息中间件TongLINK/Q8.0简称为TLQ。zTLQ缺省安装路径TongLINK/Q-Root。z此手册适用于UNIX&Windows。z下面相关技术文档中的蓝色字体，表示当前阅读文档。3.相关技术文档z《TongLINKQ8.0快速使用手册》主要介绍产品简介、基本概念、产品安装、发送节点和接收节点的配置、节点启动停止、程序流程、程序运行及错误号的跟踪与查找等。z《TongLINKQ8.0系统安装手册_服务端安装》主要介绍系统安装的环境、系统安装过程、系统有关环境变量配置、系统的启动、License相关说明、系统的停止及系统日志说明等。z《TongLINKQ8.0系统安装手册_管理控制台安装》主要介绍TLQ管理控制台安装的环境、安装过程、有关环境变量设置、TLQ控制台服务器的启动及TLQ管理控制台的登录等。z《TongLINKQ8.0系统概述》主要介绍消息中间件产品的系统功能及特点、系统结构架构、基本概念、队列控制单元、消息管理、发布订阅、集群、网络传输、SSL安全传输、安全出口、事务、事件管理、应用程序管理、系统管理、目录管理等。z《TongLINKQ8.0系统开发手册_程序设计指南》主要介绍有关应用程序设计概述、消息介绍、技术及队列准备、消息描述及消息操作选项设计、消息体数据用户自定义属性设计、连接上下文参数设计、应用程序编写、消息操作相关程序编译、配置文件的编辑约束、配置相关数据结构、配置文件动/静态配置、配置文件相关编程和编译、使用Java进行配置文件的编辑等。z《TongLINKQ8.0系统开发手册_安全出口编写指南》主要介绍安全出口概述、配置、编写及编程模式等。z《TongLINKQ8.0系统开发手册_C编程参考》主要介绍C接口有关的应用编写中用到的相关宏、数据结构及函数定义等。z《TongLINKQ8.0系统管理手册_管理控制台》主要介绍管理控制台使用说明、用户管理、组管理及节点管理等。z《TongLINKQ8.0系统管理手册_配置管理》主要介绍有关系统运行、参数配置、参数配置项约束、参数配置举例、系统日志等。z《TongLINKQ8.0系统管理手册_系统工具》主要介绍系统监视工具tlqstat、系统对象控制工具、错误信息查看工具、资源占用计算工具tlqdispshm、IPC资源查询工具tlqipc、检查系统是否启动工具tlqready、配置文件转换工具tlqconvert及设置SSL的p12证书密码工具tlqcertpwd等。z《TongLINKQ8.0客户端使用手册》主要介绍客户端的基本概念、客户端UNIX和Windows的安装、系统目录结构、参数配置、代理操作、通讯安全及系统日志等。z《TongLINKQ8.0系统常见问题排除手册》主要介绍系统启动常见问题、应用程序的常见问题及管理控制台的常见问题等。z《TongLINKQ8.0系统性能调优手册》主要介绍服务端系统性能调优和客户端性能调优等方面说明。z《TongLINKQ8.0系统开发手册_JMS编程参考》主要介绍TongLINK/QJMS应用体系结构、JAVA目录说明、使用TLQJMS程序的步骤、TLQJMS程序配置说明、TLQJMS环境设置、编写TLQJMS程序、编写发布订阅应用、JMS消息、JMS中的加密&压缩、JMS的接口、使用基于TLQJMS的MDB及常见问题等进行说明。z《TongLINKQ8.0系统开发手册_客户端集群编程参考》主要介绍客户端集群简介、客户端集群相关参数配置、C客户端集群接口相关内容及JMS客户端集群接口相关内容等信息。4.友情提示zJMS不支持带Selector的临时队列和临时topic。zc接口和本地JMS支持发布订阅功能，客户端模式的JMS还不支持发布订阅功能。目录第1章 TONGLINK/QJMS应用体系结构..................................................................................................1 1.1 Factory、Destination都来自JNDI服务器.......................................................................................1 1.2 仅Factory来自JNDI服务器............................................................................................................2 1.3 Factory、Destination都不是来自JNDI服务器...............................................................................2 1.4 JMS与TLQ节点的部署关系..........................................................................................................3 第2章 JAVA目录说明...................................................................................................................................4 2.1 Java目录下的目录.............................................................................................................................4 2.2 Java目录下的目录及文件说明.........................................................................................................4 第3章 使用TLQJMS程序的步骤...............................................................................................................5 3.1 使用JMS程序...................................................................................................................................5 3.1.1 Windows...................................................................................................................................5 3.1.2 Unix..........................................................................................................................................5 3.2 在应用服务器中使用JMS程序........................................................................................................5 3.2.1 在Windows环境下.................................................................................................................5 3.2.2 在Unix环境下.........................................................................................................................5 第4章 TLQJMS程序配置说明....................................................................................................................7 4.1 参数配置.............................................................................................................................................7 4.1.1 tong-log.xml配置文件.............................................................................................................7 4.1.1.1 tong-log.xml参数配置文件格式................................................................................7 4.1.1.2 tong-log.xml参数配置说明........................................................................................8 4.1.2 tlqjndi.conf配置文件...............................................................................................................8 4.1.2.1 tlqjndi.conf参