Requirements & Compatibility

Supported operating systems: Any OS with JRE 5.0 or above installed.

Application license installation.

FIX Antenna requires a license file (fixaj2-license.bin) for its work. If you have no license, please contact us at sales@btobits.com . If you have the FIX Antenna license, put it please into one of the following places:

in application CLASSPATH;
in application working directory;
in user home directory.

Packages structure description

Fast Engine

The package includes a top-level directory fast-engine-N.N.N with the following content:

benchmarks - performance tests for simple and advanced usage
- FAST Decoder
- BOVESPA FAST Decoder
docs - this manual and API documentation
examples - samples of simple and advanced usage
lib - libraries required in runtime
apache-license-2.0.txt, CDDL-license.txt, license.txt - licenses for runtime libraries and for third-party libraries used in samples and benchmarks
VersionHistory.txt - change list for the whole set of FIX Antenna Java products
readme.html - readme document

CME Fast Adaptor

Fully functional application for communicating with CME.
The package includes a top-level directory fast-cmefastadaptor-N.N.N with the following content:

docs - this manual and API documentation
etc
- fast.properties - fast engine configurations
examples - samples of simple and advanced usage
lib - libraries required in runtime
apache-license-2.0.txt, CDDL-license.txt, license.txt - licenses for runtime libraries and for third-party libraries used in samples and benchmarks
VersionHistory.txt - change list for the whole set of FIX Antenna Java products
readme.html - readme document

BOVESPA Fast Adaptor

Fully functional application for communicating with BOVESPA.
The package includes a top-level directory fast-bovespafastadaptor-core-N.N.N with the following content:

benchmark
- BOVESPA Latency
- BOVESPA Throghput
docs - this manual and API documentation
etc
- config.xml - chanel configurations
- fixengine.properties - FIXAJ configuration (for TCP Replay connection)
- log4j.properties - logging configuration
- templates-UMDF.xml - FAST template file
examples - samples of simple and advanced usage
- Simple FAST Channel Sample
- FAST Channel Sample
lib - libraries required in runtime
tool - contains a sample of application for BOVESPA Certification
- BOVESPA FAST Tools
apache-license-2.0.txt, CDDL-license.txt, license.txt - licenses for runtime libraries and for third-party libraries used in samples and benchmarks
VersionHistory.txt - change list for the whole set of FIX Antenna Java products
readme.html - readme document

EBS Fast Adaptor

FAST adaptor for communicating with EBS.
The package includes a top-level directory fast-ebsfastadaptor-N.N.N with the following content:

docs - this manual and API documentation
examples - samples of simple and advanced usage
- Simple EBS Adaptor Sample
lib - libraries required in runtime
apache-license-2.0.txt, CDDL-license.txt, license.txt - licenses for runtime libraries and for third-party libraries used in samples and benchmarks
VersionHistory.txt - change list for the whole set of FIX Antenna Java products
readme.html - readme document

Samples descriptions

Samples is a set of small applications accompanied with sources that demonstrate the usage of the core FIX Antenna functionality.

FAST Samples

FastDecoder

This sample demonstrates how to decode a FAST message and get a FIX message.

Structure:

src\com\epam\fast\example\fastcodec\FastDecoder.java - source code
bin\runFastDecoder.bat - running script
data
- templates.xml - FAST template
- message.fast - FAST message for conversion
etc\log4j.properties - logging configuration
lib

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
run the script bin\runFastDecoder.bat
the application will print a converted FIX message to console

FastEncoder

This sample demonstrates how to encode a FIX message into FAST.

Structure:

src\com\epam\fast\example\fastcodec\FastEncoder.java - source code
bin\runFastEncoder.bat - running script
data
- templates.xml - FAST template
- message.fix - FIX message for conversion
etc\log4j.properties - logging configuration
lib

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
run the script bin\runFastEncoder.bat
the application will print a converted FAST message to console

SimpleFastClient

This sample demonstrates how to connect to FAST server and receive messages from it. It is built as a simple command line tool.

Structure:

