Configuration File | Table of Content | Example of Configuration File |
Complete Reference of Configuration Settings |
Setting | Description | Default value |
---|---|---|
Acceptor.SendLogoutOnInvalidLogon | Option to send a Logout message before dropping the telecommunication link in reply on an invalid logon attempt (e.g. received an initial Logon message when a valid FIX Connection is already underway for the same SenderCompID, TargetCompID and FIX Version). | False |
AutomaticallyCreatedSessionStorageType | Specifies the SessionStorageType of the automatically created Session object that corresponds to the incoming FIX Connection. | FileBasedStorage |
AsyncFileBasedStorageQueueMaxSize | Specifies the log queue maximum size of the asynchronous session storage. | Int32.MaxValue (Unlimited) |
AsyncFileBasedStorageThreadAffinity | Specifies the CPU index(es) for the affinity of the asynchronous session storage threads. The symbol ',' is used as the CPU index delimiter. This affinity will be used by all asynchronous session storages of all sessions. | Empty |
Connection.MessageGrouping | Message grouping option for non-blocking connections (in microseconds).
| 0 |
ThreadingModel | Specifies the Threading Model for the FIX Sessions. For more details please see ThreadingModel. | DedicatedThreads |
Connection.ReceiveBufferSize | The size of the buffer which is allocated to the FIX connection for receiving data. It is set to '-1' then the default system value is used. | 65535 |
Connection.ReceiveSpinningTimeout | Specifies the non-blocking receive spinning timeout (in microseconds) before the receiving thread enters into the blocking wait mode. | 0 |
Connection.SendSpinningTimeout | Specifies the send spinning timeout (in microseconds) of the Send(Message) method to wait for the socket sending buffer availability in the spin loop mode before placing the message to the outgoing queue (to be sent later by the sending thread). | 0 |
Connection.SendBufferSize | The size of the buffer which is allocated to the FIX connection for sending data. It is set to '-1' then the default system value is used. | 65535 |
Connection.TcpNoDelayOption | Option to improve (i.e. reduce) latency at the expense of the message throughput. | true |
Dialect | Specifies path(s) to XML file(s) with the description of FIX dialect(s). The symbol '|' is used as a filename delimiter. | Empty |
DialectString | Specifies the plain text string with a description of the FIX dialect. | Empty |
ExpectedIncomingMessageSize | The value represents an average FIX message size that is expected to be received by the session during the lifetime. It is used as a hint for the optimization of the deserialization of large FIX messages with a lot of repeating groups. | 102400 |
FileBasedStorageSegmentSize | Segment size for the file based session storage. | 0 |
FirstLogonTimeout | Timeout (in seconds) between an incoming TCP connection is detected and the first Logon message is received. | 30 |
IgnoreFileBasedStorageIntegrityErrors | Behavior when File Based Storage errors are detected.
| False |
LicenseFile | Path to the license file. For more information, take a look at LicenseFile property reference. This setting is deprecated as FIX Engine 2.76.1.0. | Empty |
LicenseStore | Path to the license directory. For more information, take a look at LicenseStore property reference. | Directory that contains the executable file of the current process |
LicenseString | String of the license content. For more information take a look at LicenseString property reference. | Empty |
LicenseAlertingDaysBeforeExpiration | Specify the number of days to alert before the license expiration. If the amount of remaining license days is less or equal to this number then the warning will be reported to the FIX Engine's log and the Warning event will be invoked. | 0 (No alerting) |
ListenPort | The Engine listens on this port for incoming connections. If it is set to '0' then only session-initiators can be created. If '-1' then the telecommunication level is disabled and only message parsing/assembling can be used. Comma-delimited list could be used to specify more than one listen port. | 0 |
LocalInterfaces | Specifies local interfaces where engine listens for incoming connections. Each local interface specification could specify a local IP address and port. For instance "localhost" and "192.168.0.1:4501" are valid values. When a local interface specification contains the same port as specified at listenPort settings the listening appears only on the interface and port specified at localInterface setting. | Empty |
Log.CreateEngineLogFile | Option to create the FIX Engine Log file. | True |
Log.Directory | Inbound and outbound messages, sessions state data and the Engine log file (FixEngine.log) are stored in this directory. | MsgStorage |
Log.BeforeSending | Option to switch on/off logging of outbound messages before/after sending. | True |
LogFileName | Specifies the FIX Engine log file name. | FixEngineLog.txt |
LocalTimeUsage | Specifies the usage of local time in FIX Engine events and log files. | False |
Log.InboundMessages | Option to log inbound messages. See also: LogInboundMessages. | True |
Log.OutboundMessages | Option to log outbound messages. See also: LogOutboundMessages. | True |
ProcessDeliverToCompID | Option to automatically process the DeliverToCompID (128) field. | False |
ReasonableTransmissionTime | The reasonable transmission time as % from HeartBtInt value. When either end of the connection has not received any data for HeartBtInt * (100 + ReasonableTransmissionTime) / 100 seconds, it will transmit a Test Request message. If there is still no a Heartbeat message which is received after (HeartBtInt * (100 + ReasonableTransmissionTime)/100) seconds, then the connection should be considered lost, and the corrective action is initiated. | 20 |
Reconnect.Attempts | Number of attempts to restore the FIX connection. | 3 |
Reconnect.Interval | The time interval between the attempts to restore the FIX connection (in seconds). | 180 |
Resending.QueueSize | Number of sent messages that are available for resending to counterparty's Resend Request <2> message. | 1000 |
Resending.ResendRequestMaximumRange | The maximum number of messages to be requested in one Resend Request <2> message. | 0 (Unlimited) |
ReportNewMessagesWhileWaitingForMissedMessages | When the message gap is detected the Resend Request <2> FIX Message is sent and Session state is changed to "AwaitReplyOnResendRequest". By default in this state, the incoming new messages (without the PossDupFlag (tag #43) flag) are ignored because we expect them to be re-sent later again with the PossDupFlag flag. This property allows to change this behavior and report the new messages anyway. In this mode messages could be reported out of the original order: e.g. MsgSeqNum could be: 3 (original), 4 (original), 2 (PossDupFlag='Y'), 3 (PossDupFlag='Y'), 4 (PossDupFlag='Y') and some messages could be received two times: first time without PossDupFlag='Y' and second time - with this flag. | False |
Session.SendLogoutOnException | Option to send the Logout message before dropping the telecommunication link in case of Exception during the processing of the incoming FIX message (e.g. when the incoming message sequence number is less than it is expected). | False |
SpecifyApplVerIdField | Option to specify ApplVerID(1128) tag in all application FIX messages when a FIX protocol version FIX 5.0 and above is used. | True |
SpecifyLastMsgSeqNumProcessed | Option to specify the LastMsgSeqNumProcessed (tag=369) field on every message sent. Useful for detecting a backlog with a counterparty. | False |
SSL.CertificateFile | The path to the TLS/SSL certificate file in (Privacy Enhanced Mail) Base64 encoded (.pem) format. This file can refer to a certificate chain file with multiple CA certificates. See also: TLS/SSL Encryption. | Empty |
SSL.ListenPort | The Engine listens on this port for incoming TLS/SSL connections. If it is set to '0' then only TLS/SSL-based session-initiators can be created. If '-1' then TLS/SSL encryption is disabled. Comma-delimited list could be used to specify more than one TLS/SSL listen port. See also: TLS/SSL Encryption. | 0 |
SSL.LocalInterfaces | Specifies local interfaces where engine listens for incoming TLS/SSL connections. | Empty |
SSL.PrivateKeyFile | The path to the TLS/SSL private key file in (Privacy Enhanced Mail) Base64 encoded (.pem) format. See also: TLS/SSL Encryption. | Empty |
SSL.PrivateKeyPassword | The password to load private keys that are protected by a password. | Empty |
SSL.VerifyPeer | Option to request client certificates and perform the certificate verification. | False |
SSL.CaFile | The path to the trusted certification authority certificate file in (Privacy Enhanced Mail) Base64 encoded (.pem) format. See also: TLS/SSL Encryption. | Empty |
SSL.MinProtocolVersion | The minimal SSL/TLS protocol version that will be declared during the SSL/TLS handshake. See also: TLS/SSL Encryption. | LowestHighest |
SSL.MaxProtocolVersion | The maximal SSL/TLS protocol version that will be declared during the SSL/TLS handshake. See also: TLS/SSL Encryption. | LowestHighest |
ServiceThreadAffinity | Specifies the CPU index(es) for the affinity of the Engine service threads. The symbol ',' is used as the CPU index delimiter. | Empty |
ServiceThreadPriority | Specifies the priority of the Engine service threads. | Normal |
ScrambleLogonFields | Specifies scramble fields in the Logon message, in the session storage and FIX Engine log, for security reasons. Symbol ',' is used as the tag number delimiter. | Empty |
SendQueueMaxSize | The send queue maximum size in bytes. | 536870912 (0.5 Gb) |
ThreadPoolSize | Specifies the thread pool size. | 0 |
UseMemoryPressure | Option to inform the .NET runtime about allocated unmanaged memory. If this value was false, latency will be improved because of less GC work, but in case of a lot amount of large messages can cause OutOfMemoryException. It is safe to set this option to false if Message.Dispose() called for each message. | True |
Validate.EmptyFieldValues | Option to validate the empty field values of FIX messages in accordance with the FIX protocol or its FIX Dialect. | False |
Validate.FieldValues | Option to validate the field values of FIX messages in accordance with the FIX protocol or its FIX Dialect. | False |
Validate.RepeatingGroupEntryCount | Option to validate that the declared number of the Repeating Group instances is equal to the actual one. | True |
Validate.RepeatingGroupLeadingTag | Option to validate that the Repeating Group starts from the required by dialect leading tag. | False |
Validate.RequiredFields | Option to validate the presence of required fields in inbound and outbound messages. | False |
Validate.UnknownFields | Option to validate the presence of unknown fields (fields that do not belong to the message in accordance with the FIX protocol or its FIX Dialect). | False |
Validate.UnknownMessages | Option to validate the presence of unknown FIX messages (messages that do not belong to the message in accordance with the FIX protocol or its FIX Dialect). | False |
Validate.DuplicatedField | Option to validate the presence of fields which appears more than once. | False |
Validate.ValidateChecksum | Option to validate the checksum of incoming messages. | False |