上海证券交易所通用报盘软件(EzSTEP) v2019官方版

　　上海证券交易所通用报盘软件(EzSTEP)为上海证券交易所综合业务平台、固定收益平台、期权平台进行委托申报的通用报盘程序，主要功能是进行综合业务平台的实时报盘和公共数据接收。
　　  业务上支持上海证券交易所的多项非撮合业务和创新业务（如跨 境 ETF、大宗交易、转融通、货币式基金等）；协议上支持国内金融交换协议（STEP）的应用层部分（不包括会话层），使之具有良好的业务扩展性和通用性，减少因新业务扩展而带来的报盘软件的频繁升级的风险。

功能介绍
　　1.1通用实时报盘功能
　　EzSTEP 作为通用报盘软件，能实现上海证券交易所综合业务平台、固定收益平台、期权平台的订单申报、响应接收、执行报告（成交回报）接收功能。
　　通过访问市场参与者接口数据库，将市场参与者订单发送给上海证券交易所后台，然后收取交易所后台发来的响应和执行报告（成交）并写回市场参与者接口数据库。
　　1.2 公共数据接收功能
　　EzSTEP 跟 EzOES 的不同，其具有接收交易所后台推送的公共数据功能。EzSTEP 可以配置全局共享公共数据接收表 PubData，当 EzSTEP 的 PBU 启动后，会随机选取一个 PBU 用来接收从交易所后台推送的公共数据信息，并落地到表 PubData。
　　因为该公共数据表为 EzSTEP 上所有 PBU 共享，所以如果某一个 PBU 注销后还存在其他活动的 PBU，并不影响公共数据的接收功能。
　　公共数据表的内容随连接不同的后台环境以及不同业务而变化。
　　公共数据表在数据清理后需重启软件，以确保后续 PubData 表的更新。
　　2 软件特性
　　为进一步提升本所技术服务水平，在报盘接口上，EzSTEP 设计有如下特征。
　　2.1 绿色软件
　　EzSTEP 是一款纯绿色软件，没有安装程序，使用过程中也不会在操作系统目录留下痕迹。
　　只需要下载压缩包并解压到任一指定目录（确保路径中不含空格）后即完成安装。压缩包大小预计不超过 15M。该压缩包包含 SQL SERVER 的 JDBC 驱动。
　　2.2 界面信息监控
　　EzSTEP 主界面为所有 PBU 界面信息一览，通过该界面可观察到 PBU 的如下信息：
　　l 运行状态、CSIP、本地 IP、当前工作、发送委托数量、委托应答数量、成交数量、流速权值、速度、最大委托序号。 l EzSTEP 可以查看交易主机状态、交易时间段。
　　l EzSTEP 可以在界面日志信息窗口查看 PBU 运行日志，并支持分 PBU 查看功能。
　　2.3 配置管理
　　EzSTEP 可以通过修改启动配置项来修改相关配置项：
　　l 登录 PBU 配置(EzSTEPUser.ini)：支持 UI 配置和配置文件配置，包含 CS 链路修改（支持多个 CS 链路）、系统出错控制、柜台系统接口配置
　　配置项 备注
　　1 CS 链路配置：增、删、改、查 支持配置多个 CS 链路及各个链路的超时设置
　　2 系统出错配置 主要是出错重连次数设置
　　3 柜台系统接口配置 对于采用数据接口模式，需要配置数据库驱动程序、数据库 URL、以及接口表名
　　4 密码口令配置 包含 PBU 密码和数据库密码口令
　　l 公共行情配置(EzSTEPUser.ini)：系统需配置接受公共数据 PubData 表的配置，公共数据将写入配置表中。
　　l 外部参考数据库配置(EzSTEPUser.ini)：如有下游 EzTrader 接入必须开启; 否则可以关闭也可以开启。如果开启，一定要在数据库中创建该表。 l 系统参数配置（ezstep.ini）： 包括环境号配置等相关 EzSTEP 系统参数，提供配置文件和 UI 界面 2 种方式。目前 UI 只支持配置后台平台及环境号，其他配置参数属于系统运性能调整的关键参数只能支持配置文件方式而不支持 UI。 l 登录用户名和密码配置：本地可保存用户配置的用户名和密码信息。 l 日志级别配置：Log4J 配置文件，可以配置输出信息级别。
　　2.4 多登录 PBU 支持
　　EzSTEP 支持多个登录 PBU 同时进行场外报盘，最多支持 20 个登录 PBU （技术上不作限制,但不推荐超过上述值）。不同的登录 PBU 可以连接到不同的数据库，也可以使用同一数据库中不同的数据库表。不同的登录 PBU 既可以通过不同的上行链路报单，也可以共享同一个上行链路报单。
　　2.5 异常报警
　　如果某个 PBU 出现网络连接异常、数据库异常、数据库缺口等错误，会通过声音警告等方式进行报警。声音报警将会一直持续，直到人工处置完成后可手工停止报警。
　　2.6 数据库自动重连
　　当报盘机与市场参与者接口数据库连接出现异常中断时，系统会自动尝试重新连接。如果尝试一定次数（由参数配置）依然失败，则 PBU 会注销。
　　2.7 网络自动重连
　　当报盘机与上海证券交易所通信服务器（CS）之间的线路异常时，系统会自动尝试重新连接。如果尝试一定次数（由参数 WanRetry 配置）依然失败，则系统会自动切换到备份线路，
　　而无需人工处理。
　　一旦因为网络原因发生备份链路切换失败，则需要立即人工处置，包括 PBU 的注销和重启操作。
　　2.8 支持实时监控
　　报盘机提供文件接口支持实时监控功能，允许用户通过开发监控工具（EzMonitor）实现对报盘机的实时监控，功能包括查看状态、查看 EzSTEP 错误信息、启动和停止报盘机、启动和停止 PBU 等，为集中监视和控制报盘系统提供了便利。
　　EzSTEP 的监控接口支持 EzOES 的监控接口协议，因此针对 EzOES 开发的外部监控工具可直接用于监控 EzSTEP。
　　2.9 维修通道
　　系统提供菜单，以支持维修通道功能。包括日志级别定制功能和内部变量监控功能。
　　本功能仅供支持/开发人员在遇到故障进行问题分析定位时使用。日常生产时请勿使用。
　　修改日志输出级别功能：从高到低依次为 OFF FATAL ERROR WARN INFO DEBUG TRACE ALL。，默认情况下是 INFO 级别，通过菜单操作，可在遇到故障时动态调整为 DEBUG，既减少平时日志输出，又在故障时输出足够信息以辅助 定位。
　　内部变量监控功能：当维修通道功能启动后，可以定时（可设置）输出当前 EzSTEP 最新的一些内存变量信息至界面监控窗口，同时维修通道可以将内存变量信息随时导出至文件。
　　2.10 强制注销 PBU
　　为防范“僵死状态”导致不能正常登录的风险，EzSTEP 在双向心跳的基础上还提供了自助式强制注销功能的菜单。通过该菜单，在输入正确密码后即可通知后台强制注销，解除“僵死状态”。
　　该功能的启用由交易所后台主机控制，具体是否启用以交易所通知为准。
　　2.11 后台防重单机制
　　交易所后台对重复订单具备防范机制，即对同一个业务 PBU 以相同的 Reff 进行申报（Reff 以 ReqText 字段为准），会被交易主机当作重复订单，不会重复进行处理。
　　2.12 两种类型 PBU
　　登录 PBU l 填写在配置文件（EzSTEPUser.ini）中的 PBU，界面显示的也是该 PBU。 l 登录交易所后台时，需要输入该 PBU 的密码。
　　l 流速控制是在登录 PBU 的层面上进行控制。
　　业务 PBU
　　l 填写在委托申请表中的 pbu 字段和业务数据（ReqText 字段、ExecReportText 字段、
　　MDText 字段）中的 PBU。
　　2.13 单点登录控制
　　平台内单点登录，平台间可重复登录
　　一个 PBU 在各平台之间可以同时登录，并且其流速权是各自独立的。实际上 N 个平台加起来就相当于交易所给所有的 PBU N 倍的流速权。但在每个平台内部，都进行单点登录控制，不允许重复登录。
　　2.14 执行报告数据的缺口重传
　　对于执行报告表的数据，其数据来源于私有广播流，EzSTEP 和 EzOES 不同，其私有广播恢复方式不再是仅仅恢复该广播流尾部丢失的数据，而是能恢复所有私有广播数据。对于中间删
　　除的若干记录情形 EzSTEP 也具备恢复能力。
　　在私有广播进行恢复之前，如果发现该 PBU 所有广播流需要恢复的广播数量超过 10000，
　　则有三种提示：
　　1. 用户选择不传，则只继续接收新的私有广播数据
　　2. 用户选择全传，则边接收新数据边进行恢复（可能新数据处理速度会因此减慢）。
　　3. 用户选择续传，则从私有广播在数据库最大的缺口处进行续传（可能新数据处理速度
　　会因此减慢）。
　　对于公共数据表的数据，如果其内容是通过私有广播流落地的，参照执行报告表的方式进行恢复。若其数据来源是公共广播，则通过后台定时推送全量的方式进行补全，EzSTEP 不做恢复操作。
　　2.15 前后台时钟同步机制
　　时钟同步机制是和 EzOES 完全相同的。
　　EzSTEP 实现了“独立日历”的机制，即应用本身的“日历”可以和计算机设备“日历”相互独立，不再完全依赖于本地设备的时钟。（日志、界面显示等时钟信息除外）其机制是利用通信服务器对外提供的 NTP 服务实现的， EzSTEP 定期和通信服务器进行时钟同步以维护应用“日历”，具体过程可参考标准 NTS 协议。
　　2.16 多上行链路支持和切换
　　和竞价平台类似，EzSTEP 也支持多上行链路切换，并支持通信服务器和链路的组合配置。
　　比如有 2 台通信服务器和 2 条链路，技术上可配置 4 个组合关系： l （通信服务器 1，链路 1） l （通信服务器 2，链路 1） l （通信服务器 1，链路 2） l （通信服务器 2，链路 2）
　　配置时，链路 1 应该是最高带宽的链路。但目前 CS 之间是按照链路类型进行了分区，各CS 分区之间互不连通。因此，如果链路 1 和链路 2 分别是不同类型的链路（比如 SDH 和双向卫星），那么依然只能按照下述方式分配组合：
　　l （通信服务器 1，链路 1） l （通信服务器 2，链路 2）
　　EzSTEP 针对不同的链路设置了不同的链路超时参数 WanTimeout。很明显，对于地面 SDH 2M 的链路和卫星 64K 的链路，其消息接收和发送所需要的时间是不同的，所以不同的链路超时参数是需要的，以避免从地面链路切换到卫星时可能发生的因连接超时而无法切换的情况。
　　2.17 时间表控制
　　EzSTEP 服务于综合业务平台、期权平台、港股通平台。一个平台内的不同业务可能有不同的时间表。有的业务可能 9：15 就开市，有的业务可能 9：30 才开市。但 EzSTEP 只从后台获取一份全局时间表，该时间表是各种业务时间表的并集，并据此控制订单的申报。
　　订单申报到接口数据库后，只要处于全局交易时间之内，则 EzSTEP 会立即向主机申报，但若此时该业务还未开市，则后台主机会对该业务的订单拒单。因此，市场参与者系统需要根据不同业务的可交易时间信息决定是否往接口库中进行订单申报。
　　2.18 订阅其他 PBU 的执行报告信息（暂不启用）
　　为了有效支持总部 PBU 的概念，EzSTEP 设计有某 PBU 订阅其他 PBU 私有广播数据的功能。
　　通过配置文件设置被订阅 PBU，并指定输出到的数据库执行报告表位置后，可完成订阅接收。被订阅 PBU 的私有广播通过登录 PBU 接收。接收处理过程同登录 PBU 的广播，接收到的被订阅 PBU 信息保存在订阅 PBU 数据库表中。
　　被订阅 PBU 的私有广播缺口重传处理流程同登录 PBU，但是通过登录 PBU 向后台发送请求。
　　订阅其他 PBU 的私有广播能辅助实现“热备切换”。假设 PBU A 订阅了 PBU B 的私有广播，则 B 故障后，柜台系统将 B 的订单切换到 A 接口库中即可实现热切换。
　　相关文档参见《软件使用》页的“灾备和恢复”章节 EzSTEP 的热备自动接管方案。
　　该功能的启用由交易所后台主机控制，具体是否启用以交易所通知为准。
更新日志
　　2.0 2019-10-16
　　增加定时任务功能说明，删除暂不启用的功能