Versions Compared

Key

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

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

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

  1. Configuring project
    • Create new Console application project
    in Visual Studio (FIX Antenna
    • .
    NET supports Visual Studio 2010).Add a reference to proper
    • Remove all default references expect System
      Image Modified
    If application is required to run 64-bit platform add it for Debug and Release configuration with Configuration manager:
    Image Removed
    Image Removed Image Removed
    Image Removed Image Removed
    • Set manually platform target for application (x86 or x64).
      Next steps describe x64 case.
    • Add a reference FIXAntenna_net4.0.dll from package
    .
    For 32-bit platform:
    • ( {path to FIX Antenna .NET package}\lib\
    x32
    • x64\FIXAntenna_net4.0.dll

    For 64-bit platform: {path to FIX Antenna .NET package}\lib\x64\FIXAntenna_net4.0.dll
    • ).
      Make sure that property Copy Local = true is set.
      Image Modified
     
    • Image Modified 
      Image Modified
    • Copy engine.properties file to your project from any of existing samples (or create it

    use 

    Write code in Main() function to initialize engine with this properties file:

     

    Code Block
    languagec#
    titleprogram.cs
    try {
    • Note: you can add engine.properties to project and set Copy to Output directory = Copy if newer property or use absolute path.
      Image Added 

  2. Working with code:
    • Declare the usage of com.b2bits.FIXAntenna namespace
    • Call FixEngine.Create with path to engine.properties as parameter 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
    initialization
            //
    Your
    code
    code
            //
    ...
        }
        catch
     (Exception
    ex)
    {
        {
            Console.WriteLine(ex.ToString());
        }
        finally
    {
        {
            FixEngine.Instance.Stop();
        }

     

     

    Note: you can add this file to project and set Copy to Output directory = Copy if newer property or use absolute path.
    Image Removed

    }
  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*
    • required V12-vc10-MD*-x64.dll

    form 
    • from {path to FIX Antenna .NET package}\lib directory to $(TargetDir) of your project.

     

    (e.g.
    • V12-vc10-MD-x64.dll for

    x64
    • Release

    build; V12

    • V12-vc10-MDD-

    x32
    • x64.dll for

    x32 Debug build and so on)
  4. Make sure that your aplication uses opened ports.

  5. Build and run application.

...

    • Debug 

  1. 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.