Installation & Uninstallation

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:

1. in application CLASSPATH;
2. in application working directory;
3. in user home directory.

Functional Matrix

	FIXAJ Light	FIXAJ Full	FIXAJ Addons	ICE Adaptor	FIXML Convertor	FIXAJ + FIXML Convertor	Fast Engine	FIXAJ + FAST Engine	CME Fast Adaptor	JMS Adaptor
Features
FIX Engine
FIX 4.0 - FIX 4.4
FIX 5.0
FIX 5.0 SP1
FIX 5.0 SP2
Custom messages and fields support
Multiple FIX sessions
Iniciator/Acceptor Sessions
Autoreconect Session
Support SSL (compatible with openssl)
Transient Sessions
Restore state after failure (Persistent Session)
Switch to backup connection
Pluggable session level
Admininstrative Plugin for FIXAJ
Adaptor for FIXAJ 1.X
Message Object Model
ICE customization
Message Vallidation
Wellformeness Validation
Allowed Fields Validation
Required Fields Validation
Fields Order Validation
Duplicate Fields Detection
Field Type Validation
Groups Validation
Conditional Fields Validation
FIXML Converter
FIXML for FIX 4.1- FIX 4.4
FIXML for FIX 5.0
FIXML for FIX 5.0 SP1
FIXML for FIX 5.0 SP2
FIX-to-FIXML convertation
FIXML-to-FIX convertation
FAST
FAST 1.1
FIX-over-FAST
CME FAST
JMS
Support for JMS queues
Bidirect FIX-to-JMS routing server
Customizable JMS message

Packages structure description

FIXAJ Light

FIX Engine with minimal footprint. This package can be used in products which have strict restriction for their size.
The package includes a top-level directory fixaj-engine-N.N.N with the following content:

• examples - samples of simple and advanced usage
  • MaxSpeedBroadcaster
  • SimpleAdminClient
  • SimpleNewsBroadcaster
  • SimpleServer
  • SimpleServerWithAdminSession
  • CustomSessionLevelBroadcaster
  • CustomStorageBroadcaster
  • SingleMessageSSLClient
  • SimpleSSLNewsBroadcaster
  • SimpleSSLServer
• lib - libraries required in runtime
  • activation-1.1.jar - JavaBeans Activation Framework (JAF) is a standard extension to the Java platform that lets you take advantage of standard services to: determine the type of an arbitrary piece of data; encapsulate access to it; discover the operations available on it; and instantiate the appropriate bean to perform the operation(s). Required by Administarative plugin (JaxB dependency).
  • commons-logging-1.1.1.jar - Commons Logging is a thin adapter that allows configurable bridging to other well-known logging systems.
  • fixadminprotocol-api-N.N.N.jar - API for administrative messages.
  • fixadminprotocol-impl-N.N.N.jar - Administrative messages implementation.
  • fixaj-adaptor-N.N.N.jar - Adaptor for FIX Antenna 1.xx.
  • fixaj-admin-N.N.N.jar - Administrative plugin.
  • fixaj-common-N.N.N.jar - Base common classes for FIX Antenna.
  • fixaj-engine-N.N.N-small.jar - FIX Engine.
  • fixaj-message-N.N.N.jar - FIX Messaging API and related utils for FIX Antenna.
  • jaxb-api-2.2.jar - JAXB API for serializing/deserializing administrative messages. Required by Administarative plugin.
  • jaxb-impl-2.2.jar - JAXB implementation for serializing/deserializing administrative messages. Required by Administarative plugin.
  • log4j-1.2.15.jar - Apache Log4J library for logging.
  • stax-api-1.0-2.jar - StAX is a standard XML processing API that allows you to stream XML data from and to your application. Required by Administarative plugin (JaxB dependency).
• 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

You can remove administrative plugin dependencies and decrease a required footprint.

FIXAJ Full

Fully functional FIX engine.
The package includes a top-level directory fixaj-engine-full-N.N.N with the following content:

• benchmarks - performance tests for simple and advanced usage
  • Latency
  • Throughput
  • Throughput With Nagle
  • Transaction
  • Transaction Sequence
  • FIX Message Parsing
  • Validation
• docs - this manual and API documentation
• examples - samples of simple and advanced usage
  • CreateMessage
  • FlatNewOrderSingleMessage
  • MaxSpeedBroadcaster
  • NewOrderSingleMessage
  • SimpleAdminClient
  • SimpleNewsBroadcaster
  • SimpleServer
  • SimpleServerWithAdminSession
  • SimpleServerWithCustomDic
  • CustomProtocolBroadcaster
  • CustomSessionLevelBroadcaster
  • CustomStorageBroadcaster
  • SingleMessageSSLClient
  • SimpleSSLNewsBroadcaster
  • SimpleSSLServer
  • AdditionalValidationSample44
  • SimpleValidator44
  • SimpleValidator50
