Sessions operations

Session operations are available from the Session Dynamic State page.

To go to the Session Dynamic State page, you should:

1. Select the server from the Servers page (items 1→ 2→3 in the figure below)
2. Select the session from the Server Sessions page (items 4 or 5→6 in the figure below)

Figure. The Servers page.

1. To open the Session Dynamic State page in a single tab, choose one of the following options:
   • Click View on the top panel
   • Select View in the context menu
   • Double-click the session
   • Press Enter on the keyboard

The set of available operations depends on the dynamic session status.

Start a session

To start a configured session:

1. Make sure the session is in one of the following statuses:
   • 
   • 
2. Click Start
   • In the Object info part (see below)
     
   • Figure. Start the session from the Object info layout part.
     or
   • In the Session Dynamic State page (see below)
   • Figure. Start the session from the Session Dynamic State page.
     
3. The FIXICC H2 displays the following confirmation form:
   
   Figure. Confirm the session starting.
   
   
4. Optional. To reset sequence numbers, select the Reset sequence numbers checkbox. 
   The sequence numbers are assigned with initial values of the incoming and outgoing sequence numbers from the session configuration.
5. To finish:
   • Click OK to complete the operation
     or
   • Click Cancel to cancel the operation

System response

The system reacts differently depending upon whether an initiator session or an acceptor session was started.

• An initiator session:
  1. Sends a Logon message
  2. Waits for the confirming Logon message
  3. Changes the current dynamic status to "Connecting". The color indicator turns yellow.
  4. Receives the confirming Logon message
  5. Changes the current dynamic status to "Running". The color indicator turns green.

• An acceptor session:
  1. Waits for a Logon message
  2. Changes the current dynamic status to "Connecting". The color indicator turns yellow.
  3. Receives the Logon message from the initiator session
  4. Sends the confirming Logon message
  5. Changes the current dynamic status into "Running". The color indicator turns green.

Stop the session

To stop a started session:

1. Make sure the session is in one of the following statuses:
   • 
   • 
   • 
   • 
2. Click the Stop drop-down menu
   
   • In the Object info layout (see below)
     
   • Figure. Stop the session/ stop the session with logout from the Object info layout part.
     or
     
   • In the Session Dynamic State page (see below)
     
   • Figure. Stop the session/ stop the session with logout from the Session Dynamic State page.
     
     
3. In the drop-down menu, you can select either of the following options:
   • Stop
     1. FIXICC H2 displays the "Confirm the session stopping" form
        
        Figure. Confirmation form for the stop operation.
        
     2. Click OK to confirm the operation or Cancel to cancel the operation
   • Stop with logout
     1. FIXICC H2 displays the "Confirm the session stopping with logout" form
        • 
          Figure. Confirmation form for the stop with logout operation
          
     2. Enter the logout reason in the Logout reason field. Tag 58 in the logout message will contain the entered reason.
        • If you leave the field empty, tag 58 in the logout message will contain the default line "Manual termination"
     3. Click OK to confirm the operation or Cancel to cancel the operation

System response

• If Stop is selected:
  1. FIXEdge shuts the connection down
  2. The session changes the current dynamic status to "Disconnected"
  3. The color indicator on FIXICC H2 turns red
• If Stop with logout is selected:
  1. The session sends the Logout message
  2. The session waits for the response on the logout message
  3. The session changes the current dynamic status to "Disconnected"
  4. The color indicator on FIXICC H2 is red

Restart session

The restart operation consists of several operations:

1. The running session is:
   1. Stopped
   2. Disconnected
   3. Removed from FIX Antenna Cpp
2. The planned session starts

You can restart the running session with and without sending a logout message.

To restart a session:

1. Make sure it's in one of the following statuses:
   • 
   • 
   • 
   • 
   • 
   • 
2. In the additional drop-down menu, you can find the Restart and Restart with logout operations
   • In the Object info layout part (see below)
     
   • Figure. Restart the session/ restart the session with logout from the Object info layout part.
     or
   • In the Session Dynamic State page
     
   • Figure. Restart the session/ restart the session with logout from the Session Dynamic State page.
     
     
