CONNECT_RETRY_COUNT - UCMD Manager configuration option

Owned by Stonebranch (Deactivated)
Jan 31, 2024
2 min read

Description

The CONNECT_RETRY_COUNT option specifies the number of times a UCMD Manager will attempt to establish a connection to a remote Universal Broker that resides on the host(s) specified by the REMOTE_HOST option.

UCMD Manager uses CONNECT_RETRY_COUNT 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 continue to retry the connection attempt until a connection is established or until the number of attempts exceeds the value specified for this option.
  • When multiple hosts are provided, the UCMD Manager will attempt to connect to the Universal Broker on each host until a connection is established on one of the hosts or the number of attempts exceeds the value specified for this option. If the CONNECT_RETRY_COUNT value is greater than the number of hosts specified, the UCMD Manager will try each host in the list and then wrap around to the start of the list to try each host again. In other words, CONNECT_RETRY_COUNT specifies the total number of connection attempts, rather than the number of attempts that should be made for each host.

UCMD Manager also uses CONNECT_RETRY_COUNT 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 until a connection is established or the number of attempts exceeds the specified retry count.

Note

This option should not be confused with the RECONNECT_RETRY_COUNT 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_count number


(tick)

(tick)

(tick)

Environment Variable

UCMDCONNECTRETRYCOUNT=number


(tick)

(tick)

(tick)

Configuration File Keyword

connect_retry_count number


(tick)

(tick)

(tick)

STRUCM Parameter

n/a





Values

number is the number of times the UCMD Manager will try to establish a connection with a remote Universal Broker residing on a host specified with the REMOTE_HOST option.

Valid values for number are 0 (zero) to 20.

When the value for this option is 0 (zero), the UCMD Manager will not retry failed connection attempts.


Default is 0.