• lib - libraries required in runtime
  • activation-1.1.jar - JavaBeans Activation Framework (JAF) is a standard extension to the Java platform that lets you take advantage of standard services to: determine the type of an arbitrary piece of data; encapsulate access to it; discover the operations available on it; and instantiate the appropriate bean to perform the operation(s). Required by Administarative plugin (JaxB dependency).
  • commons-logging-1.1.1.jar - Commons Logging is a thin adapter that allows configurable bridging to other well-known logging systems.
  • fixadminprotocol-api-N.N.N.jar - API for administrative messages.
  • fixadminprotocol-impl-N.N.N.jar - Administrative messages implementation.
  • fixaj-adaptor-N.N.N.jar - Adaptor for FIX Antenna 1.xx.
  • fixaj-admin-N.N.N.jar - Administrative plugin.
  • fixaj-common-N.N.N.jar - Base common classes for FIX Antenna.
  • fixaj-engine-N.N.N-small.jar - FIX Engine.
  • fixaj-message-N.N.N.jar - FIX Messaging API and related utils for FIX Antenna.
  • fixaj-model-N.N.N.jar - Object model for FIX Antenna
  • fixaj-tags-N.N.N.jar - Constants for object mode.
  • fixaj-validation-N.N.N.jar - FIX Antenna validation module .
  • fixaj-xml-N.N.N.jar - XML marshalling library. Required for processing a FIX dictionary.
  • fixaj-xmlbeans-N.N.N.jar - FIX dictionary mapping.
  • fixprotocol-fix-N.N.N.jar - FIX dictionaries.
  • jaxb-api-2.2.jar - JAXB API for serializing/deserializing administrative messages. Required by Administarative plugin.
  • jaxb-impl-2.2.jar - JAXB implementation for serializing/deserializing administrative messages. Required by Administarative plugin.
  • log4j-1.2.15.jar - Apache Log4J library for logging.
  • stax-api-1.0-2.jar - StAX is a standard XML processing API that allows you to stream XML data from and to your application. Required by Administarative plugin (JaxB dependency).
• 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

FIXAJ Addons

Validation and Message Object Model for FIX Antenna.
The package includes a top-level directory fixaj-engine-full-N.N.N with the following content:

• benchmarks - performance tests for simple and advanced usage
  • Latency
  • Throughput
  • Throughput With Nagle
  • Transaction
  • Transaction Sequence
  • FIX Message Parsing
  • Validation
• docs - this manual and API documentation
• examples - samples of simple and advanced usage
  • CreateMessage
  • FlatNewOrderSingleMessage
  • NewOrderSingleMessage
  • AdditionalValidationSample44
  • SimpleValidator44
  • SimpleValidator50
• lib - libraries required in runtime
  • fixaj-message-N.N.N.jar - FIX Messaging API and related utils for FIX Antenna.
  • fixaj-model-N.N.N.jar - Object model for FIX Antenna
  • fixaj-tags-N.N.N.jar - Constants for object mode.
  • fixaj-validation-N.N.N.jar - FIX Antenna validation module .
  • fixaj-xml-N.N.N.jar - XML marshalling library. Required for processing a FIX dictionary.
  • fixaj-xmlbeans-N.N.N.jar - FIX dictionary mapping.
  • fixprotocol-fix-N.N.N.jar - FIX dictionaries.
• 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

ICE Adaptor

FIX Antenna Solution for ICE Trade Capture. This package contains console and GUI tools for communicating with ICE Trade Capture interface.
The package includes a top-level directory fixaj-iceadaptor-N.N.N with the following content:

• bin - running scripts for Trade capture example applications
  • runConsoleExample.bat
  • runConsoleExample
  • runUIExample.bat
  • runUIExample
• docs - this manual and API documentation
• lib - libraries required in runtime
  • commons-logging-1.1.1.jar - Commons Logging is a thin adapter that allows configurable bridging to other well-known logging systems.
  • fixaj-common-N.N.N.jar - Base common classes for FIX Antenna.
  • fixaj-engine-N.N.N-small.jar - FIX Engine.
  • fixaj-iceadaptor-N.N.N.jar - FIX Engine Adaptor for ICE with custom dictionaries.
  • fixaj-message-N.N.N.jar - FIX Messaging API and related utils for FIX Antenna.
  • fixaj-validation-N.N.N.jar - FIX Antenna validation module.
  • fixaj-xml-N.N.N.jar - XML marshalling library. Required for processing a FIX dictionary.
  • fixaj-xmlbeans-N.N.N.jar - FIX dictionary mapping.
  • forms-1.1-preview.jar - JGoodies Forms framework.
  • forms_rt-7.0.3.jar - Runtime library for IntelliJIdea forms.
  • jdom-1.0.jar - JDOM is, quite simply, a Java representation of an XML document. JDOM provides a way to represent the document for easy and efficient reading, manipulation, and writing. It is provided with a straightforward API, lightweight, fast and optimized for the Java programmer. It is an alternative to DOM and SAX, although it integrates well with both DOM and SAX.
  • log4j-1.2.15.jar - Apache Log4J library for logging.
