Receive Session
Secure Easy IM Client on establishing a valid session with the Secure Easy IM Server, may request a receive session in one of three modes:
- Receive a single message
- Receive in Single Batch mode and discontinue the session
- Receive in Batch mode and request server call back (Secure Easy IM Client stays in listening mode)
In all cases Seim may request that messages from all trading partners (iBoxes) be delivered or that only messages from a specified trading partner be delivered.
If Secure Easy IM Client requests a single message, then the oldest undelivered message will be transmitted to Secure Easy IM Client and the session terminated.
If Secure Easy IM Client requests a Single Batch receive then all waiting messages will be transmitted by the Secure Easy IM Server in order of their receipt and the session terminated. The receiving Secure Easy IM Client must acknowledge receipt of each message and then request that the next message be transmitted. When no more messages are available for transmission the session is terminated.
If a batch receive with server call back is requested then all waiting messages will be transmitted by the Server in order of their receipt (as described above for the Single Batch receive). In addition the Secure Easy IM Client IP address and call back port is recorded putting the iBox in instant delivery mode. When/if subsequent messages arrive for the specified iBox, the Secure Easy IM Server will instantly initiate a call back. The call back request must be refreshed by the Secure Easy IM Client every 'n' minutes or the server will discontinue honoring the call back request.