Page tree
Skip to end of metadata
Go to start of metadata

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. 


    • The Session Dynamic State page (see below)
    • Figure. Starting the session from the Session Dynamic State page.

  1. FIXICC H2 displays the following confirmation form:

    Figure. Confirm starting the session.

  2. The following options are available:
    • 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.
    • To finish the operation:
      • Select OK to complete the operation
      • Select Cancel to cancel the operation

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.


    • The Session Dynamic State page (see below)
    • Figure. Stop the session/ stop session with logout from the Session Dynamic State page.

  1. When you click the Stop drop-down button, you can choose to:
  2. Stop the session without sending a logout message by clicking the Stop
    • FIXICC H2 displays the following Confirm the session stopping form:

      Figure. Confirmation form for the stop operation.

      You can:
      • Confirm stopping the operation by clicking OK
      • Cancel the operation by clicking Cancel

  3. Stop the session and send a logout message by clicking Stop with logout
    • FIXICC H2 displays the following Confirm the session stopping with logout form:

      Figure. Confirmation form for stopping a session with the logout operation.

      You can:
      • Write the logout reason into the Logout reason text field
        • In this case, tag 58 in the logout message is specified with the given reason
      • Leave the Logout reason field empty
        • In this case, tag 58 in the logout message is specified with the default reason "Manual termination"

    • To complete the operation, select OK or cancel the operation by selecting Cancel

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.

    • See below for the location of the additional drop-down menu in the Session Dynamic State page:
    • Figure. Restart the session/ restart the session with logout from the Session Dynamic State.

  1. Choose either the Restart session or Restart with logout option
    • Selecting Restart session displays the following form:

      Figure. Confirmation form for the restart operation.

      The following options are available:
    • Optional. To reset sequence numbers, select the checkbox. The sequence numbers are specified with the initial values of the incoming and outgoing sequence numbers from the session configuration.
    • To finish the operation:
      • Select OK to confirm the restart operation
      • Select Cancel to cancel the operation

    • Selecting Restart with logout displays the following form:

      Figure. Confirmation form for the restart with logout operation.

      The following options are available:
      • To reset sequence numbers, select the Reset sequence numbers checkbox. The sequence numbers are specified with the initial values of the incoming and outgoing sequence numbers from the session configuration.
      • In the Logout reason field:
        • Enter a logout reason of your choosing. Tag 58 in the logout message will contain the stated reason.
        • Leave the field empty. Tag 58 in the logout message will contain the default reason of "Manual termination".
      • To finish the operation:
        • Select OK to confirm the restart operation
        • Select Cancel to cancel the operation

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 is in 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
      • Real-time sequence numbers are reset with the initial values from the session configuration
    • 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.

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

  1. FIXICC H2 displays the following confirmation form:

    Figure. The "Confirm the session connection to backup" form.

  2. You can:
    • Click OK to accept the reconnection
      • In this case, FIXICC H2 reconnects the initiator session to the acceptor session in the backup server
      • If the connection is established, the initiator session status is changed to
    • 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's dynamic status won't be changed.

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 the Switch to Primary item from 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.

  1. FIXICC H2 displays the following confirmation form:

    Figure. The "Confirm the session connection to primary" form.

  2. You can:
    • Click OK to accept the reconnection
      • In this case, FIXICC H2 reconnects the initiator session to the acceptor session in the primary server
      • If the connection is established, the initiator session status is changed to 
    • 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.

Show session notifications

To see the list of current session notifications:

  1. Make sure the session status corresponds to one of the following statuses:
  2. Click Show session notifications item from 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. 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 Default Filter, you can filter session notifications by date

      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

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

Copy session to another server

To copy a selected session's configuration to the target server configuration:

  1. Select the session you want to copy
  2. Choose Copy to server from either:
    • The top panel of the Server Sessions page (item 1 in the figure below)
      or
    • The additional menu in the Session Dynamic State page (item 2 in the figure below)

      Figure. The Copy to server option.

  3. FIXICC H2 shows a list of configured servers, where you can choose the target server configuration:

    Note: The schedule configuration bond with the copied session won't be copied to the target server. The session configuration on the target server starts and stops with the server. You can bind a copied session with a new schedule if it is needed.



    Figure. The "Select Server" form.

  4. You can:
    • Select a server from the list and click Select
      • Then FIXICC H2 copies the session configuration to the selected server and open the Session Dynamic State page for a new session
    • Click Cancel to cancel the operation

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

In this case, the session configuration won't be copied to the selected server.

  • No labels