201111_SSCC-FDEP消息传输客户端升级技术指引.docVIP

201111_SSCC-FDEP消息传输客户端升级技术指引 目 录 1 引言 1 2 升级步骤 2 2.1 接入客户端FDAP的升级 2 2.2 应用编程接口FDEAPI的升级 4 3 升级中需要注意的问题 5 4 测试环境 5 5 主要改进 5 6 联系电话 6 引言 SSCC-FDEP消息传输中枢已于2011年9月升级，为了提升整个系统运行的性能、安全性、健壮性、稳定性，并彻底解决旧版中的遗留问题，建议用户尽快将自己使用的接入客户端FDAP和应用编程接口FDEAPI升级到最新版本。 FDAP和FDEAPI的最新版本号都是02.05SSCC-FDEP消息传输系统客户端软件官方下载地址： 登陆/，到“下载专区”-“金融数据交换平台”-“SSCC-FDEP消息传输系统相关下载” 升级步骤 接入客户端FDAP的升级 从我司网站下载接入客户端软件压缩包FDAP_win_32bit.rar，并检查MD5校验码，核对软件包是否被篡改。如果被篡改，请与深证通联系； 停止原来的bsmr.exe进程； 使用下载包中的bsmr.exe文件，替换原有系统中的同名文件； 使用下载包中的cert/sscc.cer文件，替换原有系统中的同名文件； 打开原有系统中bsmr.ini文件，并根据自己的app与业务类型对应关系添加入以下内容： [BIZTYPE] //业务类型，该行不能修改 app1=0 //app1对应业务类型为三方存管 app2=10 //app2对应业务类型为银期转账 app3=11 //app3对应业务类型为基金直销 以上BIZTYPE中的内容，需要根据实际情况进行修改。左侧修改为用户自己的AppID，右侧修改为该AppID对应的业务类型。目前支持的业务类型包括三方存管（0）、银期转账（10）、银基转账（11）、资金划拨（12）、信证报盘（13）、电子对账（14）、融资融券（15）、基金盘后（16）。如果不存在用户的业务类型，请与深证通运维热线联系。 打开原有系统中的bsmr.ini文件，如下图所示： 本次升级新增功能涉及参数如下： 1、OnceRecvMsgCount参数用于指定API每调用一次MrReceive函数时，MR向此次请求返回的数据包个数，配置该参数可提高API请求处理效率。 A、如果不配置该选项，则默认按原来方式处理，即对于API的每次MrReceive请求，MR只返回1个数据包； B、如果配置“OnceRecvMsgCount”=“1”，处理方式跟A情况一样； C、如果用户配置该选项，建议设置成“OnceRecvMsgCount”=“500”； 2、OncePushPkgCount用于当API端的一条长连接注册了下推条件后，MR每秒向该连接下推数据包个数，该选项只有在API实现时调用MrRegRecvCondition后才有效（API中是否调用了MrRegRecvCondition请咨询开发商），如果启用该选项，建议配置值为500； （7）检查BSMR的启动方式，如果使用命令行方式启动DOS窗口，请检查启动参数中是否带-x，建议启动时不带-x参数；同时检查DOS窗口在运行过程中是否正常显示在桌面上，建议BSMR启动后将窗口最小化到任务栏里运行。 （8）如果使用命令行方式启动DOS窗口运行BSMR，请在“开始”-“运行”中输入cmd，检查DOS窗口是否启用快速编辑模式，如果选择了该选项，请将该选项去除。如下图所示： 点击确点后，选择“保存属性，供以后具有相同标题的窗口使用”； （9）重启bsmr.exe进程，并检查系统是否能正常工作。如果不能正常工作，请与深证通运维热线联系。 应用编程接口FDEAPI的升级 从深证通公司网站下载自己对应操作系统的FDEAPI软件开发接口压缩包（例如Windows包为FDEAPI_win_32bit.rar，其它操作系统请下载对应的文件），并检查MD5校验码，核对软件包是否被篡改。如果被篡改，请与深证通联系。如果没有用户对应的操作系统的API，也请与深证通联系； 根据不同的情况，用户的应用有可能需要或者不需要重新编译（新版本的API与旧版本在API的接口格式上是兼容的，并增加了新的接口）； 如果用户的应用装载动态链接库的方式是动态的(例如Windows下使用LoadLibrary装载)，则用户不需要重新编译程序； 如果用户的应用装载动态链接库的方式是静态的（或者某些操作系统上只提供了静态库），则用户需要使用新下载的mrapi库文件替换旧版本的同名文件，并重新编译调用mrapi的用户程序； 使用压缩包中的库文件（mrapi.dll、或mrapi.a、或mrapi.so等），替换原有的库