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

Sessions operations

Session operations are available from the "Session Dynamic State" page.

To pass to the "Session Dynamic State" you should:

  1. Select the server from the "Servers" page;
  2. Select the session from the "Server Sessions" page.

Now you can open the session in view mode:

  • By clicking the "View" button on the top panel;
  • or by picking the "View" menu item from the context menu;
  • or by double-clicking;
  • by pressing the "Enter" key.

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

Start session

You have the ability to start a configured session.

The "Start" operation is available for a session in status:

If the session dynamic status corresponds to the list above you can start this session by clicking the "Start" button.

Figure. Start the session from the "Object info" layout part.

Figure. Start the session from the "Session Dynamic State" page.


To start the session, you should click the "Start" button.

Then the FIXICC H2 displays the confirmation form.

Figure. Confirm the session starting.

To complete the operation, you should click the "OK" button.

The system will react differently:

  • the initiator session sends the Logon message,

waits for the confirming Logon message,

and changes the current dynamic status to the "Connecting".

The colour indicator is yellow;

the initiator session receives the confirming Logon message

and changes the current dynamic status to the "Running".

The colour indicator is green;

  • the acceptor session waits for the Logon message

and changes the current dynamic status to the "Started".

The colour indicator is yellow;

the acceptor session receives the Logon message,

sends the confirming Logon message,

and changes the current dynamic status to the "Running".

The colour indicator is green.

You have the ability to reset sequence numbers.

To reset sequence numbers, you should select the "Reset sequence numbers" checkbox from the confirmation form.

The current sequence numbers will be assigned with values of the incoming and outgoing sequence numbers from the static configuration.

As well, you can cancel the operation by clicking the "Cancel" button.

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

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


Stop session

You have the ability to stop a running session.

The "Stop" operation is available for the session in status:

If the session dynamic status corresponds to the list above, you can stop this session by clicking the "Stop" button.

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


Figure. Stop the session/ stop session with logout from the "Session Dynamic State".


When you click the "Stop" drop-down button, you can choose:

  • stop the session without sending the logout message by clicking the "Stop" item.

Then the FIXICC H2 displays the "Confirm the session stopping" form.

Figure. Confirmation form for the stop operation.

ºYou can confirm the stopping operation by clicking the "OK" button

ºor you can cancel the operation by clicking the "Cancel" button.

  • or stop the session and send the logout message by clicking the "Stop with logout" item.

Then the FIXICC H2 displays the "Confirm the session stopping with logout" form.

Figure. Confirmation form for the stop with logout operation.

You can enter the "Logout reason".

Then the tag 58 in the logout message will be assigned with the entered string.

In case you leave the "Logout reason" field empty,

Then the tag 58 in the logout message will be assigned with the default string "Manual termination".

To complete the operation, you should click the "OK" button.

As well, you can cancel the operation by clicking the "Cancel" button.


The system response to the stop operation:

  • if the "Stop" option is selected, then the FIXICC H2 shuts the connection down and the session changes the current dynamic status to the "Stopped". The colour indicator is black;
  • if the "Stop and logout" option is selected, then the session sends the Logout message, waits for the response on the logout message, and the session changes the current dynamic status to the "Wait for logoff". The colour indicator is yellow;

the session receives the response on logout and changes the current dynamic status to the "Stopped". The colour indicator is black.


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

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


Restart session

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

The restart operation is available for the session in status:

If the current dynamic status corresponds to the list above, you can find the "Restart" and "Restart with logout" operations in the "Other" drop-down menu.

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

Figure. Restart the session/ restart the session with logout from the "Session Dynamic State".


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

When you click the "Other" drop-down menu, you can choose:

  • restart the session without sending a logout message by clicking the "Restart session" item.

Then the FIXICC H2 displays the "Confirm the session restarting" form.

Figure. Confirmation form for the restart operation.

ºYou can confirm the stopping operation by clicking the "OK" button

ºor you can cancel the operation by clicking the "Cancel" button.

  • or restart the session and send the logout message by clicking the "Restart with logout" item.

Then the FIXICC H2 displays the "Confirm the session restarting with logout" form.

Figure. Confirmation form for the restart with logout operation.

You can enter the "Logout reason".

Then the tag 58 in the logout message will be assigned with the entered string.

In case you leave the "Logout reason" field empty,

Then the tag 58 in the logout message will be assigned with the default string "Manual termination".

To complete the operation, you should click the "OK" button.

As well, you can cancel the operation by clicking the "Cancel" button.


The session response to the stop operation:

  • if the "Stop" option is selected, then the FIXICC H2 shuts the connection down and the session changes the current dynamic status to the "Stopped". The colour indicator is black;
  • if the "Stop and logout" option is selected, then the session sends the Logout message, waits for the response on the logout message, and the session changes the current dynamic status to the "Wait for logoff". The colour indicator is yellow;

