Sessions operations (for FIXEdge C++)
- 1 Sessions operations
- 1.1 Start a session
- 1.1.1 System response
- 1.2 Stop the session
- 1.2.1 System response
- 1.3 Restart session
- 1.3.1 Session response
- 1.4 Sequence numbers operations
- 1.5 Send operations
- 1.6 Switch to Primary/Backup
- 1.6.1 Switching to backup
- 1.6.2 Switching to primary
- 1.7 Show session notifications
- 1.1 Start a session
Sessions operations
Session operations are available from the Session Dynamic State page.
To go to the Session Dynamic State page, you should:
Select the server from the Servers page (items 1→ 2→3 in the figure below)
Select the session from the Server Sessions page (items 4 or 5→6 in the figure below)
Figure. The Servers page.
To open the Session Dynamic State page in a single tab, choose one of the following options:
Click View on the top panel
Select View in the context menu
Double-click the session
Press Enter on the keyboard
The set of available operations depends on the dynamic session status.
Start a session
To start a configured session:
Make sure the session is in one of the following statuses:
Click Start
In the Object info part (see below)
Figure. Start the session from the Object info layout part.
orIn the Session Dynamic State page (see below)
Figure. Start the session from the Session Dynamic State page.
The FIXICC H2 displays the following confirmation form:
Figure. Confirm the session starting.Optional. 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:
Click OK to complete the operation
orClick 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.
System response
The system reacts differently depending upon whether an initiator session or an acceptor session was started.
An initiator session:
Sends a Logon message
Waits for the confirming Logon message
Changes the current dynamic status to "Connecting". The color indicator turns yellow.
Receives the confirming Logon message
Changes the current dynamic status to "Running". The color indicator turns green.
An acceptor session:
Waits for a Logon message
Changes the current dynamic status to "Connecting". The color indicator turns yellow.
Receives the Logon message from the initiator session
Sends the confirming Logon message
Changes the current dynamic status into "Running". The color indicator turns green.
Stop the session
To stop a started session:
Make sure the session is in one of the following statuses:
Click the Stop drop-down menu
In the Object info layout (see below)
Figure. Stop the session/ stop the session with logout from the Object info layout part.
orIn the Session Dynamic State page (see below)
Figure. Stop the session/ stop the session with logout from the Session Dynamic State page.
In the drop-down menu, you can select either of the following options:
Stop
FIXICC H2 displays the "Confirm the session stopping" form
Figure. Confirmation form for the stop operation.Click OK to confirm the operation or Cancel to cancel the operation
Stop with logout
FIXICC H2 displays the "Confirm the session stopping with logout" form
Figure. Confirmation form for the stop with logout operation
Enter the logout reason in the Logout reason field. Tag 58 in the logout message will contain the entered reason.
If you leave the field empty, tag 58 in the logout message will contain the default line "Manual termination"
Click OK to confirm the operation or Cancel to cancel the operation
If for some reason FIXEdge can't complete this operation, the FIXICC H2 displays an error form.
If the operation can't be finished, the session dynamic status won't be changed.
System response
If Stop is selected:
FIXEdge shuts the connection down
The session changes the current dynamic status to "Disconnected"
The color indicator on FIXICC H2 turns red
If Stop with logout is selected:
The session sends the Logout message
The session waits for the response on the logout message
The session changes the current dynamic status to "Disconnected"
The color indicator on FIXICC H2 is red
Restart session
The restart operation consists of several operations:
The running session is:
Stopped
Disconnected
Removed from FIX Antenna Cpp
The planned session starts
You can restart the running session with and without sending a logout message.
To restart a session:
Make sure it's in one of the following statuses:
In the additional drop-down menu, you can find the Restart and Restart with logout operations
In the Object info layout part (see below)
Figure. Restart the session/ restart the session with logout from the Object info layout part.
orIn the Session Dynamic State page
Figure. Restart the session/ restart the session with logout from the Session Dynamic State page.
From there, you can:
Click Restart session to restart the session without sending a logout message
Then the FIXICC H2 displays the "Confirm the session restarting" form
Figure. Confirmation form for the restart operation.Click OK to confirm the operation or click Cancel to cancel the operation
Click Restart with logout to restart the session and send the logout message
Then the FIXICC H2 displays the "Confirm the session restarting with logout" form
Figure. Confirmation form for the restart with logout operation.
Enter the logout reason in the Logout reason field. Tag 58 in the logout message will contain the entered reason.
If you leave the field empty, tag 58 in the logout message will contain the default line "Manual termination"
Optional. 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.Click OK to confirm the operation or 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.
Session response
If Restart is selected:
FIXEdge shuts the connection down
The session changes the current dynamic status to "Disconnected"
The color indicator on FIXICC H2 turns red
FIXEdge removes the session from FIX Antenna
The session changes the current dynamic status to "Planned"
The color indicator on FIXICC H2 turns black
If Restart with logout is selected:
The session sends the Logout message
The session waits for the response on the logout message
The session changes the current dynamic status to "Disconnected"
The color indicator turns red
FIXEdge removes the session from FIX Antenna
The session changes the current dynamic status to "Planned"
The color indicator on FIXICC H2 turns black
When the stop operation is finished, FIXEdge starts the planned 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:
Sends the Logon message
Waits for the confirming Logon message
Changes the current dynamic status to "Connecting"
The color indicator on FIXICC H2 turns yellow
The initiator session receives the confirming Logon message
Changes the current dynamic status to "Running"
The color indicator on FIXICC H2 turns green
Note: If the initiator is reconnected to the backup acceptor, the color indicator turns blue. For more information please follow the Switch to Primary/Backup
An acceptor session:
Waits for the Logon message
Changes the current dynamic status to "Connecting"
The color indicator on FIXICC H2 turns yellow
The acceptor session receives the Logon message
Sends the confirming Logon message
Changes the current dynamic status to "Running"
The color indicator on FIXICC H2 turns green
If for some reason the FIXEdge can't complete this operation, then the FIXICC H2 displays an error form.
In this case, the operation can't be finished and the session dynamic status won't be changed.
Sequence numbers operations
You have access to the operation with the current sequence numbers of the session.
The Seq Num drop-down menu is available for the session in the following statuses:
Changing sequence numbers
To change the current incoming or outgoing sequence numbers:
Make sure the session is in one of the following statuses:
or
Select Change Seq Num 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.The Session Dynamic State page (shown below)
Figure. Change sequence numbers from the Session Dynamic State page.
The FIXICC H2 displays the Change sequence numbers form 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, the FIXICC H2 displays an alert message.
Use zero or positive integer values
If you use a negative or non-integer value, the 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.
Once you've entered your desired value, click OK to complete the operation.
The FIXICC H2 then sends the new sequence number value(s) to FIXEdge for the current session.If the field is empty, the corresponding sequence number won't be changed.
To cancel the operation at any point, click Cancel.
If FIXEdge can't complete this operation, the FIXICC H2 displays an error form.
If the operation can't be completed, the sequence numbers won't be changed.
Resetting sequence numbers
This operation specifies the current incoming and outgoing sequence numbers with the initial values from the session configuration.
To reset the current sequence numbers of the session:
Make sure the session is in one of the following statuses:
Select Reset Seq Num from the Seq Num drop-down menu
In the Object info layout part (see below)
Figure. Reset sequence numbers from the Object info layout part.
orThe Session Dynamic State page (see below)
Figure. Reset sequence numbers from the Session Dynamic State page.
The FIXICC H2 displays the following confirmation form
Figure. The "Confirm reset sequence numbers" form.Click OK to confirm the operation or 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.
Send operations
You have the ability to send FIX messages to a configured session with the following statuses:
Sending a heartbeat message
To send a heartbeat message to a session:
Make sure the session is in one of the following statuses:
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.
orThe Session Dynamic State page (see below)
Figure. Send heartbeat from the Session Dynamic State page.
The following form appears:
Figure. The "Confirm the heartbeat sending" form.
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:
Make sure the session displays one of the following statuses:
Select Arbitrary message from the Send drop-down menu
In the Object info part (see below)
Figure. Send an arbitrary message from the Object info layout part.
orThe Session Dynamic State page (see below)