How to build your application with FIX Antenna .NET libraries

Samples at {path to FIX Antenna .NET package}\samples in FIX Antenna .NET package demonstate how to use FIX Antenna libraries.

To create a new application with FIX Antenna for Visual Studio 2010 follow the next instructions:

  1. Configuring project
    • Create a new Console application project.
    • Remove all default references except System
    • Set manually platform target for application (x86 or x64).
      The next steps describe the x64 case.
    • Add a reference FIXAntenna_net4.0.dll from package ( {path to FIX Antenna .NET package}\lib\x64\FIXAntenna_net4.0.dll ).
      Make sure that property Copy Local = true is set.



    • Copy engine.properties file to your project from any of existing samples (or create it using "FIXAntenna .NET" — Programmer's Guide).
      Note: you can add engine.properties to project and set Copy to Output directory = Copy if newer property or use absolute path.
       

  2. Working with code:
    • Declare the usage of com.b2bits.FIXAntenna namespace
    • Call FixEngine.Create with a path to the engine. properties as parameters in your application statup code.
    • Stop the engine before exiting the program

    Example:

    program.cs


    using com.b2bits.FIXAntenna;
     
    //...
     
    static void Main(string[] args)
    {
        try
        {
            FixEngine.Create("engine.properties");  // engine initialization
            // Your code
            // ...
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
        finally
        {
            FixEngine.Instance.Stop();
        }
    }
  3. Configure properties file:
    • Correct LicenseFile parameter in engine.properties. There should be absolute or relative path with filename to the license file.
      Note: For Win32 platforms, the filename-separator character is "\\" or "/" in engine.properties
      LicenseFile for samples in FIXAntenna .NET package configured to root of the package (i.e {path to FIX Antenna .NET package}\engine.license). Make sure that your copy license before run samples.

    • Create directories logs and logs\backup in $(TargetDir) of your project.
      These directories can be configured by parameters LogDirectory and BackupDirectory in engine.properties and should be created manually.

    • Copy required V12-vc10-MD*-x64.dll from {path to FIX Antenna .NET package}\lib directory to $(TargetDir) of your project.
      V12-vc10-MD-x64.dll for Release
      V12-vc10-MDD-x64.dll for Debug 

  4. Troubleshooting:

    • If application not working correctly look to logs\engine_XXXX.log for [ERROR] and [FATAL] notes.

    • Make sure that your aplication uses opened ports.