Transport Adapter Session Configuration

TA Session attributes can be divided into three groups:

• Static configuration

• Dynamic state

• Dynamic attributes

To create a new TA Session configuration, define the static attributes such as:

• Identification parameters

• Specific Parameters of the Producer and Consumer Sessions

• Others

The parameters of static configuration define the initial parameters for the dynamic parameters. The static configuration can be changed when the current TA Session is not connected. The parameters of the static configuration can be modified at any time. If the Session is connected, the changes are stored in the database and only the latest changes are applied when the Session becomes disconnected.

A dynamic state exists only when the TA Session is connected. FIXICC H2 handles the events which are happened during the endpoint's life cycle. These events come from the FIXEdge Java Server. For the dynamic state, the sequence of events is important for tracking.

Dynamic attributes also exist only when the TA Session is connected. FIXICC H2 checks the state of these attributes in a configured time interval. The set of metrics depends on the type of FIXEdge Server. For the dynamic attributes, the snapshot at the moment is important.

Static Session Configuration

Adding a New TA Session Configuration from Scratch

1. Select a Server to add a new TA Session configuration to.

   Open

   

   
   Figure. Selecting the Server from the list.
   
   

2. Go from the Servers page to the New TA Session page by:

   • Clicking the Server Name in the navigation menu (item 1)→ Transport Adapters under the selected Server Name (item 2) → TA Name under the Server Name (item) → Add button in the opened TA Sessions page (item 4).

3. Press Add button on the Server TA Sessions page.

4. Choose the new TA session role from the Add drop-down menu:

   • The Producer TA Session is responsible for sending data streams (to the Kafka cluster for Kafka TA or to the JMS queue or topic for JMS TA, etc.). There is a set of parameters for Producer TA Sessions.

   • The Consumer TA Session is responsible for reading data streams (from the Kafka cluster for Kafka TA or from the JMS queue or topic for JMS TA, etc.). There is a set of parameters for Acceptor Sessions.

5. OR select the TA Session role from the context menu on the Server TA Sessions page.

6. When you select a new TA session role, FIXICC H2 opens the New TA Session page.

Create a Consumer TA Session

To create a new Consumer TA Session:

1. Select Consumer from the Add drop-down menu or the Create Consumer Session option from the context menu on the Server TA Sessions page.

2. FIXICC H2 opens the New TA session page for a new Consumer TA Session.

   Open

   

   
   Figure. Consumer Session parameters.

The properties highlighted in red are mandatory.

Create a Producer TA Session

To create a new Producer TA Session:

1. Select Producer from the Add drop-down menu or the Create Producer Session option from the context menu on the Server TA Sessions page.

2. FIXICC H2 opens the New TA Session page for a new Producer TA Session.

You can see the parameters in the figure below.

Open

Figure. Producer Session parameters.

The properties highlighted in red are mandatory.

Complete adding a new TA Session configuration

1. Define the mandatory connection parameters highlighted in red in the figure above. Each Transport Adapter has a unique list of mandatory properties. You can find the full list of TA parameters and their descriptions on the FIXEdge Java: Configuring connectivity page.

2. After specifying all the details, you have the following options:

   • Save the new TA Session configuration by clicking OK.

   • If all mandatory parameters are specified and the identification parameter values (i.e. Client Name) are unique, then a new TA Session is added to the selected Server and FIXICC H2 displays the sessions table including the new TA Session configuration on the Server TA Sessions page.

If the identification parameters values (i.e. Client Name) are not unique, FIXICC H2 displays the error form with the message 'Transport Adapter Session <TA Session Name> already exists'.

When you click the X button, FIXICC H2 displays the New TA Session page again to change the value of the parameter.

If mandatory parameters aren't specified, FIXICC H2 displays the alert form:

Open

After the alert form is hidden, FIXICC H2 displays the New TA Session page again to fill in the mandatory parameters.

• Cancel the TA Session adding by clicking the Cancel button. Then FIXICC H2 displays the TA sessions table without changes.

• Leave the page. If you edited the TA session parameters, FIXICC H2 displays the following warning form:

  Open

  

   

FIXICC H2 offers the following options:

• Save the entered values as a new TA Session configuration.
  Then a new TA Session is added to the selected Server and FIXICC H2 displays the TA sessions table on the Server TA Sessions page, including the new TA Session configuration.

• Skip the changes by clicking Don't save.
  The new TA Session configuration won't be added. FIXICC H2 displays the TA sessions table on the Server TA Sessions page without changes.

• Stay on the New TA Session page by clicking Cancel. FIXICC H2 displays the New TA Session page to continue editing.