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

上海证券交易所 单向卫星通讯接收和数据处理线程接口 技术手册 1.0 2001-4-5- 1 -单向卫星通讯接收和数据处理线程接口技术手册项目负责人： 编 写： 武剑锋 朱立 庹军民审 核： 庹军民批 准：客 户 确 认：上海证券交易所 单向卫星通讯接收和数据处理线程接口 技术手册 1.0 2001-4-5- 2 -正文目录1 引言 ........................................................................................................................31.1 目的 ................................................................................................................31.2 参考资料 ........................................................................................................31.3 定义 ................................................................................................................32 用途 ........................................................................................................................43 运行环境 ................................................................................................................53.1 硬件设备 ........................................................................................................53.2 支持软件 ........................................................................................................53.3 数据说明 ........................................................................................................53.3.1 配置文件 dxwx.cfg.................................................................................53.3.2 报文 ........................................................................................................83.3.3 行情、文件、短消息 任务起始报文控制信息 ..................................83.3.4 成交回报数据传送任务报文 ..............................................................103.3.5 通讯数据报文 ......................................................................................104 使用规程 ..............................................................................................................124.1 安装 ..............................................................................................................124.2 运行 ..............................................................................................................124.2.1 单向卫星通讯接收和数据处理主程序 ..............................................124.2.2 数据处理示范程序 BaseLibDemo.exe...............................................145 用户开发数据处理程序说明 ..............................................................................155.1 应用程序编程接口说明 ..............................................................................155.2 应用程序编程示范文件说明 ......................................................................166 出错处理和恢复 ..................................................................................................19表目录表 1 报文格式 .......................................................................................................8表 2 文件类报文起始控制信息格式 ..................................................................8表 3 成交回报数据格式 ....................................................................................10表 4 单向卫星通讯数据报文结构 ....................................................................11图目录图 1 数据传递过程示意图 ...................................................................................4图 2 接收端的数据格式变换 ...............................................................................5上海证券交易所 单向卫星通讯接收和数据处理线程接口 技术手册 1.0 2001-4-5- 3 -引言1.1 目的本用户手册的读者是各个会员单位的系统程序员。

本用户手册的主要目的是为了指导会员单位接收和处理上海证券交易所通过单向卫星发送的数据1.2 参考资料 《单向卫星数据接收和处理线程接口源代码》 庹军民、朱立 内部资料 《Dx2000.dll 使用指南》 庹军民、 朱立 《单向卫星客户端接收软件用户使用手册》 朱立1.3 定义 数据传送任务：指从上海证券交易所向会员单位发送数据的一次完整过程包括行情、成交回报、文件、短消息传送任务每个任务都被赋予一个唯一的任务号 A 格式通讯数据报文：指单向卫星通讯系统的 PC 接收机以太网卡接收到的基于 UDP 协议的数据报文  B 格式业务数据报文：指单向卫星通讯系统传输的业务数据报文 列如行情数据 ，成交数据 ，文件数据，消息数据  报文：每个数据传送任务在传输中，按照固定大小的数据包的方式来组织这些数据包被称为报文 任务起始报文、任务中间报文、任务结束报文：数据传送任务中待传送数据的长度不等，而报文的最大长度是固定的，如果一个任务中的数据不能在一个报文中一次传送完毕，一个任务会被分为一系列的报文其中第 1个报文就是任务起始报文，最后一个报文就是任务结束报文，而中间的所有报文都被称为任务中间报文。

 通讯接收线程：指运行在会员单位计算机上的从单向卫星中取数据的线程 环形报文队列：在计算机上开辟一块共享内存，这块内存按照环形队列的方式组织它们作为报文的缓冲空间，用来匹配单向发送/通讯接收/ 数据处理的速度 数据处理线程：指运行在会员单位计算机上的从环形报文队列中取报文的线程，它在取到报文后，经过一定的处理过程，按照文件的方式写入本地计算机的硬盘 多点传送方式：上海证券交易所向多个会员单位同时广播发送，具体采用UDP 协议的 MULTICAST 方式来完成 单点传送方式：上海证券交易所向特定会员单位单一发送，具体采用 UDP协议的 UNICAST 方式来完成 行情数据 HQ：指交易所向会员单位发送的有关股票交易的最新价格、成交上海证券交易所 单向卫星通讯接收和数据处理线程接口 技术手册 1.0 2001-4-5- 4 -量等这些数据通过多点传送方式发送 成交回报数据 CJ：指交易所向会员单位发送的专有的成交纪录这些数据通过单点传送方式发送 文件数据 FILE：指交易所向会员单位发送的文件这些文件既有通过多点发送的，也有通过单点发送的 短消息数据 MSG：指交易所向会员单位发送的短消息。

这些文件既有通过多点发送的，也有通过单点发送的 SatelliteReceiver.exe：上海证券交易所提供的单向卫星通讯接收和数据处理主程序 BaseLibDemo.exe: 上海证券交易所提供的数据处理示范程序，会员单位可以此为参考，实现自己特定的专有的数据处理程序2 用途本接口的功能有两个独立的部分构成一个部分是通讯接收部分，它从单向卫星上把数据取下来，然后放到内存中的环形报文队列中去；另外一个部分是数据处理部分，它从这个环形报文队列中把报文数据取出，经过特定的合并转化等操作，写出到文件中去上海证券交易所提供的单向卫星通讯接收和数据处理主程序SatelliteReceiver.exe 在一个程序内实现了这两个部分为支持会员单位更加紧密地结合他们的信息系统，SatelliteReceiver.exe 中的第二部分数据处理部分可以被禁止，由会员单位独立开发自己的专有的数据处理部分并替换如图 1 所示，用户可以禁止 SatelliteReceiver 的数据处理线程，而启动BaseLibDemo 的数据处理线程Sateli dsh Sateli从 卫 星 上得 到 的 原始 数 据 通 讯 接 收 线 程写 环 形 报 文 队 列 SateliRecivr数 据 处 理 线 程 读BaseLibDmo数 据 处 理 线 程 读 写入磁盘或显示上海证券交易所 单向卫星通讯接收和数据处理线程接口 技术手册 1.0 2001-4-5- 5 -图 1 数据传递过程示意图单向卫星通讯和业务数据在小站接收端的数。