+

Search Tips   |   Advanced Search

TCP transport channel settings

View and configure a TCP transport channels. This type of transport channel handles inbound TCP/IP requests from a remote client.

From the admin console, click...


Transport channel name

Name of the TCP transport channel.

The name field cannot contain the following characters: # \ /, : ; " * ? < > | = + & % '

This name must be unique across all channels in a WebSphere Application Server environment. For example, an HTTP proxy inbound channel and a TCP transport channel cannot have the same name if they reside within the same system.

Information Value
Data type string


Port

The TCP/IP port this transport channel uses to establish connections between a client and an application server. The TCP transport channel binds to the host names and ports listed for the Port property. We can specify the wildcard * (an asterisk), for the host name if we want this channel to listen to all hosts available on this system. However, before we specify the wildcard value, make sure this TCP transport channel does not have to bind to a specific host name.

Information Value
Data type string

(iSeries) (Dist)

Thread pool

This field applies only for IBM i and distributed platforms. Select from the list the thread pool we want the TCP transport channel to use when you dispatch work.

(ZOS) On the z/OS platform, this field is not available for TCP channels that are members of a web container transport chain. These TCP channels run with specialized internal thread pools to minimize thread context switches and improve performance.


Maximum open connections

Maximum number of connections available for a server to use.

Leave the Maximum open connections property set to the default value 20000, which is the maximum number of connections allowed. The transport channel service by default manages high client connection counts and requires no tuning.

For version 8.0.0.2 and higher, the range of connections we can specify is 1 - 128,000 inclusive.

Information Value
Default 20,000


Inactivity timeout

Amount of time, in seconds, that the TCP transport channel waits for a read or write request to complete on a socket.

If client connections are being closed without data that is written back to the client, change the value specified for the Inactivity timeout parameter. This parameter controls the maximum number of connections available for a server's use. Upon receiving a new connection, the TCP transport channel waits for enough data to arrive to dispatch the connection to the protocol-specific channels above the TCP transport channel. If not enough data is received during the time period that is specified for the Inactivity timeout parameter, the TCP transport channel closes the connection.

The default value for this parameter is 60 seconds, which is adequate for most applications. We should increase the value specified for this parameter if your workload involves numerous connections and all of these connections cannot be serviced in 60 seconds.

The value specified for this property might be overridden by the wait times established for channels above this channel. For example, the wait time that is established for an HTTP transport channel overrides the value specified for this property for every operation except the initial read on a new socket.

Information Value
Data type Integer
Default 60 seconds


Address exclude list

Lists the IP addresses that are not allowed to make inbound connections.

Use a comma to separate the IPv4 or IPv6 or both addresses to which we want to deny access on inbound TCP connection requests.

All four numeric values in an IPv4 address must be represented by a number or the wildcard character * (an asterisk).

Following are examples of valid IPv4 addresses that can be included in an Address exclude list: 

*.1.255.0
254.*.*.9
1.*.*.*

All eight numeric values of an IPv6 address must be represented by a number or the wildcard character * (an asterisk). No shortened version of the IPv6 address should be used. Even though a shortened version is processed with no error given, it does not function correctly in this list. Each numeric entry should be a 1- 4 digit hexadecimal number.

Following are examples of valid IPv6 addresses that can be included in an Address exclude list: 

0:*:*:0:007F:0:0001:0001
F:FF:FFF:FFFF:1:01:001:0001
1234:*:4321:*:9F9f:*:*:0000

The Address include list and Host name include list are processed before the Address exclude list and the Host name exclude list. If all four lists are defined, the following cases are true:


Address include list

Lists the IP addresses allowed to make inbound connections. Use a comma to separate the IPv4 or IPv6 or both addresses to which we want to grant access on inbound TCP connection requests.

All four numeric values in an IPv4 address must be represented by a number or the wildcard character * (an asterisk).

Following are examples of valid IP addresses that can be included in an Address include list: 

 *.1.255.0
 254.*.*.9
 1.*.*.*

All eight numeric values of an IPv6 address must be represented by a number or the wildcard character * (an asterisk). No shortened version of the IPv6 address should be used. Even though a shortened version is processed with no error given, it does not function correctly in this list. Each numeric entry should be a 1- 4 digit hexadecimal number.

Following are examples of valid IPv6 addresses that can be included in an Address include list: 

0:*:*:0:007F:0:0001:0001
F:FF:FFF:FFFF:1:01:001:0001
1234:*:4321:*:9F9f:*:*:0000

The Address include list and the Host name include list are processed before the Address exclude list and the Host name exclude list. If all four lists are defined:


Host name exclude list

List the host names that are not allowed to make connections. Use a comma to separate the URL addresses to which we want to deny access on inbound TCP connection requests.

The host name in the exclude list is not case-sensitive.

A URL address can start with the wildcard character * (an asterisk) followed by a period. See the following example: *.Rest.Of.Address. If a period does not follow the wildcard character, the asterisk is treated as a normal non-wildcard character. The wildcard character cannot appear anywhere else in the address. For example, ibm.*.com is not a valid host name.

Following are examples of valid URL addresses that can be included in a Host name exclude list: 

*.ibm.com
www.ibm.com
*.com

The Address include list and Host name include list are processed before the Address exclude list and the Host name exclude list. If all four lists are defined, the following cases are true:


Host name include list

Lists the host names allowed to make inbound connections. Use a comma to separate the URL addresses to which we want to grant access on inbound TCP connection requests.

The host name in the include list is not case-sensitive.

A URL address can start with the wildcard character * (an asterisk) followed by a period. See the following example: *.Rest.Of.Address. If a period does not follow the wildcard character, the asterisk is treated as a normal non-wildcard character. The wildcard character cannot appear anywhere else in the address. For example, ibm.*.com is not a valid host name.

Following are examples of valid URL addresses that can be included in a host name include list: 

*.ibm.com
www.ibm.com
*.com

The Address include list and Host name include list are processed before the Address exclude list and the Host name exclude list. If all four lists are defined:

  • Configure transport chains
  • Tune transport channel services
  • Object names: What the name string cannot contain
  • Transport chains collection
  • Ports collection
  • Thread pool settings