• misc - configuration files for sample application
  • fixengine.properties
  • log4j.properties
• src - source codes for sample Trade Capture applications
• 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

FIXML Convertor

A set of FIX Antenna related libraries for converting FIX to FIXML and back.
The package includes a top-level directory fixaj-fixmlconverter-N.N.N with the following content:

• benchmarks - performance tests for simple and advanced usage
  • FIXML 4.1 Converter
  • FIXML 4.4 Converter
• docs - this manual and API documentation
• examples - samples of simple and advanced usage
  • FIX2FIXML
  • FIX2FIXMLWithCustomSerializer
  • FIXML2FIX
  • FIXML2FIXWithCustomParser
• tools - command line tools for FIX to FIXML (and back) conversions
  • FIX-2-FIXML Converter
  • FIXML-2-FIX Converter
• lib - libraries required in runtime
  • commons-logging-1.1.1.jar - Commons Logging is a thin adapter that allows configurable bridging to other well-known logging systems.
  • fixaj-common-X.X.X.jar - Base common classes for FIX Antenna.
  • fixaj-fixmlconverter-X.X.X-small.jar - FIX Antenna FIXML Converter library.
  • fixaj-message-X.X.X.jar - Messaging API and related utils for FIX Antenna.
  • log4j-1.2.15.jar - Apache Log4J library for logging.
• 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

Fast Engine

The package includes a top-level directory fixaj-fastengine-N.N.N with the following content:

• benchmarks - performance tests for simple and advanced usage
  • FAST Decoder
• docs - this manual and API documentation
• examples - samples of simple and advanced usage
  • FastDecoder
  • FastEncoder
  • SimpleFastClient
• lib - libraries required in runtime
  • commons-logging-1.1.1.jar - Commons Logging is a thin adapter that allows configurable bridging to other well-known logging systems.
  • fixaj-common-N.N.N.jar - Base common classes for FIX Antenna.
  • fixaj-engine-N.N.N-small.jar - FIX Engine.
  • fixaj-fast-N.N.N-small.jar - FAST Engine.
  • fixaj-message-N.N.N.jar - FIX Messaging API and related utils for FIX Antenna.
  • fixaj-xml-N.N.N.jar - XML marshalling library.
  • log4j-1.2.15.jar - Apache Log4J library for logging.
• 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

CME Fast Adaptor

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

• docs - this manual and API documentation
• lib - libraries required in runtime
  • commons-logging-1.1.1.jar - Commons Logging is a thin adapter that allows configurable bridging to other well-known logging systems.
  • fixaj-cmefastadaptor-N.N.N.jar CME Adaptor for FIX Antenna.
  • fixaj-common-N.N.N.jar - Base common classes for FIX Antenna.
  • fixaj-fast-N.N.N-small.jar - FAST Engine.
  • fixaj-message-N.N.N.jar - FIX Messaging API and related utils for FIX Antenna.
  • fixaj-xml-N.N.N.jar - XML marshalling library. Required for processing a FIX dictionary.
  • log4j-1.2.15.jar - Apache Log4J library for logging.
• misc
• 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

JMS Adaptor

Adaptor wich helps to link FIX Antenna and Java Message Service. The package also contains a server for routing FIX messages to and from JMS server.
The package includes a top-level directory fixaj-jmsadaptor-N.N.N with the following content:

• docs - this manual and API documentation
• examples - samples of simple and advanced usage
  • FIXJMSAdpator
  • FIXJMSAdvancedAdpator
• lib - libraries required in runtime
  • commons-logging-1.1.1.jar - Commons Logging is a thin adapter that allows configurable bridging to other well-known logging systems.
  • fixaj-common-N.N.N.jar - Base common classes for FIX Antenna.
  • fixaj-engine-N.N.N-small.jar - FIX Engine.
  • fixaj-jmsadaptor-N.N.N.jar - JMS Adaptor for FIX Antenna.
  • fixaj-message-N.N.N.jar - FIX Messaging API and related utils for FIX Antenna.
  • fixaj-validation-N.N.N.jar - FIX Antenna validation module.
  • fixaj-xml-N.N.N.jar - XML marshalling library. Required for processing a FIX dictionary.
  • fixaj-xmlbeans-N.N.N.jar - FIX dictionary mapping.
  • fixprotocol-fix-N.N.N.jar - FIX dictionaries.
  • jms-1.1.jar - The Java Message Service (JMS) API is a messaging standard that allows application components based on the Java 2 Platform, Enterprise Edition (J2EE) to create, send, receive, and read messages. It enables distributed communication that is loosely coupled, reliable, and asynchronous.
  • log4j-1.2.15.jar - Apache Log4J library for logging.
