Javadoc
Request a session be acquired from the Gateway. It returns a
LibraryReply object.
If this session is being managed by
the gateway then your
SessionAcquireHandler will receive a callback
and the reply will be
SessionReplyStatus#OK. You may also receive the reply of
SessionReplyStatus#SEQUENCE_NUMBER_TOO_HIGH if the sequence number you have passed in
is higher than the current sequence number known by the engine. This may happen to a sequence reset.
In this case you will still get the callback to the
SessionAcquireHandler but won't get a
replay on any messages. You will also get a callback on the
SessionAcquireHandler in the
SessionReplyStatus#MISSING_MESSAGES and
SessionReplyStatus#INVALID_CONFIGURATION_NOT_LOGGING_MESSAGES case but you won't necessarily get the
requested replay of messages.
If another library has acquired the session then this method will return
SessionReplyStatus#OTHER_SESSION_OWNER. If the connection id refers
to an unknown session then the method returns
SessionReplyStatus#UNKNOWN_SESSION.
If this library instance is unknown to the gateway, for example if its heartbeating
mechanism has timed out due to
#poll(int) not being called often enough.