TCP transport channel custom properties
If you are using a TCP transport channel, you can use TCP transport channel custom properties to configure internal TCP transport channel properties.
- In the administrative console, click
- Application servers > server_name, and then select
one of the following options, depending on the type of chain you are
creating:
- Expand SIP container settings, and click SIP container transport chains.
- Expand Web container settings, and click Web container transport chains.
- Under Container services, and click ORB Service > ORB Service Transport Chains.
- Expand Server messaging, and click either Messaging engine inbound transports or WebSphere® MQ link inbound transports.
- Proxy servers, and then expand HTTP proxy server settings, and click Proxy server transports and select either HTTPS_PROXY_CHAIN or HTTP_PROXY_CHAIN. Then click HTTP proxy inbound channel
, and then follow one of the
following paths: - Application servers > server_name, and then select
one of the following options, depending on the type of chain you are
creating:
- Select the transport chain that includes the TCP channel for which you want to specify the custom property.
- Select the TCP inbound channel.
- Click Custom properties > New, expand General properties, and specify the name of the custom property in the Name field and a value for this property in the Value field. You can also specify a description of this property in the Description field.
- Click Apply or OK.
- Click Save to save your configuration changes.
- Restart the server.
listenBacklog
Use the listenBacklog property to specify the maximum number of outstanding connection requests that the operating system can buffer while it waits for the application server to accept the connections. If a client attempts to connect when this operating system buffer is full, the connect request is rejected. The value of this property is specific to each transport.
If you need to control the number of concurrent connections, use the Maximum open connections field on the administrative console TCP transport channel settings page.
Information | Value |
---|---|
Data type | Integer |
Default | 511 |
IMPORTANT: If listenBacklog is not
set for channel types of HTTP, HTTP SSL, IIOP and IIOP SSL, the listenBacklog
is set from deprecated environment values: protocol_http_backlog
, protocol_https_backlog
,
protocol_iiop_backlog
, and protocol_iiop_backlog_ssl
.
If the associated deprecated environment value is not specified, a
default of 10 is used.
For channel types that are not HTTP, HTTP SSL, IIOP and IIOP SSL, the default for listenBacklog is 511.
zaioFreeInitialBuffers
Use the zaioFreeInitialBuffers property to indicate that the TCP channel should release
the initial read buffers used on new connections as soon as these buffers are no longer needed for
the connection. By default, this initial read buffer is cached for each connection. When a
connection is closed, the read buffer is reused to avoid a memory allocation. This process works
well for non-persistent connections, where there is one request per connection. However, for highly
persistent connections, the buffer might be held for a considerable amount of time even though it is
not being used. For workloads that require a large number of connected clients, this situation can
cause a shortage of Language Environment (LE) heap space. Unless your workload consists mainly of
non-persistent connections, you should set this custom property to true
to enable
the release of the initial read buffers.
If you set this property to true
, you must also add the following argument to
the JVM generic arguments that are configured for the application server that is using this TCP
channel:
-Dcom.ibm.ws.buffermgmt.impl.WsByteBufferPoolManagerImpl=
com.ibm.ws.buffermgmt.impl.ZOSWsByteBufferPoolManagerImpl
Information | Value |
---|---|
Data type | String |
Default | false |
soReuseAddr
Use the soReuseAddr custom property to control bind behavior. When the WebSphere Application Server is restarted, if the inbound TCP channels have problems trying to bind the listening socket, errors are printed into the SystemOut file until either the bind is successful or the number of allowed bind attempts has been passed. This custom property helps to avoid repeated error messages during the bind process.
1
, the TCP channel is forced to try each bind attempt with the re-use option set to
true
on the socket. The restart of the server processes first binding attempt,
despite those sockets in TIME_WAIT state.false
.
Two restarts might be required before re-use success is achieved with re-use set to
true
all the time. Also, you can wait until all the TIME_WAIT sockets have
disappeared before restarting.Information | Value |
---|---|
Data type | Integer |
Default | 0 |