Logout reason "Incorrect BeginString" on UnsupportedVersion exception is ambiguous

We had the situation any FIX sessions were immediately logged out with the reason "Incorrect BeginString". But the session was configured to use "FIX.4.4" and the incoming message came with "FIX.4.4" so we wondered why this happened.

Finally, we found that the configured data dictionary had the wrong FIX version tag which was difficult to find.

Code Analysis

• The logout reason "Incorrect BeginString" is sent if the exception UnsupportedVersion is thrown.
• This exception is sent on two quite different occasions:
  • Incoming BeginString does not match the session configuration.
  • On validate, configured data dictionary does not match the session configuration.
• In both cases, the same undifferentiated exception is thrown.

Improvements

• Provide differentiating reason text to the UnsupportedVersion exception:
  • If the message version does not match the data dictionary version on message validation, then:
    • "Message version ' {1}' does not match the data dictionary version '{2}'"
      ** If the message version does not match the configured FIX session version on incoming messages, then:
      *** "Message version '{1}

      ' does not match the configured FIX session version '

      {2}

      '"