QuickFIX/N入门:三、 如何配置QuickFIX/N
来源:互联网 发布:韦东山 linux 内核裁剪 编辑:程序博客网 时间:2024/05/03 00:47
Acceptor或者Initiator能够为您维护尽可能多的FIX会话,因而FIX会话标识的唯一性非常重要。在QuickFIX/N中,一个FIX会话的唯一标识是由:BeginString(FIX版本号)、SenderCompID(发送方ID)及TargetCompID(目标方ID)等标识字符组合而成。通常还会加上SessionQualifier来保证会话的唯一性。
每个FIX会话可以有很多与它们相关联的配置信息。在编译的时候,有些配置可能还是未知的,因此可以通过类SessionSettings来设置或加载。 SessionSettings是一个数据字典,可以随意设置和查询配置信息。
SessionSettings有两个带参数构造函数,其中一个是System.IO.TextReader的参数,它能够解析TextReader的配置信息;另外一个构造参数是文件名,把配置文件的文件路径作为参数传入,它可以解析当中的配置信息 。当然,你也可以自己定义组件(例如,一个特定的数据库存储),然后使用SessionSettings存储配置信息(SessionSettings提供了一个Set方法)。
配置文件当中有两个类型的配置节点: [DEFAULT],[SESSION]。[SESSION]定义一个会话。[DEFAULT]节点定义与会话相关,但没在会话当中明确定义的相关配置,比如连接对手方的IP、端口、心跳间隔等。QuickFIX/N并不会为所有必需配置的定义默认值。如果配置有任何一个QuickFIX/N必需的配置项缺失,它将抛出ConfigError异常,提示配置缺少或格式不正确。
1) 会话配置(SESSION)
配置
描述
有效值
默认
BeginString
会话使用的FIX版本号(发送和接收消息起始字符串)
FIXT.1.1
FIX.4.4
FIX.4.3
FIX.4.2
FIX.4.1
FIX.4.0
SenderCompID
会话当中定义本方的ID
区分大小写的字符串
SenderSubID
会话相关的本方的子ID号 (可选)
区分大小写的字符串
SenderLocationID
会话相关的本方的locationID号 (可选)
区分大小写的字符串
TargetCompID
本会话当中的对方ID
区分大小写的字符串
TargetSubID
本会话当中的对方SubID (可选)
区分大小写的字符串
TargetLocationID
本会话当中的对方locationID (可选)
区分大小写的字符串
SessionQualifier
附加的限定词,用于消除歧义,保证会话的唯一性
区分大小写的字符串
DefaultApplVerID
仅FIXT1.1(或以上版本)需要。忽略早期版本的传输。指定会话的默认应用程序的版本ID。ApplVerID的枚举值(请看ApplVerID字段详细介绍),或默认BeginString。
FIX.5.0SP2
-
FIX.5.0SP1
FIX.5.0
FIX.4.4
FIX.4.3
FIX.4.2
FIX.4.1
FIX.4.0
ConnectionType
定义会话当中本方的角色:acceptor或者r initiator
initiator
-
acceptor
StartTime
交易日的会话有效开始时间,这时FIX会话被激活
UTC时间,格式: HH:MM:SS,
-
EndTime
交易日的会话失效时间,FIX会话将被停止
同上
-
StartDay
对于为期一周的会话配置,一周会话开始的第一天。与STARTTIME结合使用。
使用一周中某天的英语任何缩写都是有效的(比如,mo, mon, mond, monda,Monday都是有效的)
-
EndDay
对于为期一周的会话配置,一周会话结束的最后一天。与EndTime结合使用。
同上
-
MillisecondsInTimeStamp
时间戳是否加入毫秒。FIX.4.2和更高版本可用。
Y
Y
N
ResetOnLogon
接收登录请求时,序列号是否要复位。只用于Acceptor
Y
N
N
ResetOnLogout
正常注销登录时,序列号是否要复位
Y
N
N
ResetOnDisconnect
连接异常断开后是否要将序列号重置为1
Y
N
N
RefreshOnLogon
确定是否应当从持久层登录时恢复会话状态。在创建热故障切换会话时有用。
Y
N
N
EnableLastMsgSeqNumProcessed
是否在header中添加最后一条消息的序列号(可选tag369)。
Y
N
N
MaxMessagesInResendRequest
设置一次重发请求的消息的最大消息数。
任何大于0的整数。使用0为无穷大(默认)。
0
SendLogoutBeforeDisconnectFromTimeout
指定是否因超时断开连接之前发送logout消息。
Y
N
N
IgnorePossDupResendRequests
当PossDupFlag(tag 43)设置为true时,是否忽略一次重发请求,
Y
N
N
2) 验证配置
配置
描述
有效值
默认
UseDataDictionary
告诉会话是否使用数据字典,或不希望使用数据字典。 如果你要使用repeating group,你必须使用DataDictionary。
Y
Y
N
DataDictionary
XML定义文件用于验证传入的FIX消息。如果没有提供DataDictionary,只会做基本消息的验证。
有效的XML数据字典文件。QuickFIX/N 配备默认的协议字典数据
-
该配置只用于比FIXT.1.1还老的版本。详细参考FIXT.1.1的TransportDataDictionary和AppDataDictionary的配置。
FIX44.xml
FIX43.xml
FIX42.xml
FIX41.xml
FIX40.xml
TransportDataDictionary
XML定义文件用于验证传入的管理消息。如果没有提供DataDictionary,只会做基本消息的验证。该配置只用于FIXT.1.1(或更高版本)的会话。
有效的XML数据字典文件。QuickFIX/N 配备默认的协议字典数据
-
更多信息请参考(FIX.4.0到 FIX.4.4)的DataDictionary。
FIXT1.1.xml
AppDataDictionary
用于验证应用层消息的XML定义文件。仅对FIXT.1.1(或更高版本)的会话有效。
更多信息请参考(FIX.4.0到 FIX.4.4)的DataDictionary。
该配置可以为每个会话指定一个自定义应用的数据字典。该配置仅用于FIXT.1.1或更新的传输协议。使用FIXT传输时,该配置可以作为指定多个应用的数据字典的前缀。例如:
DefaultApplVerID=FIX.4.2 # For default application version ID AppDataDictionary=FIX42.xml # For nondefault application version ID # Use BeginString suffix for app version AppDataDictionary.FIX.4.4=FIX44.xml
有效的XML数据字典文件。QuickFIX/N 配备默认的协议字典数据
-
FIX50SP2.xml
FIX50SP1.xml
FIX50.xml
FIX44.xml
FIX43.xml
FIX42.xml
FIX41.xml
FIX40.xml
ValidateFieldsOutOfOrder
如果设置为N,字段放置区域错误(例如,body字段在header区域内,或在header字段在body区域内)将不会被拒绝。用于连接字段要求不严格的系统。
Y
Y
N
ValidateFieldsHaveValues
如果设置为N,没有值的字段将不会被拒绝。用于连接到系统不当发送空标签。
Y
Y
N
ValidateUserDefinedFields
如果设置为N,用户自定义的字段将不会被拒绝,即使没有在数据字典中定义,或没出现在消息中。
Y
Y
N
1) Initiator
设置
描述
有效值
默认
ReconnectInterval
尝试重新连接的时间间隔(秒)。仅用于 initiator。
正整数
30
HeartBtInt
心跳间隔(秒)。仅用于initiator。
正整数
-
LogonTimeout
登录超时时间间隔(秒)
正整数
10
LogoutTimeout
注销登录超时时间间隔(秒)。
正整数
2
SocketConnectPort
Socket服务端口,用于建立会话。仅用于 initiator
正整数
-
SocketConnectHost
连接主机.仅用于 initiator
x.x.x.x格式IP地址或域名
-
SocketConnectPort<n>
一组备用Socket端口,用于连接会话的故障转移,n是正整数。SocketConnectPort1,SocketConnectPort2 ... 必须是连续的,并有一个与之相匹配的数组SocketConnectHost<n>
正整数
-
SocketConnectHost<n>
一组备用Socket服务主机,用于连接会话的故障转移,n是正整数。SocketConnectHost1, SocketConnectHost2... 必须是连续的,并有一个与之相匹配的数组SocketConnectPort<n>
x.x.x.x格式IP地址或域名
-
SocketNodelay
连接是否禁用Nagle算法。在[DEFAULT]配置节点定义。
Y
Y
N
注:Nagle算法的目的是避免TCP发送大量的小数据包。TCP在接收到前一个小段的ACK消息之前,一直保存小数据包。然而Nagle算法和TCP的延迟确认策略间的交互会因一段暂时性的“死锁”而使应用程序产生严重的性能下降。
2) acceptor
设置
描述
有效值
默认
SocketAcceptPort
监听接入连接Socket端口。仅用于acceptor
正整数,有效的、开放的套接字端口
-
SocketAcceptHost
监听接入连接的Socket服务的主机。如果不提供,acceptor将监听所有网络端口(0.0.0.0)
有效的x.x.x.x格式IP地址
0.0.0.0
SocketNodelay
连接是否禁用Nagle算法。在[DEFAULT]配置节点定义。
Y
Y
N
3) Storage
设置
描述
有效值
默认
PersistMessages
如果设置为N,被不会保存消息。这样将迫使quickfix总是发送GapFills,而不是重新发送消息。如果你知道你永远不需要重新发送消息,使用此配置。有用的市场数据流。
Y
Y
N
4) File Storage
设置
描述
有效值
默认
FileStorePath
存储序列号和消息的文件目录。
有效的文件存储目录,必须有写入权限。
-
5) Logging
设置
描述
有效值
默认
FileLogPath
存储日志的目录。
有效的文件存储目录,必须有写入权限。
-
6) 配置文件的样例
(1) Initiator 配置文件的样例
只能用一个[DEFAULT]节点,可以有多个[SESSION]节点,多个[SESSION]节点是定义多个会话。
#
定义会话的默认配置(
default节点,对于全部会话有效,当然允许
SESSIION
节点重写)
[DEFAULT]
FileStorePath=store
FileLogPath=log
ConnectionType=initiator
ReconnectInterval=60
SenderCompID=TW
# session
定义
[SESSION]
# FileStorePath,FileLogPath,ConnectionType,
# ReconnectInterval and SenderCompID
等配置延用
default
的配置
BeginString=FIX.4.1
TargetCompID=ARCA
StartTime=12:30:00
EndTime=23:30:00
HeartBtInt=20
SocketConnectPort=9823
SocketConnectHost=123.123.123.123
DataDictionary=somewhere/FIX41.xml
[SESSION]
BeginString=FIX.4.0
TargetCompID=ISLD
StartTime=12:00:00
EndTime=23:00:00
HeartBtInt=30
SocketConnectPort=8323
SocketConnectHost=23.23.23.23
DataDictionary=somewhere/FIX40.xml
[SESSION]
BeginString=FIX.4.2
TargetCompID=INCA
StartTime=12:30:00
EndTime=21:30:00
#
自定义
ReconnectInterval
时间间隔值,不用
default
配置节点的配置,仅本会话有效
ReconnectInterval=30
HeartBtInt=30
SocketConnectPort=6523
SocketConnectHost=3.3.3.3
# (
可选
)
连接端口及连接服务主机列表
,
用于故障恢复时自动切换
SocketConnectPort1=8392
SocketConnectHost1=8.8.8.8
SocketConnectPort2=2932
SocketConnectHost2=12.12.12.12
DataDictionary=somewhere/FIX42.xml
(2) Acceptor 配置文件的样例
#
定义会话的默认配置(
default节点)
[DEFAULT]
FileStorePath=store
FileLogPath=log
ConnectionType=acceptor
ReconnectInterval=
60
SenderCompID=ARCA
# session definition
[SESSION]
# FileStorePath,FileLogPath,ConnectionType,
# ReconnectInterval and SenderCompID
等配置延用
default
的配置
BeginString=FIX.
4.1
TargetCompID=TW
StartTime=
12:
30:
00
EndTime=
23:
30:
00
HeartBtInt=
20
SocketAcceptPort=
9823
DataDictionary=somewhere/FIX41.xml
[SESSION]
BeginString=FIX.
4.0
TargetCompID=TW
StartTime=
12:
00:
00
EndTime=
23:
00:
00
HeartBtInt=
30
SocketAcceptPort=
8323
DataDictionary=somewhere/FIX40.xml
[SESSION]
BeginString=FIX.
4.2
TargetCompID=TW
StartTime=
12:
30:
00
EndTime=
21:
30:
00
#
自定义
ReconnectInterval
时间间隔值,不用
default
配置节点的配置,仅本会话有效
ReconnectInterval=
30
HeartBtInt=
30
SocketAcceptPort=
6523
# (
可选
)
仅监听指定主机的连接请求
SocketAcceptHost=
127.0.
0.1
DataDictionary=somewhere/FIX42.xml
出处:http://jinglelin.cnblogs.com
- QuickFIX/N入门:三、 如何配置QuickFIX/N
- QuickFIX/N入门
- QuickFIX/N入门:五、如何自定义FIX
- QuickFIX/N入门:如何自定义FIX
- QuickFIX/N入门:一、如何创建一个QuickFIX/N的应用程序
- QuickFIX/N入门:一、如何创建一个QuickFIX/N的应用程序
- QuickFIX/N入门:使用消息循环分组
- QuickFIX/N入门: 二、发送消息及接收消息
- QuickFIX/N入门:四、使用消息循环分组
- QuickFIX/N入门:二、发送消息及接收消息
- QuickFIX/N与QuickFIX的.NET封装不同之处
- QuickFix
- wingrep quickfix
- QuickFIX/J
- vim quickFix
- quickfix功能
- QuickFix/J 源代码研究(三)
- 用Quickfix详解Fix(三)---概念性基础
- javascript弹性运动
- Android分辨率适配宝典
- QuickFIX/N入门: 二、发送消息及接收消息
- STM32的地址分配
- GitHub for Windows 2.0使用教程
- QuickFIX/N入门:三、 如何配置QuickFIX/N
- vsftp添加用户
- Android最火框架集锦以及资源库
- QuickFIX/N入门:四、使用消息循环分组
- linux系统语言设置(i18n)
- QuickFIX/N入门:五、如何自定义FIX
- android自定义View之(一)------基本篇
- P2P借贷哪家强
- merge