Skip to main content

Settings for the TCP Outbound Adapters

Provides reference information for settings of the TCP outbound adapters. You can configure these settings after you have added a business operation that uses one of these adapters to your production.

Summary

The outbound TCP adapters have the following settings:

Group Settings
Basic Settings IP Address, Port
Connection Settings Backup IP Address, Backup Port, Retries To Failover, Stay Connected, Connect Timeout, Reconnect Retry, Get Reply, Response Timeout, Read Timeout, SSL Configuration, Local Interface, Charset, Endian
Additional Settings Charset

The remaining settings are common to all business operations. For information, see Settings for All Business Operations.

Backup IP Address

Applies to all outbound TCP adapters.

IP address to connect to in case of network error. This server must accept the same values as the original server for settings such as SSLConfig.

Backup Port

Applies to all outbound TCP adapters.

TCP port on the backup server to use. Used only in conjunction with Backup IP Address. For this adapter, both Backup IP Address and Backup Port must be supplied in order to fail over.

Charset

Applies to EnsLib.TCP.CountedOutboundAdapterOpens in a new tab, EnsLib.TCP.CountedXMLOutboundAdapterOpens in a new tab, and EnsLib.TCP.TextLineOutboundAdapterOpens in a new tab.

Specifies the desired character set of the outbound data. InterSystems IRIS® automatically translates the characters to this character encoding. See Charset.

Connect Timeout

Applies to all outbound TCP adapters.

Number of seconds to wait on each attempt to connect to the remote TCP listener. The default is 5 seconds.

Endian

Applies to EnsLib.TCP.CountedOutboundAdapterOpens in a new tab and EnsLib.TCP.CountedXMLOutboundAdapterOpens in a new tab.

A choice of Big or Little indicates the byte order of the 4-byte block count prefix. Big endian means the most significant byte (MSB) goes over the wire first; Little endian means the least significant byte (LSB) goes over the wire first. The default value for this string is Big.

Get Reply

Applies to all outbound TCP adapters.

If 1 (true) wait to read a reply message back from the socket before returning. If 0 (false) do not wait. The default value is 1.

IP Address

Applies to all outbound TCP adapters.

IP address to make a TCP connection to. This can be any of the following:

  • An IPV4 address

  • An IPV6 address

  • A server name that the domain host controller can resolve

  • A CIDR range

Except in the case of a CIDR range, you can optionally append a colon (:) followed by the port number. If a port is specified, the adapter accepts connections from only the specified port.

Note:

IP address filtering is a means to control access on private networks, rather than for publicly accessible systems. InterSystems does not recommend relying on IP address filtering as a sole security mechanism, as it is possible for attackers to spoof IP addresses.

If the string starts with an exclamation point (!) character, the outbound adapter does not initiate the connection but rather waits for an incoming connection request. Once it accepts the connection request, it can send outbound messages. The exclamation point can be specified by itself or followed by a comma-separated list of IP addresses. If the exclamation point is not followed by an IP address, the outbound TCP adapter accepts a connection from any IP address, otherwise the adapter accepts connections only from the specified addresses.

LocalInterface

Applies to all outbound TCP adapters.

Specifies the network interface through which the TCP connection should go. Select a value from the list or type a value. An empty value means use any interface. For details, see Local Interface.

Port

Applies to all outbound TCP adapters.

Identifies the TCP port to connect to.

QSize

Applies to EnsLib.TCP.CountedOutboundAdapterOpens in a new tab, EnsLib.TCP.CountedXMLOutboundAdapterOpens in a new tab, and EnsLib.TCP.TextLineOutboundAdapterOpens in a new tab.

Specifies the number of incoming connections the operating system should hold in reserve on behalf of this business operation. There is generally no reason to change the default value of 0. Either the connection is outbound, or the business operation is using '!' inbound mode, in which case only 1 client is allowed at a time, per business operation pool job.

Read Timeout

Applies to all TCP adapters.

Number of seconds to wait for each successive incoming TCP read operation, following receipt of initial data from the remote TCP port. The default is 5 seconds. The range is 0–600 seconds (a maximum of 10 minutes).

Reconnect Retry

Applies to all outbound TCP adapters.

Number of times the adapter attempts to send a message before dropping the connection and reconnecting. A value of 0 (zero) means that the adapter attempts to send the message forever without disconnecting. The default value is 5.

Response Timeout

Applies to all outbound TCP adapters.

Number of seconds to wait for a response to begin arriving back from the remote system after sending a request. The default is 15 seconds.

Retries To Failover

Applies to all outbound TCP adapters.

Number of times to retry before trying to failover to the backup IP address and port. A value of -1 means never failover. A value of 0 means to failover for the first retry, 1 means to give it one retry with the normal address before failing over for the second retry, and so on. Default value is 5.

SSL Configuration

Applies to all TCP adapters.

The name of an existing TLS configuration to use to authenticate this connection. Choose a client TLS configuration, because the adapter initiates the communication. For details, see SSL Config.

Stay Connected

Applies to all TCP adapters. For information on this setting, see the Stay Connected setting for the inbound adapter.


Previous sectionSettings for the TCP Inbound Adapters
FeedbackOpens in a new tab