CONNECT_RETRY_INTERVAL - UCMD Manager configuration option

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

Description

The CONNECT_RETRY_INTERVAL option specifies the number of seconds a UCMD Manager will wait before it retries a failed attempt to establish a connection to a remote Universal Broker that resides on the host(s) specified by the REMOTE_HOST option.

UCMD Manager only uses this option when the value specified for the CONNECT_RETRY_COUNT option is greater than 0 (zero).

UCMD Manager uses the connection retry options at two different places within its start-up processing. It first uses the option as it tries to establish the initial connection to a remote Universal Broker. It also uses the option as it attempts to create each of the three connections used to forward standard I/O redirection sockets via the Broker to the UCMD Server.

The precise behavior as UCMD Manager tries to create the initial connection to the remote Broker depends on the number of hosts specified by the REMOTE_HOST option.

  • When only a single host is provided, and the UCMD Manager's attempt to establish a connection to the Universal Broker installed on that system fails, the UCMD Manager will retry the connection attempt as soon as the retry interval elapses.
  • When multiple hosts are specified, the UCMD Manager will try each host in the list as soon as the attempt to connect to the Universal Broker on the preceding host fails. However, once a connection attempt to a host in the list has been tried, the UCMD Manager will not retry that host until the retry interval expires.

UCMD Manager also uses CONNECT_RETRY_INTERVAL when it attempts to connect to the remote Broker in order to forward the standard I/O redirection sockets to the UCMD Server. At this point, the UCMD Manager only attempts additional connections to the Broker to which it is already connected. An additional connection is required to forward each of the three standard I/O redirection sockets. If any of those connection attempts fail, the UCMD Manager will retry the attempt as soon as the retry interval elapses.

In all cases, the retry attempts continue until a connection is established or the number of attempts exceeds the value specified for the CONNECT_RETRY_COUNT option.

Note

CONNECT_RETRY_INTERVAL should not be confused with the RECONNECT_RETRY_INTERVAL option, which controls behavior when network fault tolerance is enabled and the UCMD Manager loses an established connection to a remote UCMD Server.

Usage

Method

Syntax

IBM i

UNIX

Windows

z/OS

Command Line, Short Form

n/a





Command Line, Long Form

-connect_retry_interval seconds


(tick)

(tick)

(tick)

Environment Variable

UCMDCONNECTRETRYINTERVAL=seconds


(tick)

(tick)

(tick)

Configuration File Keyword

connect_retry_interval seconds


(tick)

(tick)

(tick)

STRUCM Parameter

n/a





Values

seconds is the number of seconds the UCMD Manager will wait before it retries an attempt to establish a connection with a remote Universal Broker that resides on a host specified with the REMOTE_HOST option.

Valid values for seconds are 1 to 60.


Default is 0.