Sessions operations (for FIXEdge C++)

Sessions operations (for FIXEdge C++)

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

If for some reason FIXEdge can't complete this operation, FIXICC H2 displays an error form.

If the operation can't be finished, the session dynamic status won't be changed.

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

If for some reason FIXEdge can't complete this operation, the FIXICC H2 displays an error form.

If the operation can't be finished, the session dynamic status won't be changed.

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

If for some reason FIXEdge can't complete this operation, FIXICC H2 displays an error form.

If the operation can't be finished, the session dynamic status won't be changed.

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

If for some reason the FIXEdge can't complete this operation, then the FIXICC H2 displays an error form.

In this case, the operation can't be finished and the session dynamic status won't be changed.

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.

To cancel the operation at any point, click Cancel.

If FIXEdge can't complete this operation, the FIXICC H2 displays an error form.

If the operation can't be completed, the sequence numbers 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

If for some reason FIXEdge can't complete this operation, FIXICC H2 displays an error form.

If the operation can't be finished, the sequence numbers won't be changed.



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

If for some reason FIXEdge can't complete this operation, FIXICC H2 displays an error form.

If the operation can't be finished, the message won't be sent.

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)