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


(tick)

(tick)

(tick)

Environment Variable

UCTLHOSTNAMERETRYCOUNT=count

(tick)

(tick)

(tick)


Configuration File Keyword

hostname_retry_count count

(tick)

(tick)

(tick)

(tick)

STRUCT Parameter

HSTNMRTYCT(count)

(tick)




Value

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

Default is 1.