src\com\epam\fast\example\client\SimpleFastClient.java - source code
bin\runSimpleFastClient.bat - running script
data\templates.xml - FAST template
etc\log4j.properties - logging configuration
lib

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
run the script bin\runSimpleFastClient.bat and pass host and port of your FAST server.
the application start and print all incoming messages to console.

CME FAST Samples

CME FAST Tools

This sample demonstrates how to subscribe and receive FAST messages from CME FAST connection stream.

Structure:

bin\run.bat - running script
etc
- log4j.properties - logging configuration
- fast.properties - FAST engine configuration
lib
src - sources code

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
Get the latest templates.xml from cme ftp site (ftp://ftp.cmegroup.com/fix/CertAutoCertPlus/Templates/Active/).
Get the latest config.xml from cme ftp site (ftp://ftp.cmegroup.com/fix/CertAutoCertPlus/Configuration/).
Change the line in bin/run.bat to following:
"%JAVA_BIN%" -cp CP% com.epam.cmefast.MainApp -c file:(path to config file) -t file:(path to templates file) -d (max book depth)
run the script bin/run.bat
subscribe to one or more instruments
type Ctrl + C to close the application

CME Channel Sample

This sample demonstrates how to create CME FAST adaptor and connect to CME FAST Stream

Structure:

src - sources code
bin\runChannelSample.bat - running script
etc
- config.xml - chanel configuration
- fast.properties - FAST engine properties
- log4j.properties - logging configuration
- templates.xml - CME FAST teplates
lib

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
run the script bin\runChannelSample.bat
the application will notify that a FAST messages is received

Simple CME FAST Channel Sample

This sample demonstrates how to create Simple CME channel and connect to CME FAST Stream

Structure:

src - sources code
bin\runSimpleFastClient.bat - running script
etc
- fast.properties - FIX engine properties
- log4j.properties - logging configuration
- templates.xml - CME FAST teplates
lib

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
run the script bin\runSimpleFastClient.bat
the application will notify that a FAST messages is received

CME High Level Market Data API Samples

This sample demonstrates how to use High Level Market Data API to make high-level connection to CME FAST Stream. High-level connection has built-in support of CME Business Objects like OrderBooks (Multiple Depth, Implied, Consolidated), Security Definition & Status, Statistics, Last Trades, Quote Requests.

Structure:

src - sources code
bin - scripts to run Examples
- AdhocBookExample.bat - script to run Adhoc Order Book Subscription Example
- ConsolidatedBookExample.bat - script to Consolidated Order Book Example
- DirectAndImpliedBooksExample.bat - script to run example of Direct and Implied Order Books in one Subscription
- DirectBookExample.bat - script to run Direct Order Book Example
- ImpliedBookExample.bat - script to run Implied Order Book Example
- LastTradeBySecDescExample.bat - script to run example of Last Trade of Security subscribed by Security Description
- LastTradeBySecurityGroupExample.bat - script to run example of Last Trade of Security subscribed by Security Group Name
- SecurityDefinitionListenerExample.bat - script to run example of Security Definition Listener
- StatisticsBySecuritySymbolExample.bat - script to run example of Statistics subscribed by Security Symbol
etc
- fast.properties - FIX engine properties
- log4j.properties - logging configuration of low-level CME adapter
- logback.xml - logging configuration of high-level CME API
- jfast-cme-md-func-* - user app configuration of high-level CME API used in the examples
lib

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
run the scripts from bin
the application will notify about progress in scenario and log information received via listeners

BOVESPA FAST Samples

BOVESPA FAST Tools

This sample demonstrates how to subscribe and receive FAST messages from BOVESPA FAST connection stream.

Structure:

bin\run.bat - running script
etc
- config.xml - chanel configuration
- fixengine.properties - FIX engine properties
- log4j.properties - logging configuration
- templates-UMDF.xml - FAST teplates
lib
src - sources code

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
run the script bin/run.bat
subscribe to one or more instruments
type Ctrl + C to close the application

FAST Channel Sample

This sample demonstrates how to create BOVESPA FAST adaptor and connect to BOVESPA FAST Stream

Structure:

src - sources code
bin\runChannelSample.bat - running script
etc
- config.xml - chanel configuration
- fixengine.properties - FIX engine properties
- log4j.properties - logging configuration
- templates-UMDF.xml - FAST teplates
lib

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
run the script bin\runChannelSample.bat
the application will notify that a FAST messages is received

Simple FAST Channel Sample

This sample demonstrates how to create Simple BOVESPA channel and connect to BOVESPA FAST Stream

Structure:

src - sources code
bin\runSimpleFastClient.bat - running script
etc
- config.xml - chanel configuration
- fixengine.properties - FIX engine properties
- log4j.properties - logging configuration
- templates-UMDF.xml - FAST teplates
lib

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
run the script bin\runSimpleFastClient.bat
the application will notify that a FAST messages is received

EBS FAST Samples

Simple EBS Adaptor Sample

This sample demonstrates how to connect and receive data from ICAP EBS servers.

Structure:

bin\runEBSAdapterSample.bat - running script
etc
- fixengine.properties - FIX engine configuration
- log4j.properties - logging configuration
- template.xml - teplates
lib
src - sources code

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
run the script bin\runSimpleFastClient.bat
the application will notify that a FAST messages is received

Benchmarks

FAST Benchmarks

FAST Decoder

This benchmark sample measures the speed of FAST stream decoding.

Structure:

src\com\epam\benchmark\fast\decoder\FASTDecoderBenchmark.java - source code
bin\runFASTBenchmarks.bat - running script
etc\log4j.properties - logging configuration
testdata
- templates.xml - FAST template
- stream.fast - encoded FAST messages for conversion
lib

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
run the script bin\runFASTBenchmarks.bat
the application will start and print the measured values to console after some time.

BOVESPA Benchmarks

BOVESPA FAST Decoder

This benchmark sample measures the speed of BOVESAP FAST stream decoding.

Structure:

src\com\epam\benchmark\fast\decoder\BFASTDecoderBenchmark.java - source code
bin\runBOVESPAFASTBenchmarks.bat - running script
etc\log4j.properties - logging configuration
testdata \ bovespa
- templates-UMDF.xml - FAST template
- stream.fast - encoded FAST messages for conversion
lib

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
run the script bin\runBOVESPAFASTBenchmarks.bat
the application will start and print the measured values to console after some time.

BOVESPA Latency

This benchmark sample measure latency for processing message inside BOVESPA Adaptor.

Structure:

src\com\epam\bovespafastadaptor\benchmark\latency\LatencyBenchmark.java - source code
runLatencyBM.bat - running script
etc
- log4j.properties - logging configuration
- config.xml - chanel configuration file
- templates-UMDF.xml - FAST template file
stream.incr.bin - encoded BOVESPA messages for conversion
lib

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
run the script runLatencyBM.bat
the application will start and print the measured values to console after some time.

BOVESPA Throghput

This benchmark sample measure throughtput of messages through BOVESPA Adaptor.

Structure:

src\com\epam\bovespafastadaptor\benchmark\throughput\ThroughputBenchmark.java - source code
runThroghputBM.bat - running script
etc
- log4j.properties - logging configuration
- config.xml - chanel configuration file
- templates-UMDF.xml - FAST template file
stream.incr.bin - encoded BOVESPA messages for conversion
lib

How to run:

make sure your license file is correct and properly installed for running this sample (Application license installation.)
run the script runThroghputBM.bat
the application will start and print the measured values to console after some time.

Uninstallation instructions

To uninstall FIX Antenna simply remove the FIX Antenna directory from disk. It is recommended to keep the license file though.

Libraries description

Antenna Libraries

fast-adaptor-api-N.N.N.jar

Public API for market data adapters.

fast-bovespafastadaptor-api-N.N.N.jar

BOVESPA Adaptor API for FIX Antenna.

fast-bovespafastadaptor-bean-N.N.N.jar

BOVESPA Util for FIX Antenna.

fast-bovespafastadaptor-benchmark-N.N.N.jar

Benchamrks for BOVESPA FAST adapter.

fast-bovespafastadaptor-core-N.N.N.jar

BOVESPA Core for FIX Antenna.

fast-bovespafastadaptor-examples-N.N.N.jar

Examples for BOVESPA FAST adapter.

fast-bovespafastadaptor-tags-N.N.N.jar

Customized constants for object mode.

fast-bovespafastadaptor-tool-N.N.N.jar

Advanced sample for BOVESPA FAST adapter.

fast-bovespafastadaptor-transport-N.N.N.jar

BOVESPA tranport.

fast-cme-adaptor-N.N.N.jar

CME implementation of public market data adapter API.

fast-cme-channel-beans-N.N.N.jar

fast-cme-xmlbeans-N.N.N.jar

Helper classes for CME Adaptor.

fast-cmeastadaptor-examples-N.N.N.jar

Examples for CME FAST adapter.

fast-cmefastadaptor-N.N.N.jar

CME Adaptor for FIX Antenna.

fast-cme-market-data-N.N.N.jar

CME High Level Market Data API.

fast-cmefastadaptor-util-N.N.N.jar

CME Adaptor Util for FIX Antenna.

fast-ebsfastadaptor-core-N.N.N.jar

EBS Core for FIX Antenna.

fast-ebsfastadaptor-examples-N.N.N.jar

Examples for EBS FAST adapter.

fast-engine-N.N.N-small.jar

FAST Engine.

fixaj-fastengine-benchmarks-N.N.N.jar

FAST engine benchmarks.

fast-fastengine-examples-N.N.N.jar

FAST engine samples.

fast-cme-certificate-cmd-tool-N.N.N.jar

Advaned sample for CME FAST adapter.

fixaj-common-N.N.N.jar

Base common classes for FIX Antenna.

fixaj-engine-N.N.N-small.jar

FIX Engine.

fixaj-engine-config-N.N.N.jar

FIX Engine configuration helper library.

fixaj-engine-encryption-api-N.N.N.jar

FIX Engine Encryption Api.

fixaj-engine-encryption-impl-N.N.N-small.jar

FIX Engine Encryption impementation.

fixaj-message-N.N.N.jar

FIX Messaging API and related utils for FIX Antenna.

fixaj-tags-N.N.N.jar

Constants for object model.

fixaj-xml-N.N.N.jar

XML marshalling library. Required for processing a FIX dictionary.

External Libraries

commons-cli-N.N.N.jar

The Apache Commons CLI library provides an API for parsing command line options passed to programs. More..

commons-logging-N.N.N.jar

Commons Logging is a thin adapter that allows configurable bridging to other well-known logging systems.

log4j-1.2.15.jar

Apache Log4J library for logging.

logback-classic-1.0.8.jar

Successor of Log4J library for logging.

logback-core-1.0.8.jar

Successor of Log4J library for logging.

guava-13.0.jar

Google's core libraries that we rely on in our Java-based projects: collections, caching, primitives support, concurrency libraries, common annotations, string processing, I/O, and so forth.

slf4j-api-1.7.2.jar

The Simple Logging Facade for Java or (SLF4J) serves as a simple facade or abstraction for various logging frameworks, e.g. java.util.logging, log4j and logback, allowing the end user to plug in the desired logging framework at deployment time.

jackson-core-asl-1.9.11.jar

JSON processor (JSON parser + JSON generator) written in Java. Beyond basic JSON reading/writing (parsing, generating), it also offers full node-based Tree Model, as well as full OJM (Object/Json Mapper) data binding functionality.

jackson-mapper-asl-1.9.11.jar

JSON processor (JSON parser + JSON generator) written in Java. Beyond basic JSON reading/writing (parsing, generating), it also offers full node-based Tree Model, as well as full OJM (Object/Json Mapper) data binding functionality.

btc-ascii-table-1.0.jar

Print table data in ASCII format. Used to log table data in tests and examples.