Session operations

Session operations are available on the Session Dynamic State page.

...

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)

Image RemovedImage Added
Figure. The Servers page.

...

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:

...

1. Click Start in either:
   • The Object Info layout part (see below)Image Removed
   • Image Added 
     • Figure. Starting the session from the Object info layout part. 

1. • The Session Dynamic State page (see below)
   • Image RemovedImage Added
   • Figure. Starting the session from the Session Dynamic State page.
     
     
2. FIXICC H2 displays the following confirmation form:
   Image RemovedImage Added
   Figure. Confirm starting the session.
   
   
3. 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

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.

...

1. Click Stop in either:
   • The Object Info layout part (see below)
   • Image RemovedImage Added
   • Figure. Stop the session/ stop session with logout from the Object info layout part.

...

1. • The Session Dynamic State page (see below)
   • Image RemovedImage Added
   • Figure. Stop the session/ stop session with logout from the Session Dynamic State page.
     
     
2. When you click the Stop drop-down button, you can choose to:
3. Stop the session without sending a logout message by clicking the Stop
   • FIXICC H2 displays the following Confirm the session stopping form:
     Image RemovedImage Added
     Figure. Confirmation form for the stop operation.
     
     You can:
     
     • Confirm stopping the operation by clicking OK
     • Cancel the operation by clicking Cancel
       
       
4. 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:
     Image RemovedImage Added
     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

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.

...

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:

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

1. • See below for the location of the additional drop-down menu in the Session Dynamic State page:Image Removed
   • Image Added
   • Figure. Restart the session/ restart the session with logout from the Session Dynamic State.
     
     
2. Choose either the Restart session or Restart with logout option
   • Selecting Restart session displays the following form:
     Image RemovedImage Added
     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:
     Image RemovedImage Added
     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

...

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

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)
     Image RemovedImage Added
   • Figure. Send heartbeat from the Object info layout part.
     or
     
   • The Session Dynamic State page (see below)
   • Image RemovedImage Added
   • Figure. Send heartbeat from the Session Dynamic State page.
     
     
3. The following form appears:
   Image RemovedImage Added
   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 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)
   • Image RemovedImage Added
   • Figure. Send an arbitrary message from the Object info layout part.
     or
     
   • The Session Dynamic State page (see below)
     Image RemovedImage Added
   • Figure. Send an arbitrary message from the Session Dynamic State page.
     
     
3. FIXICC H2 then displays the following form:
   Image RemovedImage Added
   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

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)
     Image RemovedImage Added
     Figure. Send test request from the Object info layout part.
     
     
   • The Session Dynamic State page (see below)
     Image RemovedImage Added
     Figure. Send test request from the Session Dynamic State page.
     
     
3. FIXICC H2 displays the following form:
   Image RemovedImage Added
   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:

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)
     Image RemovedImage Added
     Figure. Send resend request from the Object info layout part.
     
     
   • The Session Dynamic State page (see below)
     Image RemovedImage Added

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

1. FIXICC H2 displays the following form:
   Image RemovedImage Added
   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

...

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)
     Image RemovedImage Added
     Figure. Change sequence numbers from the Object info layout part.
     or
   • The Session Dynamic State page (shown below)
     Image RemovedImage Added
     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.
   Image RemovedImage Added
   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

...

Resetting sequence numbers

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

...

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)
      Image RemovedImage Added
      Figure. Reset sequence numbers from the Object info layout part.
      or
   2. The Session Dynamic State page (see below)
      Image RemovedImage Added

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

1. FIXICC H2 displays the following confirmation form:
   Image RemovedImage Added
   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

...

Anchor
PrimaryBackup PrimaryBackup

Switching to Primary/Backup

The Switch to Backup/Switch to Primary operations are only enabled for initiator 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)
     Image RemovedImage Added
     Figure. Switch to backup fromthe Object info layout part.
     or
   • The Session Dynamic State page (see below)
     Image RemovedImage Added

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 Image Removedto Image Added
   • Click Cancel to cancel the operation

...

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:
   • 
   • 
   • Image RemovedImage Added
   • 
2. Click the Switch to Primary item from the additional drop-down menu in either:
   
   • The Object info layout part (see below)
     Image RemovedImage Added
     Figure. Switch to primary fromthe Object info layout part.
     or
   • The Session Dynamic State page (see below)
     Image RemovedImage Added

Figure. Switch to primary from the Session Dynamic State page.

...

Show session notifications

To see the list of current session notifications:

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

   • 

   • 

   • 

   • 

   • Image RemovedImage Added

2. Click Show session notifications item from the additional menu in either:
   
   • The Object info layout part (see below)
     Image RemovedImage Added
     Figure. Show session notifications fromthe Object info layout part.
     or
   • The Session Dynamic State page (see below)
     Image RemovedImage Added
     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
     

     Expand
     title See the instructions
     Multiexcerpt include MultiExcerptName Default Filter PageWithExcerpt B2BITS:View settings

   • The Extended Filter is available

     Expand
     title See the instructions
     Multiexcerpt include MultiExcerptName Extended Filter PageWithExcerpt B2BITS:View settings

     Image RemovedImage AddedFigure. The Notifications page filtered by session name.