如何配置QuickFIX/N

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

连接异常断开后是否要将序列号重置为

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=
SenderCompID=ARCA
 
# session definition
[SESSION]
# FileStorePath,FileLogPath,ConnectionType, 
#    ReconnectInterval and SenderCompID 等配置延用 default的配置
BeginString=FIX.4.1
TargetCompID=TW
StartTime=12:30:
EndTime=23:30:
HeartBtInt=
SocketAcceptPort=
DataDictionary=somewhere/FIX41.xml
 
[SESSION]
BeginString=FIX.4.0
TargetCompID=TW
StartTime=12:00:
EndTime=23:00:
HeartBtInt=
SocketAcceptPort=
DataDictionary=somewhere/FIX40.xml
 
[SESSION]
BeginString=FIX.4.2
TargetCompID=TW
StartTime=12:30:
EndTime=21:30:
#自定义ReconnectInterval时间间隔值,不用default配置节点的配置,仅本会话有效
ReconnectInterval=
HeartBtInt=
SocketAcceptPort=
# (可选) 仅监听指定主机的连接请求
SocketAcceptHost=127.0.0.1
DataDictionary=somewhere/FIX42.xml
上一篇:# 课下测试补交(ch01)20155337


下一篇:UVM中的sequence使用(一)