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 go to the "Session Dynamic State" page, 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 Dynamic State" page in a single tab:

  • 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 the 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 "Connecting".

The color indicator is yellow;

the initiator session receives the confirming Logon message

and changes the current dynamic status to "Running".

The color indicator is green.

  • the acceptor session waits for the Logon message

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

The color indicator is yellow;

the acceptor session receives the Logon message from the initiator session,

sends the confirming Logon message,

and changes the current dynamic status into "Running".

The color 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 initial values of the incoming and outgoing sequence numbers from the session 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 the session

You have the ability to stop a started 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 the session with logout from the "Object info" layout part.



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


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 specified with the entered line.

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

The tag 58 in the logout message will be specified with the default line "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 FIXEdge shuts the connection down and the session changes the current dynamic status to "Disconnected". The color indicator on FIXICC H2 is red;
  • if the "Stop with 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 "Disconnected". The color indicator on FIXICC H2 is red.


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 additional 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" page.


The restart operation consists of several operations: the stop and disconnect of the session if the session is running, then remove it from FIX Antenna Cpp, and the start of the planned session.

When you click the additional 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 specified with the entered line.

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

Then the tag 58 in the logout message will be specified with the default line "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 "Restart" option is selected, then the FIXEdge shuts the connection down and the session changes the current dynamic status to "Disconnected". The color indicator on FIXICC H2 is red. Then the FIXEdge removes the session from FIX Antenna and the session changes the current dynamic status to the "Planned". The color indicator on FIXICC H2 is black;
  • if the "Restart with 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 "Disconnected". The color indicator is red. Then the FIXEdge removes the session from FIX Antenna and the session changes the current dynamic status to the "Planned". The color indicator on FIXICC H2 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 FIXEdge starts the planned 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 "Connecting".

The color indicator on FIXICC H2 is yellow;

the initiator session receives the confirming Logon message

and changes the current dynamic status to "Running".

The color indicator on FIXICC H2 is green (in case the initiator is reconnected to the backup acceptor, the color indicator is blue. For more information please follow the Switch to Primary/Backup);

  • the acceptor session waits for the Logon message

and changes the current dynamic status to "Connecting".

The color indicator on FIXICC H2 is yellow;

the acceptor session receives the Logon message.

sends the confirming Logon message,

and changes the current dynamic status to "Running".

The color indicator on FIXICC H2 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 session sequence numbers will be specified with initial values of the incoming and outgoing sequence numbers from the session configuration.


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 sequence numbers of the session.

This operation will change the values of incoming and outgoing sequence numbers metrics for the session.

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, incoming and outgoing sequence numbers are filled with the current metrics values.

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

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 sequence numbers are specified 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 disconnected.

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

This operation will specify the current incoming and outgoing sequence numbers with the initial values from the session 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, sequence numbers are specified with the initial values from the session 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.

Send operations

You have the ability to send FIX messages to the configured 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 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.

Switch to Primary/Backup

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

Mandatory parameters for setting the backup connection are located in the "Connection settings. Extended" section:

  • Backup Host;
  • Backup Port.

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 additional drop-down menu.

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

  • For the "Switch to Backup" operation:

  • For the "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 additional 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 sends to FIXEdge the request for switching the connection of the initiator session to the acceptor session in the backup server.

If the connection is established, then the initiator session status is changed into .

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


To switch the initiator session that is connected to the acceptor session configured for the backup server, you should click the "Switch to Primary" item from the additional 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 sends to FIXEdge the request for switching the connection of 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.

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

Show session notifications

You have the ability to see the list of the selected 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 additional 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.

As well, the Extended Filter is available on the page.

 See the instructions

The Extended Filter allows adding custom search conditions.

Figure. The Extended Filter.

To add a new search condition, you should:

  1. Click the "Add search condition" button ("1" label in the figure above)
  2. Specify the parameter to search by (either select from the list or type the parameter name in the "Filter" field)
  3. Confirm your choice by clicking the "Select" button.

Or:

  • Cancel the operation by clicking the "Cancel" button.


Figure. The "Add condition" form.

Then select the operation type from the drop-down list according to the parameter type.

Figure. The operations list.

To start a search, click the "Refresh" button ("1" label in the figure below).

Figure. The "Refresh" button.

If you need to remove the filter condition, click the "x" symbol to see the full list of objects.

Figure. The removing condition symbol.

To reset the search results:

  • Select the "<Reset Filter>" item from the drop-down menu in the "Refresh" button.


Figure. "Reset Filter" operation.

  • Or click the "Clear" context menu item.


Figure. The "Clear" context menu item.

To save the created filter for future use:

  1. After adding the list of conditions, click the   button and select the save option
  2. You will see the save form depending on the option you have chosen
  3. Please add the mandatory information to save the filter
  4. Click the "OK" button to confirm changes

Or:

  • Cancel the operation by clicking the "Cancel" button.

  • No labels