Connection Type
|
Specifies how the adapter establishes the TCP/IP connection:
-
Client: The adapter
connects to an external server (host/port) to establish the connection.
The adapter is in active mode.
-
Server: The adapter
waits/listens on certain port for an incoming connection request from
an external client. Once the request is received, the adapter accepts
the request and establishes the connection. The adapter is in passive
mode.
|
Select Client or Server.
Unless you specifically require Server mode, leave this value
as the default, Client.
|
ServerSoTimeout
|
Sets or Gets the value of the SO_TIMEOUT for
the ServerSocket, in milliseconds. Used for ServerSocket.accept().
When this option is set to a non-zero timeout, calling accept() for ServerSocket will block for only this amount of time.
If the timeout expires, a java.net.SocketTimeoutException (or java.net.InterruptedIOException) is raised, though the ServerSocket
remains valid.
Enable this option prior to entering the blocking operation.
This parameter is only used when the Connection
Type is set as Server.
|
The SO_TIMEOUT value in milliseconds.
The timeout must be greater than 0 (zero).
A timeout of zero is interpreted as an infinite timeout.
The configured default is 60000 (60
seconds).
|
Keep Alive
|
Specifies whether the client’s SO_KEEPALIVE option is enabled or disabled. When the option is set
for a TCP socket and no data has been exchanged across the socket
in either direction for 2 hours (the actual value is implementation
dependent), TCP automatically sends a KEEPALIVE probe to the peer
(the actual value is implementation dependent). This probe is a TCP
segment to which the peer must respond. One of three responses is
expected:
-
The peer responds with the expected ACK. The application
is not notified (since everything is OK). TCP will send another probe
following another 2 hours of inactivity.
-
The peer responds with an RST, which tells the local
TCP that the peer host has crashed and rebooted. The socket is closed.
-
There is no response from the peer. The socket is
closed. The purpose of this option is to detect if the peer host has
crashed. This is used for the accepted client Socket.
|
Select True or False.
True indicates that the SO_KEEPALIVE
option is enabled.
|
Receive Buffer
Size
|
Sets or Gets the value of the SO_RCVBUF option
for the current socket, that is the buffer size used by the operating
system for input on this socket. It provides an estimate of the size
of the underlying buffers used by the platform for incoming network
I/O.
When used in set, this is
a suggestion to the kernel from the application regarding the size
of buffers to use for the data to be received over the socket. When
used in get, this must return the
actual size of the buffer used by the platform when receiving data
on this socket.
|
A number indicating the receive buffer size.
The configured default is 8192.
|
Send Buffer Size
|
Sets or Gets the value of the SO_SNDBUF option
for the current socket, that is the buffer size used by the operating
system for output on this socket. It provides an estimate of the size
of the underlying buffers used by the platform for outgoing network
I/O.
When used in set, this is
a suggestion to the kernel from the application regarding the size
of buffers to use for the data to be sent over the socket. When used
in get, this must return the actual
size of the buffer used by the platform when sending out data on this
socket.
|
A number indicating the send buffer size.
The configured default is 8192.
|
SoLinger
|
Specifies whether the adapter performs a linger-on-close timeout.
This option disables/enables immediate return from a close() of
a TCP Socket. This parameter is used in conjunction with SoLinger Timeout.
-
True with SoLinger Timeout
set to a non-zero integer timeout: This means that a close() will block, pending the transmission and acknowledgement
of all data written to the peer, at which point the socket is closed
gracefully. Upon reaching the linger timeout, the socket is closed
forcefully with a TCP RST.
-
True with SoLinger Timeout
set to a timeout of zero: Indicates that a forceful close
is done immediately. If the specified value exceeds 65,535 it will
be reduced to 65,535. See the SoLinger Timeout property.
|
Select True or False.
True enables the SO_Linger
option.
|
SoLinger Timeout
|
Specifies the server’s SoLinger time
in seconds. SoLinger Timeout is
used in conjunction with SoLinger (see
the SoLinger property) to configure
the “linger-on-close” timeout. This option disables or
enables immediate return from a close() of a TCP Socket.
When SoLinger is set to true (enabled), the SoLinger
Timeout value indicates the following:
-
A non-zero integer means
that calling close() will block pending the transmission
and acknowledgement of all data written to the peer, at which point
the socket is closed gracefully. Upon reaching the linger timeout,
the socket is closed forcefully, with a TCP RST. If the specified
timeout value exceeds 65,535 it will be reduced to 65,535.
-
A zero integer indicates
that a forceful close is done immediately.
|
The configured default is 30 seconds.
|
SoTimeout
|
Sets or Gets the value of the SO_TIMEOUT in
milliseconds. When this option is set to a non-zero timeout, calling read() on the InputStream associated
with this socket will block for only this configured length of time.
If the timeout expires, a java.io.InterruptedIOException (or java.net.SocketTimeoutException) is raised, but the Socket
remains valid. Enable this option prior to entering the blocking operation.
|
The SoTimeout value in milliseconds. The timeout must be greater
than zero (0). A timeout of zero is interpreted as an infinite timeout.
The configured default is 10000 (10
seconds).
|
TcpNoDelay
|
Specifies whether the server’s TCP_NODELAY option (that is, Nagle’s algorithm) is enabled or
disabled. Written data to the network is not buffered pending acknowledgement
of previously written data.
-
True: Indicates
that the server allows data packets that are less than the maximum
transmission unit (MTU) size to be sent out immediately over the network.
A setting of True may improve performance for higher-speed networks.
-
False: Indicates
that the server does not allow data packets that are less than the
MTU size be sent out immediately over the network.
|
Select True or False.
The configured default is False.
|
Socket Factory Implemen-tation Class Name
|
Specifies the name of the Java class that implements the socket
factory. This class is used to create the socket. If you have provided
your own socket implementation, enter the name of the Java class that
contains this implementation here. The factory implementation class
must implement the following interface:
com.stc.connector.tcpip.model.factory.TCPIPSocketFactory
|
A Java class name.
The default value is
com.stc.connector.tcpip.model.factory.TCPIPSocketFactoryImpl
|