forwardConfiguration File   Table of ContentExample of Configuration Fileforward
Complete Reference of Configuration Settings

SettingDescriptionDefault 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).

  • Value 0 means default grouping - the messages will be tried to send ASAP and pending messages (if any) will be grouped till reaching of TCP buffer size.
  • Value 1 means the messages will be sent ASAP and never will be grouped.
  • Value 2 (or greater) means the messages will be sent ASAP and pending messages will be grouped maximum by 2 (or greater).
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.

  • If 'True' creates new session storage when errors are detected.
  • If 'False' throws an exception and prevents the session against creating.
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
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