• tools
  • JMSBridge
• 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

Samples descriptions

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

Simplest FIXAJ Samples

CreateMessage

This sample demosntrates how to create a message object easily with FIX Messaging API.

Structure:

• src\com\epam\example\api\CreateMessage.java - source code
• base\runCreateMessage.bat - running script
• etc\log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • fixaj-tags-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script base\runCreateMessage.bat
• a message in FIX format will be built and printed to console

FlatNewOrderSingleMessage

This sample demosnatrates several ways to convert an existing string with a FIX message into its object representation.

Structure:

• src\com\epam\example\api\FlatNewOrderSingleMessage.java - source code
• base\runNewOrderSingleMessage.bat - running script
• etc\log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • fixaj-model-N.N.N.jar
  • fixaj-tags-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script base\runFlatNewOrderSingleMessage.bat
• each parced message will be printed to console

NewOrderSingleMessage

This example demonstrates how to create a NewOrderSingle (D) message with object messaging model.

Structure:

• src\com\epam\example\api\NewOrderSingleMessage.java - source code
• base\runNewOrderSingleMessage.bat - running script
• etc\log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • fixaj-model-N.N.N.jar
  • fixaj-tags-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script base\runCreateMessage.bat
• a message in the FIX format will be built and printed to console

SimpleNewsBroadcaster

Simplest client application. It demonstrates how to create a FIX initiator session and send a News (B) message to server.

Structure:

• src\com\epam\example\SimpleNewsBroadcaster.java - source code
• base\runSimpleNewsBroadcaster.bat - running script
• etc
  • fixengine.properties - FIX Engine configuration
  • log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run FIX server application (for example, SimpleServer)
• run the script base\runSimpleNewsBroadcaster.bat
• the application will connect to server, send a message and close the session

MaxSpeedBroadcaster

This sample demonstrates how to configure SimpleNewsBroadcaster sample for working with maximum throughput.

Structure:

• src\com\epam\example\SimpleNewsBroadcaster.java - source code
• base\runMaxSpeedBroadcaster.bat - running script
• etc\maxspeed
  • fixengine.properties - FIX Engine configuration, optimized for maximum performance
  • log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run a FIX server application (for example, SimpleServer)
• run the script base\runMaxSpeedBroadcaster.bat
• the application will connect to server, send a message and close the session

CustomProtocolBroadcaster

This sample demonstrates how to run SimpleNewsBroadcaster sample with customized FIX protocol.

Structure:

• src\com\epam\example\CustomNewsBroadcaster.java - source code
• base\runCustomProtocolBroadcaster.bat - running script
• etc\customdic
  • fixdic40.xml - customized dictionary (required tag 148 was added to News (B) message)
  • fixengine.properties - FIX Engine configuration, optimized for maximum performance
  • log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run a FIX server application (for example, SimpleServer)
• run the script base\runCustomProtocolBroadcaster.bat
• the application will connect to server, send a message and close the session

SimpleAdminClient

This sample demonstrates how to connect to an administrative session and communicate with it using the implementation of administrative messages.

Structure:

• src\com\epam\example\SimpleAdminClient.java - source code
• base\runSimpleAdminClient.bat - running script
• etc
  • fixengine.properties - FIX Engine configuration
  • log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixadminprotocol-api-N.N.N.jar
  • fixadminprotocol-impl-N.N.N.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run a FIX server application with enabled Administrative plugin (for example, SimpleServerWithAdminSession)
• run the script base\runSimpleAdminClient.bat
• the application will connect to server, subscribe for session list, receive an answer with session list on server and close the current session

SimpleServer

This sample demonstrates how to implement a FIX server with simple IP filtering of incoming sessions.

Structure:

• src\com\epam\example\SimpleServer.java - source code
• base\runSimpleServerWithAdminSession.bat - running script
• etc
  • fixengine.properties - FIX Engine configuration
  • log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script base\runSimpleServerWithAdminSession.bat
• FIX server will start at 3000 port. Press Enter key to finish the sample.

SimpleServerWithAdminSession

This sample demonstrates how to run SimpleServer sample with enabled Administrative plugin.

Structure:

• src\com\epam\example\SimpleServer.java - source code
• base\runSimpleServerWithAdminSession.bat - running script
• etc\adminsession
  • fixengine.properties - FIX Engine configuration with enabled Administrative plugin
  • log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixadminprotocol-api-N.N.N.jar
  • fixadminprotocol-impl-N.N.N.jar
  • fixaj-admin-N.N.N.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script base\runSimpleServerWithAdminSession.bat
