beautypg.com

Comtrol NS-link Windows NT User Manual

Page 29

background image

Initial NS-Link Installation

29

Windows 2000: NS-Link Installation

The KeepAlive feature
works in the following
ways:

During normal
operation the
driver periodically
sends a connection
check to the NS-
Link device, and
the device then
returns a response.
There are two
timers, one in the
driver, and one in
the device. These
timers are reset
when a connection
check signal is
received and goes
to the next signal.
If a connection is
broken, the data is
stored in the
computer and the device. Depending on the amount of time that has
expired since the connection was lost, the following happens:
-

When the computer loses its connection to the device but re-establishes

it before the timeout period expires, any data transmitted during this

period is queued and sent when the connection resumes.

-

When the computer loses its connection to the NS-Link device and does

not re-establish it before the timeout period expires; the driver then

purges any pending I/O data for ports on that connection and returns

all pending, and future I/O commands, with the exception of the Close

command, to the application with an error indicating the disconnected

status.

This is similar to the processing which occurs when the computer

receives a notification from the device that a port release request, from
FreePort, was processed on a port it owns with the exception that a

different status is returned. When the connection is re-established, the

computer will attempt to re-acquire the ports that were open when the

connection was lost. If the attempt is successful, normal operations

resume for the port. If any port has been acquired, then the computer

will continue to fail all further I/O operations, with the exception of a
Close request. When the Close request is received, the port can then be

re-opened.

-

When the computer loses its connection to the NS-Link device, and the
time period expires, the device places the port into a state from which
another computer can establish a connection, locking out the original
driver when the connection is made. The driver will respond to all I/O
commands, with the exception of the Close command, with an error
indicating the disconnect status.

If you need the ability to reconnect with a port that another server is
currently using, Comtrol includes an utility called FreePort (Page 78) and
its source code which makes the API calls that would force a port closure.
The included source code for FreePort demonstrates the calls an application
would make to perform the same operation.

22. Optionally, set the TCP Timeout Multiplier value.

Use the TCP Multiplier to modify two timers used in TCP/IP socket
communications. The first identifies how long the TCP protocol should wait
before timing out an attempt to open a TCP channel. This timer defaults to
500 ms when the TCP/IP address method is used to communicate with a
device. If the TCP Multiplier is set to 2, the timer would now be 1000 ms, or 1
sec. If the multiplier is 4, the new timeout period would be 2000 ms, or 2 sec.

This manual is related to the following products: