单向卫星通讯接收和数据处理线程接口技术手册.doc

单向卫星通讯接收和数据处理线程接口 技术手册 项目负责人： 编 写： 武剑锋 朱立 庹军民 审 核： 庹军民 批 准： 客 户 确 认： 正文目录 1 引言 3 1.1 目的 3 1.2 参考资料 3 1.3 定义 3 2 用途 4 3 运行环境 5 3.1 硬件设备 5 3.2 支持软件 5 3.3 数据说明 5 3.3.1 配置文件dxwx.cfg 5 3.3.2 报文 8 3.3.3 行情、文件、短消息 任务起始报文控制信息 8 3.3.4 成交回报数据传送任务报文 10 3.3.5 通讯数据报文 10 4 使用规程 12 4.1 安装 12 4.2 运行 12 4.2.1 单向卫星通讯接收和数据处理主程序 12 4.2.2 数据处理示范程序BaseLibDemo.exe 14 5 用户开发数据处理程序说明 15 5.1 应用程序编程接口说明 15 5.2 应用程序编程示范文件说明 16 6 出错处理和恢复 19 表目录 表 1 报文格式 8 表 2 文件类报文起始控制信息格式 8 表 3 成交回报数据格式 10 表 4 单向卫星通讯数据报文结构 11 图目录 图 1数据传递过程示意图 4 图 2接收端的数据格式变换 5 引言 目的 本用户手册的读者是各个会员单位的系统程序员。本用户手册的主要目的是为了指导会员单位接收和处理上海证券交易所通过单向卫星发送的数据。 参考资料 《单向卫星数据接收和处理线程接口源代码》 庹军民、朱立 内部资料《Dx2000.dll使用指南》 庹军民、 朱立 《单向卫星客户端接收软件用户使用手册》 朱立 定义 数据传送任务：指从上海证券交易所向会员单位发送数据的一次完整过程。包括行情、成交回报、文件、短消息传送任务。每个任务都被赋予一个唯一的任务号。 A格式通讯数据报文：指单向卫星通讯系统的PC接收机以太网卡接收到的基于UDP协议的数据报文 。 B格式业务数据报文：指单向卫星通讯系统传输的业务数据报文 。列如行情数据 ，成交数据 ，文件数据，消息数据 。 报文：每个数据传送任务在传输中，按照固定大小的数据包的方式来组织。这些数据包被称为报文。 任务起始报文、任务中间报文、任务结束报文：数据传送任务中待传送数据的长度不等，而报文的最大长度是固定的，如果一个任务中的数据不能在一个报文中一次传送完毕，一个任务会被分为一系列的报文。其中第1个报文就是任务起始报文，最后一个报文就是任务结束报文，而中间的所有报文都被称为任务中间报文。 通讯接收线程：指运行在会员单位计算机上的从单向卫星中取数据的线程。 环形报文队列：在计算机上开辟一块共享内存，这块内存按照环形队列的方式组织。它们作为报文的缓冲空间，用来匹配单向发送/通讯接收/数据处理的速度。 数据处理线程：指运行在会员单位计算机上的从环形报文队列中取报文的线程，它在取到报文后，经过一定的处理过程，按照文件的方式写入本地计算机的硬盘。 多点传送方式：上海证券交易所向多个会员单位同时广播发送，具体采用UDP协议的MULTICAST方式来完成。 单点传送方式：上海证券交易所向特定会员单位单一发送，具体采用UDP协议的UNICAST方式来完成。 行情数据HQ：指交易所向会员单位发送的有关股票交易的必威体育精装版价格、成交量等。这些数据通过多点传送方式发送。 成交回报数据CJ：指交易所向会员单位发送的专有的成交纪录。这些数据通过单点传送方式发送。 文件数据FILE：指交易所向会员单位发送的文件。这些文件既有通过多点发送的，也有通过单点发送的。 短消息数据MSG：指交易所向会员单位发送的短消息。这些文件既有通过多点发送的，也有通过单点发送的。 SatelliteReceiver.exe：上海证券交易所提供的单向卫星通讯接收和数据处理主程序。 BaseLibDemo.exe: 上海证券交易所提供的数据处理示范程序，会员单位可以此为参考，实现自己特定的专有的数据处理程序。 用途 本接口的功能有两个独立的部分构成。一个部分是通讯接收部分，它从单向卫星上把数据取下来，然后放到内存中的环形报文队列中去；另外一个部分是数据处理部分，它从这个环形报文队列中把报文数据取出，经过特定的合并转化等操作，写出到文件中去。 上海证券交易所提供的单向卫星通讯接收和数据处理主程序SatelliteRece