• FIX server will start at 3000 port. Press Enter key to finish the sample.

SimpleServerWithCustomDic

This sample demonstrates how to run SimpleServer sample with customized FIX protocol.

Structure:

• src\com\epam\example\CustomNewsBroadcaster.java - source code
• base\runSimpleServerWithCustomDic.bat - running script
• etc\customdic
  • fixdic40.xml - customized dictionary (required tag 148 was added to News (B) message)
  • fixengine.properties - FIX Engine configuration, optimized for maximum performance
  • log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script base\runSimpleServerWithCustomDic.bat
• FIX server will start at 3000 port. Press Enter key to finish the sample.

Advanced FIXAJ Samples

CustomSessionLevelBroadcaster

This sample demonstrates how to run SimpleNewsBroadcaster sample with customized session level. Redefine handlers for Resend Request(2) and Reject(3) messages in its configuration.

Structure:

• src\com\epam\example\SimpleNewsBroadcaster.java - source code
• src\com\epam\custom\CustomResendRequestMessageHandler.java - custom handler for Resend Request(2) messages
• src\com\epam\custom\RejectMessageHandler.java - custom handler for Resend Reject(3) messages
• base\runCustomSessionLevelBroadcaster.bat - running script
• etc\customsessionlevel
  • fixengine.properties - FIX Engine configuration with redefined message handlers
  • log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run a FIX server application (for example, SimpleServer)
• run the script base\runCustomSessionLevelBroadcaster.bat
• the application will connect to server, send a message and close the session

CustomStorageBroadcaster

This sample demonstrates how to implement and configure a custom storage mechanism for incoming messages (outgoing messages will be stored in the default way). Customization is based on SimpleNewsBroadcaster sample.

Structure:

• src\com\epam\example\SimpleNewsBroadcaster.java - source code
• src\com\epam\custom\CustomStorageFactory.java.java - custom message handler factory
• base\runCustomStorageBroadcaster.bat - running script
• etc\customstorage
  • fixengine.properties - FIX Engine configuration with definition of new custom message factory
  • log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run a FIX server application (for example, SimpleServer)
• run the script base\runCustomStorageBroadcaster.bat
• the application will connect to server, send a message and close the session

SSL Samples

SingleMessageSSLClient

This sample demonstrates how to configure SimpleNewsBroadcaster sample for working with SSL connection.

Structure:

• src\com\epam\example\SimpleNewsBroadcaster.java - source code
• ssl\runSingleMessageSSLClient.bat - running script
• etc\ssl
  • fixengine.properties - FIX Engine configuration with enabled SSL support
  • generate.bat - script, which helps to generate a key pair (a public key and associated private key) and put them to keystorage
  • generate - Linux version of the abovementioned script
  • log4j.properties - logging configuration
  • mySrvKeystorage.key - keystorage with installed default key pair
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run a FIX server application with SSL support (for example, SimpleSSLServer)
• run the script ssl\runSingleMessageSSLClient.bat
• the application will connect to server, send a message and close the session

SimpleSSLNewsBroadcaster

A bit more complex than SingleMessageSSLClient sample with GUI elements. It demonstrates how to build the simplest GUI FIX client that can work under SSL.

Structure:

• src\com\epam\example\SimpleNewsBroadcaster.java - source code
• ssl\runSimpleSSLNewsBroadcaster.bat - running script
• etc\ssl
  • fixengine.properties - FIX Engine configuration with enabled SSL support
  • generate.bat - script, which helps to generate a key pair (a public key and associated private key) and put them to keystorage
  • generate - Linux version of the abovementioned script
  • log4j.properties - logging configuration
  • mySrvKeystorage.key - keystorage with installed default key pair
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run a FIX server application with SSL support (for example, SimpleSSLServer)
• run the script ssl\runSimpleSSLNewsBroadcaster.bat
• the application will start and display a dialog window.
• click the "Connect" button
• the application will establish a connection with server
• type any text message in text area and click the "Send" button
• News(B) message will be sent to server
• click the "Disconnect" button to close the connection

SimpleSSLServer

This sample demonstrates how to build the simplest SSL FIX server. The sample is based on SimpleServer sample.

Structure:

• src\com\epam\example\SimpleServer.java - source code
• ssl\runSimpleSSLServer.bat - running script
• etc\ssl
  • fixengine.properties - FIX Engine configuration with enabled SSL support
  • generate.bat - script, which helps to generate a key pair (a public key and associated private key) and put them to keystorage
  • generate - Linux version of the abovementioned script
  • log4j.properties - logging configuration
  • mySrvKeystorage.key - keystorage with installed default key pair
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script ssl\runSimpleSSLServer.bat
• FIX server will start at 3000 port. Press Enter key to finish the sample.

Validation Samples