3. From there, you can:
   • Click Restart session to restart the session without sending a logout message
     
     1. Then the FIXICC H2 displays the "Confirm the session restarting" form
        
        Figure. Confirmation form for the restart operation.
     2. Click OK to confirm the operation or click Cancel to cancel the operation
   • Click Restart with logout to restart the session and send the logout message
     
     1. Then the FIXICC H2 displays the "Confirm the session restarting with logout" form
        
        • Figure. Confirmation form for the restart with logout operation.
          
     2. Enter the logout reason in the Logout reason field. Tag 58 in the logout message will contain the entered reason.
        • If you leave the field empty, tag 58 in the logout message will contain the default line "Manual termination"
     3. Optional. To reset sequence numbers, select the Reset sequence numbers checkbox. 
        The sequence numbers are assigned with initial values of the incoming and outgoing sequence numbers from the session configuration.
     4. Click OK to confirm the operation or Cancel to cancel the operation

Session response

• If Restart is selected:
  1. FIXEdge shuts the connection down
  2. The session changes the current dynamic status to "Disconnected"
  3. The color indicator on FIXICC H2 turns red
  4. FIXEdge removes the session from FIX Antenna
  5. The session changes the current dynamic status to "Planned"
  6. The color indicator on FIXICC H2 turns black

• If Restart with logout is selected:
  1. The session sends the Logout message
  2. The session waits for the response on the logout message
  3. The session changes the current dynamic status to "Disconnected"
  4. The color indicator turns red
  5. FIXEdge removes the session from FIX Antenna
  6. The session changes the current dynamic status to "Planned"
  7. The color indicator on FIXICC H2 turns black

When the stop operation is finished, FIXEdge starts the planned session. The stopped session responds to the start operation differently depending on whether an initiator session or acceptor session is being started.

An initiator session:

1. Sends the Logon message
2. Waits for the confirming Logon message
3. Changes the current dynamic status to "Connecting"
4. The color indicator on FIXICC H2 turns yellow
5. The initiator session receives the confirming Logon message
6. Changes the current dynamic status to "Running"
7. The color indicator on FIXICC H2 turns green
   • Note: If the initiator is reconnected to the backup acceptor, the color indicator turns blue. For more information please follow the Switch to Primary/Backup

An acceptor session:

1. Waits for the Logon message
2. Changes the current dynamic status to "Connecting"
3. The color indicator on FIXICC H2 turns yellow
4. The acceptor session receives the Logon message
5. Sends the confirming Logon message
6. Changes the current dynamic status to "Running"
7. The color indicator on FIXICC H2 turns green

Sequence numbers operations

You have access to the operation with the current sequence numbers of the session.

The Seq Num drop-down menu is available for the session in the following statuses:

Changing sequence numbers

To change the current incoming or outgoing sequence numbers:

1. Make sure the session is in one of the following statuses:  or 
2. Select Change Seq Num from the Seq Num drop-down menu from either:
   • The Object info layout part (shown below)
     
     Figure. Change sequence numbers from the Object info layout part.
     
     
   • The Session Dynamic State page (shown below)
     
     Figure. Change sequence numbers from the Session Dynamic State page.
     
     
3. The FIXICC H2 displays the Change sequence numbers form to enter the new sequence numbers.
   You can see actual incoming and outgoing sequence numbers in the parentheses near the input fields.
   
   Figure. The Change Sequence Numbers form.
   
   Please note the following information before completing the operation:
   • You can change one (either incoming or outgoing) or both sequence numbers using this form. 
     • At least one field should be filled to complete the operation.
     • If both fields are empty, the FIXICC H2 displays an alert message.
   • Use zero or positive integer values
     
     • If you use a negative or non-integer value, the FIXICC H2 displays an alert message.
   • If you use a number smaller than the actual one (displayed inside the parentheses), some messages might be missed.
     To avoid this, use a positive integer larger than the actual sequence number.
     
     
4. Once you've entered your desired value, click OK to complete the operation.
   The FIXICC H2 then sends the new sequence number value(s) to FIXEdge for the current session.
   • If the field is empty, the corresponding sequence number won't be changed.

Resetting sequence numbers

This operation specifies the current incoming and outgoing sequence numbers with the initial values from the session configuration.

To reset the current sequence numbers of the session:

1. Make sure the session is in one of the following statuses:
   • 
   • 
   • 
   • 
2. Select Reset Seq Num from the Seq Num drop-down menu
   
   • In the Object info layout part (see below)
     
   • Figure. Reset sequence numbers from the Object info layout part.
     or
     
   • The Session Dynamic State page (see below)
     
   • Figure. Reset sequence numbers from the Session Dynamic State page.
     
     
