FIX Client Simulator User Guide
- 1 Product Overview
- 2 FIX Client Simulator features
- 3 Prerequisites and System Requirements
- 4 Configuration
- 5 FIX Session creation
- 5.1 Session parameters
- 5.1.1 Required parameters
- 5.1.2 Extended parameters
- 5.1.3 BackupConnectionParameters
- 5.1.4 SSL configuration
- 5.1 Session parameters
- 6 Kafka Session creation
- 6.1 Kafka session parameters
- 6.1.1 Main parameters
- 6.1.2 Authentication parameters
- 6.1.3 SSL parameters
- 6.1 Kafka session parameters
- 7 Multiline session display
- 8 Manual sequence numbers definition and reset
- 9 Display administrative messages in the console
- 10 Sending messages
- 11 Message re-sending
- 12 Sending selected messages
- 13 Sending messages one by one
- 14 Autoincrement tag values
- 15 Replay log
- 16 Events monitoring
- 17 Grid view
- 18 Detailed message view from Events Viewer
- 19 Searching for a raw message
- 20 Writing messages
- 21 Loading predefined message or message batch
- 22 Create messages from the template
- 23 Generate messages
- 24 Adding custom dictionaries
- 25 Table view
- 26 Create and run test scenarios
- 26.1 Create test scenario manually
- 26.2 Referring on repeating group without concrete index
- 26.3 Managing the balance of quantities for the FIX message
- 26.4 Setting up delay property for separate messages in ExpectThenSend command
- 26.5 Record test scenario automatically
- 26.6 Edit test scenario
- 26.7 Rename test scenario
- 26.8 Remove test scenario
- 27 Save session configuration
- 28 Closing session
- 29 Restore session logs
- 30 Troubleshooting
Product Overview
EPAM B2BITS FIX Client Simulator (FCS) is a rich desktop UI application. It allows to simulate multiple FIX protocol-defined buy-side- and sell-side-oriented workflows and create repeatable test scenarios for FIX sessions. FCS combines the ability to generate, manually enter, and edit FIX messages in row format and via pre-defined forms. It allows to assemble and replay FIX messages in a highly automated fashion with automatic handling of sequence numbers and identities.
FCS is used in the following use cases:
OMS/EMS functional and stress testing
Automated FIX integration testing
FIX protocol implementations
Errors reproducing
FCS covers all spectrum of FIX protocol versions and supports custom extensions and QuickFIX-formatted dictionaries.
FIX Client Simulator features
Establishing multiple acceptor and/or initiator sessions on local and/or remote hosts
Support of unregistered acceptor sessions
Restarting the working session with or without session logs restoration
Restoring session state and configurations on FCS startup
Support of all FIX message types (pre-trade, trade, post-trade, market data, etc.)
Standard 4.0 - FIXLatest FIX application versions support
Custom dictionaries support
Overriding SenderCompID and TargetCompID for the established session
Manual sequence numbers definition or reset
Validation of incoming and outgoing FIX and QuickFIX messages
Wide range of FIX session settings including Custom Logon message
Replaying selected log files
Ability to load, modify, and send a file containing a preset message or batch of messages
Enabling/disabling message re-sending
Sending messages in a defined interval
Tag values autoincrement
Events monitoring:
sent and received messages
session states
Creating, recording, editing, and running test scenarios for FIX sessions
Prerequisites and System Requirements
FIX Client Simulator is based on FIX Antenna C/C++/.NET FIX Engine. It can be installed separately or as a part of the FIX Antenna .NET package.
Any modern Intel-based server or workstation with a 64-bit CPU can be used as hardware.
Supported operating systems:
Windows 7
Windows 8
Windows 10
Windows 11
Windows Server 2008 R2
Windows Server 2012
Windows Server 2016
Ubuntu Linux 20.04
Ubuntu Linux 22.04
Rocky Linux 8
macOS
(For Windows users only) Latest (14.42.34438.0) Microsoft Visual C++ Redistributable Package (x64) should be installed before the FIX Client Simulator's installation.
(For Linux and macOS users only) Download and install Wine from the official site to run the FIX Client Simulator.
Installation on Linux Mint and Ubuntu
FCS has been available on Linux since the FIX Client Simulator 3.5.0 release.
To install FIX Client Simulator on Linux Mint and Ubuntu follow the instructions below:
Install Wine (instruction for Ubuntu and Mint).
Install Winetricks using the following commands:
sudo apt install winetricksInstall .NET Framework 4.8 using the following commands:
winetricks --force dotnet48 winetricks --force corefontsIf Wine prompts for installing Mono, click Cancel. Please refer to the HowTo section for more details.
Navigate to the FCS folder and run it.
cd ./FCS_<version> wine Fcs.exe
Installation on macOS
FCS has been available on macOS since the FIX Client Simulator 3.5.0 release.
To install FIX Client Simulator on macOS follow the instructions below:
Install Wine
Option 1 - Download and install Wine from the official site
Option 2 - Download and install Wine using Brew
brew install --cask wine-stable
Navigate to the FCS folder and run it.
Option 1 - via Terminal
cd ./FCS_<version> wine Fcs.exeOption 2 - via context menu