the session receives the response on logout and changes the current dynamic status to the "Stopped". The colour indicator is black.

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

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


When the stop operation is finished, then the FIXICC H2 starts the stopped session.

The stopped session will respond to the start operation differently:

  • the initiator session sends the Logon message,

waits for the confirming Logon message,

and changes the current dynamic status to the "Connecting".

The colour indicator is yellow;

the initiator session receives the confirming Logon message

and changes the current dynamic status to the "Running".

The colour indicator is green;

  • the acceptor session waits for the Logon message

and changes the current dynamic status to the "Started".

The colour indicator is yellow;

the acceptor session receives the Logon message.

sends the confirming Logon message,

and changes the current dynamic status to the "Running".

The colour indicator is green.

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

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


As well, you have the ability to reset current sequence numbers.

To reset sequence numbers, you should select the "Reset sequence numbers" checkbox from the "Confirm the session restarting" and the "Confirm the session restarting with logout" forms.

The current sequence numbers will be assigned with values of the incoming and outgoing sequence numbers from the static configuration.

Send operations

You have the ability to send FIX messages to the running session.

The "Send" drop-down menu is available for the session in status:

If the current dynamic status corresponds to the list above, then you can send a FIX message to the session.

Sending the heartbeat message

You have the ability to send the heartbeat FIX message to the session.

The "Heartbeat" item is enabled for the session in status:

To send the heartbeat FIX message, you should select the "Heartbeat" item from the "Send" drop-down menu.

Figure. Send heartbeat from the "Object info" layout part.


Figure. Send heartbeat from the "Session Dynamic State" page.

The FIXICC H2 displays the "Confirm the heartbeat sending" form.

Figure. The "Confirm the heartbeat sending" form.

  • You can confirm the heartbeat sending operation by clicking the "OK" button.

The FIXICC H2 sends the heartbeat FIX message to the session.

  • or you can cancel the operation by clicking the "Cancel" button.


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

In this case, the operation can't be finished and the message won't be sent.


Sending the arbitrary message

You have the ability to send an arbitrary FIX message to the session.

The "Arbitrary message" item is enabled for the session in status:

To send the arbitrary FIX message, you should select the "Arbitrary message" item from the "Send" drop-down menu.

Figure. Send an arbitrary message from the "Object info" layout part.

Figure. Send an arbitrary message from the "Session Dynamic State" page.


The FIXICC H2 displays the "Send arbitrary message" form.

Figure. The "Send arbitrary message" form.

  • You can add the arbitrary FIX message manually by typing in the field from the form or pasting it from the clipboard.
  • or you can load the FIX message from the file by clicking the "Load message" button. Now you can select and load the file from the load dialogue.

As well, you can insert the "SOH" delimiter in the cursor position by clicking the "SOH" button or pressing the Ctrl+Space combination.

Note: You should fill the arbitrary message field to complete the sending operation, the empty message can't be sent.

Now to complete the sending operation, you should click the "OK" button.

The FIXICC H2 sends the entered arbitrary message to the session.

  • or you can cancel the operation by clicking the "Cancel" button.


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

In this case, the operation can't be finished and the message won't be sent.


Sending test request

You have the ability to send the test request FIX message to the session.

The "Test request" item is enabled for the session in status:

To send the test request FIX message, you should select the "Test request" item from the "Send" drop-down menu.

Figure. Send test request from the "Object info" layout part.


Figure. Send test request from the "Session Dynamic State" page.


The FIXICC H2 displays the "Send test request" form.

Figure. The "Send test request" form.

  • You can send the test request message with the default ID (current date and time) or you can change the ID by typing in the field or pasting from the clipboard.

Note: you should fill the test request ID, test request can't be sent without the ID.

To complete the sending operation, you should click the "OK" button.

  • or you can cancel the operation by clicking the "Cancel" button.


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

In this case, the operation can't be finished and the message won't be sent.

Sending the resend request

You have the ability to send the resend request FIX message to the session.

The "Resend request" item is enabled for the session in status:

To send the resend request FIX message you should select the "Resend request" item from the "Send" drop-down menu.

Figure. Send resend request from the "Object info" layout part.


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

The FIXICC H2 displays the "Resend request" form.

Figure. The "Resend request" form.

  • You can send the resend request message with the default values (all sequence of messages have been sent till now will be resent from the counterparty)

or you can enter the numbers of the first and the last messages to resend by typing in the fields or pasting from the clipboard.

Note

You should specify the sequence number of the first message to resend as an integer positive value and the sequence number for the last message to resend as an integer, not a negative value.

You can enter the "0" as a value of the sequence number of the last message to resend the sequence of messages beginning with the sequence number of the first message till the last sent message.