3. The FIXICC H2 displays the following confirmation form
   
   Figure. The "Confirm reset sequence numbers" form.
   
   
4. Click OK to confirm the operation or click Cancel to cancel the operation

Send operations

You have the ability to send FIX messages to a configured session with the following statuses:

Sending a heartbeat message

To send a heartbeat message to a session:

1. Make sure the session is in one of the following statuses:
   • 
   • 
2. Select Heartbeat from the Send drop-down menu in either:
   • The Object info layout part (see below)
   • 
   • Figure. Send heartbeat from the Object info layout part.
     or
     
   • The Session Dynamic State page (see below)
   • 
   • Figure. Send heartbeat from the Session Dynamic State page.
3. The following form appears:
   • 
   • Figure. The "Confirm the heartbeat sending" form.
4. Finish the operation by selecting:
   • OK to confirm the heartbeat sending operation
   • Cancel to cancel the operation

Sending an arbitrary message

To send an arbitrary FIX message to a session:

1. Make sure the session displays one of the following statuses:
   • 
   • 
   • 
2. Select Arbitrary message from the Send drop-down menu
   • In the Object info part (see below)
     
   • Figure. Send an arbitrary message from the Object info layout part.
     or
   • The Session Dynamic State page (see below)
     
   • Figure. Send an arbitrary message from the Session Dynamic State page.
     
     
3. The FIXICC H2 displays the "Send arbitrary message" form
   
   Figure. The "Send arbitrary message" form.
   
   
4. In the message field, you can:
   • Type the arbitrary FIX message
   • Paste the FIX message from the clipboard
   • Click Load message to load the FIX message from a file
   • Click SOH or press Ctrl+Space on your keyboard to insert the SOH delimiter
     • Note: The arbitrary message field must be filled to complete the sending operation. An empty message can't be sent.
       
       
5. Click OK to confirm the operation or click Cancel to cancel the operation

Sending a test request

To send a test request FIX message to a session:

1. Make sure the session displays one of the following statuses:
   • 
   • 
2. Select Test request from the Send drop-down menu in either:
   
   • The Object info layout part (see below)
     •  
     • Figure. Send a test request from the Object info layout part.
   • or
   • The Session Dynamic State page (see below)
     •  
     • Figure. Send a test request from the Session Dynamic State page.
3. FIXICC H2 displays the following form:
   • 
   • Figure. The "Send test request" form.
4. In the Test request ID field, you can:
   • Use the default ID (current date and time)
   • Change the ID by typing in the field
   • Paste from the clipboard
5. To finish the operation:
   • Select OK to confirm the operation
     Note: The Test request ID field must be filled to send the test request. The request cannot be sent without an ID.
     or
     
   • Select Cancel to cancel the operation

Sending a resend request

To send a resend request FIX message to a session:

1. Make sure the session displays one of the following statuses:
   • 
   • 
2. Select Resend request from the Send drop-down menu in either:
   
   • The Object info layout part (see below)
     • 
     • Figure. Send a resend request from the Object info layout part.
   • or
   • The Session Dynamic State page (see below)
     • 
     • Figure. Send a resend request from the Session Dynamic State page.
3. FIXICC H2 displays the following form:
   • 
   • Figure. The "Resend request" form.
     
     
4. In the Resend sequence section, you can:
   • Use the default values (all the sequence numbers of messages that have already been sent are resent from the counterparty)

   • Enter the numbers of the first and last messages to resend by typing into the fields or pasting from the clipboard
     Note:

     • Use a positive integer value in the Sequence number of the first message field

     • Use zero or a positive integer value in the Sequence number of the last message field
     • Using zero in the Sequence number of the last message field resends the sequence of messages starting with the value in the Sequence number of the first message field until the last sent message
     • The value in the Sequence number of the last message field should be greater than or equal to the value in the Sequence number of the first message field

     • If both fields contain the same value, only one message is resent from the counterparty

     • Both fields must be filled to set the sequence

       
       

5. To finish the operation:
   • Select OK to confirm the operation
   • Select Cancel to cancel the operation

Switch to Primary/Backup

The Switch to Backup/Switch to Primary operations are only enabled for initiator sessions.

