Skip to main content
Version: 8.1

HOSTNAME_RETRY_COUNT - UCTL Manager configuration option

Description​

The HOSTNAME_RETRY_COUNT option specifies the number of times that the Universal Control Manager will attempt to establish a connection with a specified Universal Broker before it ends with a connect error.

The Universal Control Manager will sleep for one second between connection attempts.

Connection errors occur for several reasons. A common reason is a failure to resolve the Universal Broker host name specified with the REMOTE_HOST option. This error can occur intermittently due to a temporary resource shortage or a temporary DNS problem. If your system is prone to host name resolution errors, it may help to have the Universal Control Manager retry the connection several times.

Usage​

Method

Syntax

IBM i

UNIX

Windows

z/OS

Command Line, Short Form

n/a

Command Line, Long Form

-hostname_retry_count count

Environment Variable

UCTLHOSTNAMERETRYCOUNT=count

Configuration File Keyword

hostname_retry_count count

STRUCT Parameter

HSTNMRTYCT(count)

Value​

count is the number of times that Universal Control will attempt to establish a connection.

Default is 1.