SimpleValidator44

This sample demonstrates how to check a message for compliance with FIX 4.4 using FIX Antenna Validation module.

Structure:

• src\com\epam\example\validator\SimpleValidator44.java - source code
• validation\runSimpleValidator44.bat - running script
• data\message_for_validation44.fix - message for validation
• etc
  • fixengine.properties - FIX Engine configuration
  • log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • fixaj-validation-N.N.N.jar
  • fixaj-xml-N.N.N.jar
  • fixaj-xmlbeans-N.N.N.jar
  • fixprotocol-fix-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script validation\runSimpleValidator44.bat
• the application will validate a message and print the result to console

SimpleValidator50

This sample demonstrates how to check a message for compliance with FIX 5.0 using FIX Antenna Validation module.

Structure:

• src\com\epam\example\validator\SimpleValidator44.java - source code
• validation\runSimpleValidator50.bat - running script
• data\message_for_validation44.fix - message for validation
• etc
  • fixengine.properties - FIX Engine configuration
  • log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • fixaj-validation-N.N.N.jar
  • fixaj-xml-N.N.N.jar
  • fixaj-xmlbeans-N.N.N.jar
  • fixprotocol-fix-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script validation\runSimpleValidator50.bat
• the application will validate a hardcoded message and print the result to console

AdditionalValidationSample44

This sample demonstrates how to customize validation in case of using customized FIX protocol.

Structure:

• src\com\epam\example\validator\AdditionalValidationSample44.java - source code
• validation\runAdditionalValidationSample44.bat - running script
• data
  • additional.xml - extension for standard FIX 4.4 dictionary
  • message_for_validation44a.fix - message for validation
• etc
  • fixengine.properties - FIX Engine configuration
  • log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-full-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • fixaj-validation-N.N.N.jar
  • fixaj-xml-N.N.N.jar
  • fixaj-xmlbeans-N.N.N.jar
  • fixprotocol-fix-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script validation\runAdditionalValidationSample44.bat
• the application will validate a message and print the result to console

FIXML Samples

FIX2FIXML

This sample demonstrates a simple way of converting a string with FIX message into its FIXML representation.

Structure:

• src\com\epam\fixml\converter\examples\FIX2FIXML.java - source code
• bin\fix2fixml.bat - running script
• etc\log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-fixmlconverter-N.N.N-small.jar
  • fixaj-fixmlconverter-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

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

FIX2FIXMLWithCustomSerializer

This sample demonstrates how to convert a string with FIX message into its FIXML representation with custom XML processing.

Structure:

• src\com\epam\fixml\converter\examples\FIX2FIXMLWithCustomSerializer.java - source code
• bin\fix2fixmlWithCustomSerializer.bat - running script
• etc\log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-fixmlconverter-N.N.N-small.jar
  • fixaj-fixmlconverter-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar
  • xercesImpl-2.9.1.jar

How to run:

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

FIXML2FIX

This sample demonstrates a simple way of converting a string with FIXML message into its FIX representation.

Structure:

• src\com\epam\fixml\converter\examples\FIXML2FIX.java - source code
• bin\fixml2fix.bat - running script
• etc\log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-fixmlconverter-N.N.N-small.jar
  • fixaj-fixmlconverter-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

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

FIXML2FIXWithCustomParser

This sample demonstrates how to convert a string with FIXML message into its FIX representation with custom XML processing.

Structure:

• src\com\epam\fixml\converter\examples\FIXML2FIXWithCustomParser.java - source code
• bin\fixml2fixWithCustomParser.bat - running script
• etc\log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-fixmlconverter-N.N.N-small.jar
  • fixaj-fixmlconverter-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar
  • xercesImpl-2.9.1.jar

How to run:

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

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
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-fast-N.N.N-small.jar
  • fixaj-fastengine-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • fixaj-xml-N.N.N.jar
  • log4j-1.2.15.jar

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
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-fast-N.N.N-small.jar
  • fixaj-fastengine-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • fixaj-xml-N.N.N.jar
  • log4j-1.2.15.jar

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
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-fast-N.N.N-small.jar
  • fixaj-fastengine-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • fixaj-xml-N.N.N.jar
  • log4j-1.2.15.jar

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.

JMS Samples

FIXJMSAdpator

This sample demonstrates how to send and receive FIX messages via JMS Adaptor.

Structure:

• src\com\epam\example\jmsadaptor\FIXJMSAdaptorStarter.java - source code
• bin\runFIXJMSAdpator.bat - running script
• data\message.fix - fix message for sample
• etc
  • jms-adaptor.properties - configuration for JMS adapter
  • jndi.properties - configuration for ActiveMQ
  • log4j.properties - logging configuration
