CONNECT_TIMEOUT - UCMD Manager configuration option

Owned by Stonebranch (Deactivated)
Feb 06, 2023
2 min read

Description

The CONNECT_TIMEOUT option specifies how long a UCMD Manager will wait for a connection to a remote Universal Broker to complete.

CONNECT_TIMEOUT is particularly helpful when more than one host is specified by the REMOTE_HOST option. By default, connection time-outs are controlled by the TCP/IP stack. Depending on this value, it may take several minutes to process a list of hosts before a connection actually succeeds. Setting a CONNECT_TIMEOUT value allows connection attempts to unreachable Universal Brokers to fail quickly, decreasing the time required to process a list of one or more hosts.

Note

CONNECT_TIMEOUT is most beneficial when set to a value that is less than the TCP/IP stack's default timeout, which is implementation dependent. A relatively small CONNECT_TIMEOUT value is recommended, to make sure it - and not the TCP/IP default - is applied.

Usage

Method

Syntax

IBM i

UNIX

Windows

z/OS

Command Line, Short Form

n/a





Command Line, Long Form

-connect_timeout seconds


(tick)

(tick)

(tick)

Environment Variable

UCMDCONNECTTIMEOUT=seconds

(tick)

(tick)

(tick)


Configuration File Keyword

connect_timeout seconds

(tick)

(tick)

(tick)

(tick)

STRUCM Parameter

CONNECTTO (seconds)

(tick)




Values

seconds is the time, in seconds, that the UCMD Manager will wait for a connection to a Universal Broker to complete. This value applies to each host contained in the resolved, expanded, and scrubbed REMOTE_HOST list.

Valid values for seconds are 0 (zero) to 300.

If the time specified by seconds elapses before a successful connection to a Universal Broker on the specified system is established, the UCMD Manager will select the next host in the list. If no more hosts are available, the application will end with an error to indicate that no connection was made.

Note

It is possible for the total time required to attempt connections to all hosts in the REMOTE_HOST list to exceed the number of seconds specified in this option.


Default is 0.

(This mean that each connection attempt will use the implementation-defined TCP/IP time-out value. This is the behavior of connection attempts prior to version 3.2.0 of Universal Command.)