Configuring the iWay Integration Solution for FIX Components

In this section:

The iWay Integration Solution for FIX consists of standard iWay Service Manager components that are used to run a FIX message.

The following table lists and describes the iWay Integration Solution for FIX components.

iWay Integration Solution for FIX Component

Description

iWay FIX Preemitter

Converts a FIXML file to a FIX format.

iWay FIX Preparser

Converts a FIX format file to XML. The trailer and header are automatically created by the preparser through the B2Bits Engine.

iWay FIX Listener

Listener that listens for an incoming message from the FIX Engine.

iWay FIX Emitter

Emits a FIX format message to the FIX Engine.

iWay FIX Emit Service

Emits a FIX format message to the FIX engine. This component will function exactly like the FIX Emitter, but it can also be implemented into an iWay process flow. The service takes either XML or bytes. If messages are sent in XML format, the service assumes that the format is FIXML and converts it to FIX format.

The following sections describe how to configure each component.



x
iWay FIX Preemitter Configuration

This section describes how to configure the iWay FIX Preemitter.



x
Procedure: How to Configure iWay FIX Preemitter

To configure the iWay FIX Preemitter:

  1. In the iWay Service Manager Administration Console, click Registry from the menu bar, and then under Components in the left pane, select Preemitters.
  2. Click Add to add a new preemitter.
  3. From the Type drop-down list, select FIXML Preemitter and click Next, as shown in the following image.

  4. From the FIX Version drop-down list, select a FIX version and click Next, as shown in the following image.

  5. Provide a name and description for the Preemitter and click Finish to complete the Preemitter Wizard.

    The new FIX Preemitter is available on the Preemitters screen, as shown in the following image.


Top of page

x
iWay FIX Preparser Configuration

This section describes how to configure the iWay FIX Preparser.



x
Procedure: How to Configure iWay FIX Preparser

To configure the iWay FIX Preparser:

  1. In the iWay Service Manager Administration Console, click Registry from the menu bar, and then under Components in the left pane, select Preparsers.
  2. Click on Add to add a new Preparser.
  3. From the Type drop-down list, select FIXML Preparser and click Next as shown in the following image.

  4. From the FIX Version drop-down list, select a FIX version and click Next, as shown in the following image.

  5. Provide a name and description for the Preparser and click Finish to complete the Preparser Wizard, as shown in the following image.

    The new FIX Preparser is available on the Preparsers screen, shown below.


Top of page

x
iWay FIX Listener Configuration

This section describes how to configure the iWay FIX Listener.

The iWay Service Manager listener is just an end point connected to the FIX Engine Provider, configured previously, which is the session initiator. A single Provider can have any number (including 0) of listeners connected to it. When a Provider receives a message it forwards that message to all the listeners that are connected to it. Stopping a listener when deployed and active would unsubscribe the listener from the Engine. The underlying FIX session is still active. In addition, there can be two functions of the listener based on how the listener is configured. The first is a standard FIX listener and the second is a rejected message listener. The rejected message listener listens for messages from the FIX engine that are rejected or not valid. This is a convenient option for error handling.



x
Procedure: How to Configure iWay FIX Listener

To configure the iWay FIX Listener:

  1. In the iWay Service Manager Administration Console, click Registry from the menu bar, and under Components in the left pane, select Listeners.
  2. Click Add to add a new Listener.
  3. Select FIX from the Type drop-down list and click Next, as shown in the following image.

    The configuration parameters for the FIX listener are displayed, as shown in the following image.

    Enter the name of the FIX Engine Provider

  4. Enter the name of the FIX Engine Provider created above, and click Next, as shown in the following image.
  5. Provide a name and description for the Listener, and click Finish to complete the Listener Wizard, as shown in the following image.

  6. To create the listener for rejected messages, follow steps 1 to 5. However, select True for the rejected messages option.

Top of page

x
iWay FIX Emitter Configuration

The iWay FIX solution provides the following components to use in order to emit a FIX message:

The section below provides configuration details for both types of emitters. Note that if the FIX Emit Service is being used, a preemitter is not required.



x
Procedure: How to Configure the iWay FIX Emitter

To configure the iWay FIX Emitter:

  1. In the iWay Service Manager Administration Console, click Registry from the menu bar, and under Components in the left pane, select Emitters.
  2. Click Add to add a new Emitter.
  3. Select FIX from the Type drop-down list and click Next as shown in the following image.

  4. Enter a name of the FIX Engine Provider created above, select a Send method from the drop-down list, and click Next, as shown in the following image.

    The following table lists and describes the selections that are available in the Send method drop-down list.

    Send Method Name

    Description

    No Change

    The message is sent using the B2Bits sendMessage method. Depending on implementation and configuration, it may send a message immediately or put it in the outgoing queue either persistent or stateless.

    The Engine updates the footer and header in the message

    ADD_SMH_AND_SMT

    The FIX Engine will add a new header and trailer to the message before sending.

    DELETE_AND_ADD_SMH_AND_SMT

    The FIX Engine will remove the tags of the header and trailer, and then will add the correct tags before sending.

    UPDATE_SMH_AND_SMT

    The FIX Engine will update header and trailer tags before sending.

    UPDATE_SMH_AND_SMT_DONOT_UPDATE_SNDR

    The same as UPDATE_SMH_AND_SMT, but it leaves without changes to the SenderCompID tag. For example, this specific case is useful for CME iLink.

  5. Provide a name and description for the Emitter and click Finish to complete the Emitter Wizard, as shown in the following image.



x
Procedure: How to Configure the iWay FIX Emit Service

To configure the iWay FIX Emit Service:

  1. In the iWay Service Manager Administration Console, click Registry from the menu bar, and then under Components in the left pane, select Services.
  2. Click Add to add a new service.
  3. From the drop-down list, select FixEmitAgent and click Next.
  4. Configure the iWay FIX Emit Service and click Finish, as shown in the following image.

    The iWay FIX Emit Service can be used to create a channel that reads an XML file, routes it to this service, then sends the service output to a file.


iWay Software