These operations are not included in the additional drop-down menu for acceptor sessions.

In the initiator session configuration, you can set the mandatory parameters Backup Host and Backup Port for setting the backup connection in the Connection settings > Extended section.

Switching to backup

To switch the initiator session that is connected to the acceptor session located in the primary server:

1. Make sure the session status corresponds to one of the following statuses:
   
   • 
   • 
   • 
   • 
2. Click Switch to Backup in the additional drop-down menu in either:
   • The Object info layout part (see below)Figure. Switch to backup from the Object info layout part.
     or
     
   • The Session Dynamic State page (see below)
     
   • Figure. Switch to backup from the Session Dynamic State page.
     
     
3. The FIXICC H2 displays the following confirmation form:
   
   Figure. The "Confirm the session connection to backup" form.
   
   
4. Click OK to accept the reconnection or click Cancel to cancel the operation
   • If you accept the reconnection, FIXICC H2 sends the request for switching the connection of the initiator session to the acceptor session in the backup server to FIXEdge
   • If the connection is established, the initiator session status is changed into 

Switching to primary

To switch the initiator session that is connected to the acceptor session configured for the backup server:

1. Make sure the session status corresponds to one of the following statuses:
   • 
   • 
   • 
   • 
2. Click Switch to Primary in the additional drop-down menu in either
   • The Object info layout part (see below)
     
   • Figure. Switch to primary from the Object info layout part.
     or
   • The Session Dynamic State page (see below)
     
   • Figure. Switch to primary from the Session Dynamic State page.
     
     
3. Then the FIXICC H2 displays the following confirmation form:
   
   Figure. The "Confirm the session connection to primary" form.
   
   
4. Click OK to accept the reconnection or click Cancel to cancel the operation
   • If you accept the reconnection, FIXICC H2 sends the request for switching the connection of the initiator session to the acceptor session in the primary server to FIXEdge
   • If the connection is established, the initiator session status is changed to 

Show session notifications

To see the list of the selected session notifications:

1. Make sure the session is in one of the following statuses:
   • 
   • 
   • 
   • 
   • 
   • 
   • 
2. Click Show session notifications in the additional menu in either
   • The Object info layout part (see below)
     
   • Figure. Show session notifications from the Object info layout part.
     or
     
   • The Session Dynamic State page (see below)
     
   • Figure. The Show session notifications option.
     
     
3. Then FIXICC H2 opens the Notifications page (see below). Note that:
   • The Object field is empty and disabled
   • The Event Source field is filled with the session name and disabled
   • By default, the notifications list is filtered by the current session name

   • Using the Default Filter, you can filter session notifications by date
     

      See the instructions

     The Default Filter depends on the type of objects that are shown on the current page.

     To use the Default Filter, type or select a value in the Default Filter fields.
     To start a search, move the focus from the completed field or press Enter.
     To reset the search results:

     • Click Clear (item 1 in the figure below)
       
       Figure. Default Filter.
       
       
     • Or click Clear in the context menu (as shown below)
       
       Figure. The Clear context menu item.

     Then you can see a full list of rows.

   • The Extended Filter is available on the page
     

      See the instructions

     The Extended Filter allows adding custom search conditions.

     To add a new search condition:

     1. Click Add search condition (item 1 in the figure below)
        
        Figure. The Extended Filter.
        
        
     2. To specify the parameter you want to search for in the "Add condition" form, either:
        • Select it from the list
          or
        • Type the parameter name in the Filter field
          
          Figure. The "Add condition" form.
     3. To confirm your choice, click Select or to cancel the operation, click Cancel
     4. Select an operation type from the drop-down list according to the parameter type 
        
        Figure. The operations list.

     To start a search:

     Click Refresh (item 1 in the figure below)
     
     Figure. The Refresh button.

     To remove a filter condition:

     Click x to see the full list of objects
     
     Figure. The removing condition symbol.

     To reset search results:

     • Select the <Reset Filter> from the drop-down menu in the Refresh button
       
       Figure. Reset Filter operation.
       
       
     • Or click Clear in the context menu 
       
       Figure. The Clear context menu item.

     To save a filter:

     1. When you add a list of conditions, click the   button and select the save option
     2. Add the mandatory information to save the filter
     3. Click OK to confirm the changes or click Cancel to cancel the operation

     
     Figure. The Notifications page filtered by session name.