You should enter the number of the last message to resend greater or equal to the number of the first message otherwise the sequence of messages can't be resent.

If you enter the equal numbers for the first and the last messages then only one message will be resent from the counterparty.

You should fill in both message numbers to set the sequence.

To complete the sending operation, you should click the "OK" button.

  • or you can cancel the operation by clicking the "Cancel" button.


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

In this case, the operation can't be finished and the message won't be sent.


Sequence numbers operations

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

The "Seq Num" drop-down menu is available for the session in status:

Changing sequence numbers

You have the ability to change the current sequence numbers of the running session.

You can enter the positive integer values to change the current incoming and outgoing sequence numbers.

This operation will change the metrics values for the running session.

The parameters of static configuration: incoming and outgoing sequence numbers save values set when the session was added.

To change the current incoming or outgoing sequence numbers:

  • you should pick the "Change Seq Num" item from the "Seq Num" drop-down menu.

Figure. Change sequence numbers from the "Object info" layout part.


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


Then the FIXICC H2 displays the "Change sequence numbers" form to enter new values. By default, both parameters: incoming and outgoing sequence numbers are filled with the current metrics values.

Figure. The "Change Sequence Numbers" form.

  • you can change only one sequence number (incoming or outgoing), you should clear the field with the parameter value.

At least one field should be filled to complete the operation.

If you clear both fields,

the FIXICC H2 will display the alert message.

If you enter the not positive or not integer value,

the FIXICC H2 will display the alert message.

  • when you enter a new value into the sequence number field, you should click the "OK" button to complete the operation.

Then the FIXICC H2 assigns the sequence numbers with the values in the corresponding fields. If the field is empty, then the corresponding sequence number isn't changed.

If it is needed, you can cancel the operation by clicking the "Cancel" button.

Note

If you enter the sequence numbers less than current, then the session will be stopped.

You should enter an integer and not negative values for the sequence numbers.

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

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

Resetting sequence numbers

You have the ability to reset the current sequence numbers of the running session.

This operation will assign the current incoming and outgoing sequence numbers with the incoming and outgoing sequence numbers from the static configuration.

To reset the current sequence numbers:

  • you should pick the "Reset Seq Num" item from the "Seq Num" drop-down menu.

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


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

Then the FIXICC H2 displays the confirmation form.

Figure. The "Confirm reset sequence numbers" form.

  • you should accept resetting the sequence numbers.

In this case, current sequence numbers are assigned with the sequence numbers from the static configuration.

If it is needed, you can cancel the operation by clicking the "Cancel" button.

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

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

Switch to Primary/Backup

You have the ability to set parameters for a backup connection in the initiator session parameters list.

Parameters for backup connection are located in the "Initiator Sessions" section:

  • Backup Host;
  • Backup Port.

As well you can set the additional parameters of a backup connection in the "Backup" section:

  • Auto-reconnect Attempts;
  • Auto-reconnect Delay In Ms;
  • Reset On Switch To Backup;
  • Reset On Switch To Primary;
  • Enable Auto Switch To Backup Connection;
  • Cyclic Switch Backup Connection.

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

For the acceptor sessions, "Switch to Backup"/ "Switch to Primary" operations are not included in the "Other" drop-down menu.

These operations are located in the "Other" drop-down menu for the session in the following statuses:

  • For "Switch to Backup" operation:


  • For "Switch to Primary" operation:


To switch the initiator session that is connected to the acceptor session located in the primary server, you should click the "Switch to Backup" item from the "Other" drop-down menu.

Figure. Switch to backup from the "Object info" layout part.


Figure. Switch to backup from the "Session Dynamic State" page.


Then the FIXICC H2 displays the confirmation form.

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

  • You should 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, then the initiator session status is changed to .

  • If it is needed, you can cancel the operation by clicking the "Cancel" button.


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


To switch the initiator session that is connected to the acceptor session located in the backup server, you should click the "Switch to Primary" item from the "Other" drop-down menu.

Figure. Switch to primary from the "Object info" layout part.

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


Then the FIXICC H2 displays the confirmation form.

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

  • You should 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, then the initiator session status is changed to .

  • If it is needed, you can cancel the operation by clicking the "Cancel" button.


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

Show session notifications

You have the ability to see the list of current session notifications.

This operation is available for the session in status:

To pass to the "Notifications" page filtered by the current session Name you should click the "Show session notifications" item from the "Other" menu.

Figure. Show session notifications from the "Object info" layout part.

Figure. The "Show session notifications" option.

Then FIXICC H2 opens the "Notifications" page. The "Object" field is empty and disabled, the "Event Source" field is filled with the session name and disabled.

By default, the notifications list on a page is filtered by the current session name.

Figure. The "Notifications" page filtered by session name.

From the Default Filter, you have the ability to filter session notifications by date.

  • No labels