Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Parameter name
Available values
Description
Session.<SenderId>/<TargetId>.AllowMessageWithoutPossDupFlag

 

true
false

This parameter is an option whereby the repeated messages are received without PossDupFlag (43) field. It's used for incoming messages only.

If set to “true” and a message is received with a sequence number less than expected without PossDupFlag (43), a message will be processed. If set to “false”, the connection will be closed. The default value is “false”.

This parameter is optional.

Session.<SenderId>/<TargetId>.ValidateCheckSum
true
false

This parameter is an option whereby CRC validation for incoming messages can be controlled. It's used for incoming messages only.

If set to “true” session will be processed. If set to “false session skips CRC validation for incoming messages. The default value is “true”.

This parameter is optional.

Session.<SenderId>/<TargetId>.IgnoreSeqNumTooLowAtLogon
true
false

This parameter is an option whereby session is processed if sequence number in Logon message is lower than expected. It allows to resolve ‘SeqNum too low’ problem at logon. It's used for incoming messages only.

If set to “true” ‘SeqNum too low’ at incoming Logon message is ignored and session will be continued with received ‘SeqNum’. If set to “false” and sequence number in Logon message is lower than expected connection will be closed. The default value is “false”.

This parameter is optional.

Session.<SenderId>/<TargetId>.Validation.IsEnabled
true
false

This parameter is an option whereby validation in messages (application and session levels) can be controlled.

If set to "true" all application messages will be validated. If set to "false" validation of the messages will be skipped.

This parameter is optional. The default value is  "true".

Session.<SenderId>/<TargetId>.Validation.IgnoreUnknownFields
true
false

WARNING! Changing this value will impact the performance of FIX Engine.

This parameter is an option whereby undefined fields can be ignored during incoming message parsing (both session and application messages). It's used for incoming messages only.

If set to “true” any field that is unknown to the dictionary will be ignored. If set to “false” all unknown fields will be stored in the list on the heap. The default value is “false”.

NOTE! In case when IgnoreUnknownField = true it has priority over all other validation settings. For example, even if MessageMustBeValidated = true, or ProhibitUnknownTags = true unknown fields are ignored.

Should be set to “false” for development (and all unknown fields should be listed in the dictionary file), and to “true” for production because if set to “false” FIX Engine stores all unknown fields in the FIX Message in the list on the heap. If set to"true" it would ignore these fields thus limit storage on the heap.

This parameter is optional.

Example (to ignore unknown fields):

IsEnabled = true/false (doesn't matter)

IgnoreUnknownFields = true

Session.<SenderId>/<TargetId>.Validation.ProhibitUnknownTags
true
false

This parameter is an option whereby unknown fields handling can be controlled. It's used for outgoing and incoming messages.

If set to “true” the engine will reject messages with unknown tags in the fields. If set to “false” then all fields with unknown tags will be stored in the message. The default value is “false”.

This parameter is optional.

Example (to reject unknown tags):

IsEnabled = false

IgnoreUnknownFields = false

ProhibitUnknownTags = true/false

MessageMustBeValidated = true

Session.<SenderId>/<TargetId>.Validation.ProhibitTagsWithoutValue
true
false

This parameter is an option whereby fields without values in incoming messages can be prohibited.  It's used for incoming messages (application level) and outgoing messages (both session and application levels).

When the engine receives an incoming message without value, an "exception" is created. If set to “true” exception will be fired. The counterparty will receive a reject session message (35=3). If set to “false” the raw message may contain tags without values - they will be ignored. The default value is “true”.

This parameter is optional.

Example (to prohibit tags without value):

IsEnabled = false

ProhibitTagsWithoutValue = true

Session.<SenderId>/<TargetId>.Validation.VerifyTagsValues
true
false

This parameter is an option whereby tag values verification can be controlled. It's used for outgoing messages.

If set to “true”, then all tag values in messages are verified on the basis of engine vocabulary. If set to “false”, then the responsibility for message validity rests with the counterparty. The default value is true.

This parameter is optional.

Session.<SenderId>/<TargetId>.Validation.VerifyRepeatingGroupBounds
true
false

This parameter is an option whereby repeating group size verification can be controlled. It's used for incoming messages.

If set to “true”, engine will reject messages with incorrect repeating group size. If set to “false”, message will be passed to the application layer. In this case the responsibility for message validity rests with the counterparty. The default value is “true”.

This parameter is optional.

Prior to FIX Antenna version 2.28.1, this parameter was called Validation.VerifyReperatingGroupBounds.

Session.<SenderId>/<TargetId>.Validation.CheckRequiredGroupFields
true
false

This parameter is an option whereby the validation of required fields in repeating group can be controlled. It's used for outgoing and incoming messages.

If set to “true”, then repeating groups will be checked for presence of required and conditionally required fields. If set to “false”, then the responsibility for repeating group validity rests with the counterparty. The default value is “true”.

The recommended setting is “true”.

This parameter is optional.

Session.<SenderId>/<TargetId>.Validation.ProhibitDuplicatedTags
true
false

This parameter is an option whereby incoming messages with duplicated tags can be processed. It's used for incoming messages.

If set to “true” incoming messages with duplicated tags will be rejected with the following message:

"Tag appears more than once [RefSeqNum: _, RefTagID: _, RefMsgType: _]".

If set to “false” raw message may contain duplicated field definitions. The default value is “true”. This parameter is optional.

In engine.properties file, the option can be defined:

  • for all sessions:

    Code Block
    languagebash
    themeConfluence
    Session.Default.Validation.ProhibitDuplicatedTags = true
  • for a specific session:

    Code Block
    languagebash
    themeConfluence
    Session.<SenderId>/<TargetId>.Validation.ProhibitDuplicatedTags = true
Session.<SenderId>/<TargetId>.GenerateCheckSum
true
false
Generation of CRC.

...