/
Session operations

Session operations

Apr 25, 2023

Session operations

Session operations are available on the Session Dynamic State page.

To pass 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 in the figure below)


Figure. The Servers page.

Now you can open the session in view mode by:

  • Selecting View in the top panel

  • Selecting View in the context menu

  • Double-clicking a given row

  • Pressing Enter

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

Start a session

The Start operation is available for sessions with the following status:

To start a session:

  1. Click Start in either:

    • The Object Info layout part (see below)

    •  

      • Figure. Starting the session from the Object info layout part. 

 

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

If the operation can't be finished, the session's 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 a session

You have the ability to stop a started session.

The Stop operation is available for sessions with the following statuses:

To stop a session:

  1. Click Stop in either:

    • The Object Info layout part (see below)

    • Figure. Stop the session/ stop session with logout from the Object info layout part.

 

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's dynamic status won't be changed.

System response

The system response to the stop operation is as follows:

  • If Stop is selected, FIXICC H2 shuts the connection down and the session changes its current dynamic status to "Disconnected". The color indicator turns red.

  • If Stop with logout option is selected, the session sends the Logout message, waits for a response on the logout message, and the session changes the current dynamic status to "Disconnected" upon receiving the response. The color indicator then turns red.

Restart a session

The restart operation consists of two operations: the stop operation of the running session and then the start operation of the disconnected session.

You have the ability to restart a running session with and without sending a logout message.

The restart operation is available for sessions with the following statuses:

То restart a session:

  1. Locate the Restart and Restart with logout operations in the additional drop-down menu

    • See below for the location of the additional drop-down menu in the Object Info layout part:


Figure. Restart the session/ restart the session with logout from the Object info layout part.

Session response

  • If Restart session is selected:

    1. FIXICC H2 shuts the connection down

    2. the session changes the current dynamic status to "Disconnected"

    3. The color indicator turns red

  • 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. Upon receiving the response, the session changes the current dynamic status to "Disconnected"

    4. The color indicator turns red

When the stop operation is finished, FIXICC H2 starts the stopped 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 a Logon message

  2. Waits for the confirming Logon message

  3. Changes the current dynamic status to "Connecting"

  4. The color indicator turns yellow

  5. Receives the confirming Logon message

  6. Changes the current dynamic status to "Running"

  7. The color indicator turns green
    Note: If the initiator is reconnected to the backup acceptor, the color indicator turns blue. For more information please see Switch to Primary/Backup.

An acceptor session:

  1. Waits for a Logon message

  2. Changes the current dynamic status to "Connecting"

  3. The color indicator turns yellow

  4. Receives the Logon message

  5. Sends the confirming Logon message

  6. Changes the current dynamic status to "Running"

  7. The color indicator turns green

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.

Send operations

Sending FIX messages

You can send FIX messages to a running session from the Send drop-down menu when the dynamic status corresponds to one of the following options:

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 is displaying one of the following statuses:

  2. Select Arbitrary message from the Send drop-down menu in either:

    • The Object info layout 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. FIXICC H2 then displays the following form:


    Figure. The "Send arbitrary message" form.

  4. To add the arbitrary FIX message you can:

    • Manually type into the field

    • Paste from the clipboard

    • Load a message from a file by selecting Load message

    • Use the SOH button or press Ctrl+Space to enter the SOH delimiter

  5. To finish the sending operation:

    • Select OK to confirm the operation
      Note: The message field must be filled in order to complete the sending operation. A message with an empty field cannot be sent.
      or

    • Select 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 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 test request from the Object info layout part.

    • The Session Dynamic State page (see below)


      Figure. Send 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

 

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 a resend request

To send a resend request:

  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 resend request from the Object info layout part.

    • The Session Dynamic State page (see below)

Figure. Send resend request from the Session Dynamic State page.

  1. FIXICC H2 displays the following form:


    Figure. The "Resend request" form.

  2. 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

         

  3. To finish the operation:

    • Select OK to confirm the operation

    • Select 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.

Sequence number operations

The Seq Num drop-down menu is available for sessions with the following statuses:

Changing sequence numbers

To change the actual incoming and outgoing sequence numbers:

  1. Make sure that the status of the session is 

  2. Select the Change Seq Num item 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.
      or

    • The Session Dynamic State page (shown below)


      Figure. Change sequence numbers from the Session Dynamic State page.

  3. FIXICC H2 displays the form below 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, FIXICC H2 displays an alert message.

    • Use zero or positive integer values

      • If you use a negative or non-integer value, 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. To finish the operation:

    1. Click OK to confirm the new values
      FIXICC H2 then sends new sequence number values to FIXEdge for the current session.
      If a field is empty, the corresponding sequence number won't be changed.
      or

    2. Click Cancel to cancel the operation

 

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

In this case, since the operation can't be finished, the sequence numbers won't be changed.

Resetting sequence numbers

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

To reset the sequence numbers:

  1. Make sure the session status corresponds to one of the following statuses:

  2. Select Reset Seq Num from the Seq Num drop-down menu in either:

    1. The Object info layout part (see below)


      Figure. Reset sequence numbers from the Object info layout part.
      or

    2. The Session Dynamic State page (see below)

Figure. Reset sequence numbers from the Session Dynamic State page.

  1. FIXICC H2 displays the following confirmation form:


    Figure. The "Confirm reset sequence numbers" form.

  2. You can:

    • Click OK to confirm resetting the sequence numbers