• lib
  • activemq-all-5.3.0.jar
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-jmsadaptor-N.N.N-small.jar
  • fixaj-jmsadaptor-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • jms-1.1.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• download and install Apache ActiveMQ as it is described on its site: http://activemq.apache.org/getting-started.html
• start ActiveMQ server
• run the script bin\runFIXJMSAdpator.bat
• the application starts, creates two queues (example.queueReceive for incoming messages and example.queueSend for outgoing messages) and sends a message to outgoing queue
• you can check if a message was sent by opening the ActiveMQ Web Console (by pointing your browser at http://localhost:8161/admin) or using any other tool for monitoring ActiveMQ server
• in case of ActiveMQ Web Console choose the "Queues" menu and make sure there are at least 2 queues on the list: example.queueReceive and example.queueSend. Click example.queueSend to make sure the queue contains at least one message
• Copy the sent message from outgoing queue to incoming queue. Click the message, select example.queueReceive queue in "Message Actions" section and click on the copy link
• the application will notify that a FIX message is received
• type Ctrl + C to close the application

FIXJMSAdvancedAdpator

This sample demonstrates how to send and receive FIX messages via JMS Adaptor. FIXJMSAdvancedAdaptor hides accessing to JMS queues from you and makes it easier to initialize an adaptor.

Structure:

• src\com\epam\example\jmsadaptor\FIXJMSAdvancedAdaptorStarter.java - source code
• bin\runFIXJMSAdvancedAdpator.bat - running script
• data\message.fix - fix message for sample
• etc
  • jms-adaptor.properties - configuration for JMS adapter
  • jndi.properties - configuration for ActiveMQ
  • log4j.properties - logging configuration
• lib
  • activemq-all-5.3.0.jar
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-jmsadaptor-N.N.N-small.jar
  • fixaj-jmsadaptor-examples-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • jms-1.1.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• download and install Apache ActiveMQ as it is described on its site: http://activemq.apache.org/getting-started.html
• start ActiveMQ server
• run the script bin\runFIXJMSAdvancedAdpator.bat
• the application starts, creates two queues (example.queueReceive for incoming messages and example.queueSend for outgoing messages) and sends a message to outgoing queue
• you can check if a message was sent by opening the ActiveMQ Web Console (by pointing your browser at http://localhost:8161/admin) or using any other tool for monitoring ActiveMQ server
• in case of ActiveMQ Web Console choose the "Queues" menu and make sure there are at least 2 queues on the list: example.queueReceive and example.queueSend. Click example.queueSend to make sure the queue contains at least one message
• Copy the message from outgoing queue to incoming queue. Click the message, select example.queueReceive queue in "Message Actions" section and click on the copy link
• the application will notify that a FIX message is received
• type Ctrl + C to close the application

Benchmarks

FIX Engine Benchmarks

Latency

This benchmark sample measure latancy for processing message inside FIX Engine. See more about measuring latency in corresponding section: Latency.

Structure:

• src\com\epam\benchmark\latency\
  • FIXTransportListener.java - interface for listener of transport events
  • MeasureInternalLatencyBM.java - main class with measurements
  • MeasureLatencyTransport.java - extendable transport, which can generate transport events
  • SimpleServer.java - simplest FIX server
  • TransportReplaceSessionFactory.java - customized transport factory
• runLatencyBM.bat - running script
• etc\benchmark\latency\fixengine.properties - configuration with a preset for getting minimum latency value
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-benchmarks-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

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 server and client parts and provide 100000 rounds of test. After some time it prints the measured maximum, minimum and average values to console. You can also find measurements of each round of test in the latency_result.csv file

Throughput

This benchmark sample allows to measure throughput (how many messages per second can be sent). See more about measuring throughput in the corresponding section: Throughput.

Structure:

• src\com\epam\benchmark\
  • throughput\SimpleServer.java - FIX server, which calculates throughput
  • throughput\ThroughputTester.java - client, which sends messages to server
  • Util.java - utilities for printing results
• runThroughputBM.bat - running script
• etc\benchmark\throughput\fixengine.properties - configuration with a preset for getting maximum performance
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-benchmarks-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script runThroughputBM.bat
• the application will start server and client parts and send 1000000 messages. After some time it prints the measured values to console.

Throughput With Nagle

This benchmark sample demonstrates throughput in case the transport enabled Nagle's algorithm.

Structure:

• src\com\epam\benchmark\
  • throughput\SimpleServer.java - FIX server, which calculates throughput
  • throughput\ThroughputTester.java - client, which sends messages to server
  • Util.java - utilities for printing results
• runNagleThroughputBM.bat - running script
• etc\benchmark\nagle-throughput\fixengine.properties - configuration with a preset for getting maximum performance and enabled Nagle's algorithm
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-benchmarks-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script runNagleThroughputBM.bat
• the application will start server and client parts and send 1000000 messages. After some time it prints the measured values to console.

Transaction

This benchmark sample measures how much time one transaction takes (sends a message and receives it). Messages are sent one by another.

Structure:

• src\com\epam\benchmark\
  • transactions\SimpleTransactionServer.java - FIX server, which sends received messages back
  • transactions\TransactionTester.java - client, which sends messages to server and measures the delay for each transaction
  • Util.java - utilities for printing results
• runTransactionBM.bat - running script
• etc\benchmark\transactions\fixengine.properties - configuration with a preset for getting maximum performance and enabled Nagle's algorithm
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-benchmarks-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script runTransactionBM.bat
• the application will start server and client parts and send 100000 messages. After some time it prints the measured values to console.

Transaction Sequence

This benchmark sample measures how much time one transaction takes (sends a message and receives it). Messages are sent only after receiving the answer from a previous one.

Structure:

• src\com\epam\benchmark\
  • transactions\SimpleTransactionServer.java - FIX server, which sends received messages back
  • transactions\TransactionSequensTester.java - client, which sends messages to server and measures the delay for each transaction
  • Util.java - utilities for printing results
• runTransactionSequenceBM.bat - running script
• etc\benchmark\transactions\fixengine.properties - configuration with a preset for getting maximum performance and enabled Nagle's algorithm
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-benchmarks-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script runTransactionSequenceBM.bat
• the application will start server and client parts and send 100000 messages. After some time it prints the measured values to console.

FIX Message Parsing

This benchmark sample measures different operations with a FIX message:

• get tag from FIX message
• set tag to FIX message
• get tag from repeating group, which is inside a FIX message
• parse simple FIX message from string
• parse complex FIX message from string

Structure:

• src\com\epam\benchmark\
  • parsing\ParsingTester.java - application that provides a set of parsing tests and prints results
  • Util.java - utilities for printing results
• runParsingBM.bat - running script
• etc\log4j.properties - logging configuration
• testdata\long_msg.fix - sample complex message to parse
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-benchmarks-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

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

Validation Benchmarks

Validation

This benchmark sample measures the time required to validate a complex message for compliance with FIX 4.4.

Structure:

• src\com\epam\benchmark\
  • validation\ValidationBenchmark.java - application that provides a set of parsing tests and prints results
  • Util.java - utilities for printing results
• runValidationBM.bat - running script
• etc\log4j.properties - logging configuration
• testdata\long_msg.fix - sample message to validate
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-engine-N.N.N-small.jar
  • fixaj-engine-benchmarks-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • fixaj-validation-N.N.N.jar
  • fixaj-xml-N.N.N.jar
  • fixaj-xmlbeans-N.N.N.jar
  • fixprotocol-fix-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script runValidationBM.bat
• the application will start and provide 10000 rounds of test and it print the measured values to console after some time.

FIXML Benchmarks

FIXML benchmarks have 2 tests. They are similar from the first sight and differ only in FIX version of used protocol. This is because FIXML convertor has 2 different implementations for FIX 4.1-4.3 and for later versions. Such behaviour is predicted by means of FIXML description. Earlier versions’ descriptions are different and the converter was adopted to work with both meta-descriptions.

FIXML 4.1 Converter

This benchmark sample measures the time FIX message conversion into FIXML and back. The benchmark uses FIX 4.1 messages.

Structure:

• src\com\epam\fixml\converter\benchmarks\
  • FIXML.java - generic code with a set of tests
  • FIXML41.java - source code which init tests for conversion of FIX 4.1 messages
• bin\fixml41.bat - running script
• etc\log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-fixmlconverter-N.N.N-small.jar
  • fixaj-fixmlconverter-benchmarks-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

• make sure your license file is correct and properly installed for running this sample (Application license installation.)
• run the script bin\fixml41.bat
• the application will start and provide 100000 rounds of test and after some time it prints measured values to console.

FIXML 4.4 Converter

This benchmark sample measures the time of FIX message conversion into FIXML and back. The benchmark uses FIX 4.4 messages.

Structure:

• src\com\epam\fixml\converter\benchmarks\
  • FIXML.java - generic code with a set of tests
  • FIXML44.java - source code with init tests for FIX 4.4 messages conversion
• bin\fixml44.bat - running script
• etc\log4j.properties - logging configuration
• lib
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-fixmlconverter-N.N.N-small.jar
  • fixaj-fixmlconverter-benchmarks-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • log4j-1.2.15.jar

How to run:

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

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
  • commons-logging-1.1.1.jar
  • fixaj-common-N.N.N.jar
  • fixaj-fast-N.N.N-small.jar
  • fixaj-fastengine-benchmarks-N.N.N.jar
  • fixaj-message-N.N.N.jar
  • fixaj-xml-N.N.N.jar
  • log4j-1.2.15.jar

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.

Uninstallation instructions

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