Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

Anchor
1384319
1384319
Description

Anchor
1384320
1384320
The REMOTE_HOST option specifies a comma-delimited list of one or more hosts upon which a command can run.

Anchor
1384321
1384321
Each host in the list can be specified as a host name or an IP address in dotted decimal notation.

Note
titleNote

For purposes of this discussion, even if one host is specified, it is considered a list with a single entry.


Anchor
1384323
1384323
If multiple hosts are specified, the UCMD Manager will try each one until it successfully connects to a Universal Broker. When a successful connection is established, no more hosts in the list are tried. If the UCMD Manager is unable to establish a connection to a Universal Broker on any of the hosts in the list, the UCMD Manager will fail.

Anchor
1384324
1384324
Each host in the REMOTE_HOST list also can include a port number or service name that the UCMD Manager will use to establish a connection with the Universal Broker on that host. This is useful in situations where the remote Broker is configured to accept incoming connections on a port that is different from the UCMD Manager's configured value.

Anchor
1384325
1384325
UCMD Manager automatically removes any duplicates found in the list of hosts before it makes its first connection attempt. This includes any host names that resolve to the same IP address, or duplicate IP addresses that are added to the list following DNS expansion (see the DNS_EXPAND option).

Note
titleNote

Duplicate IP addresses may appear in the resolved, expanded, scrubbed list of hosts if a different port number is specified for each occurrence of a particular IP address (for example, 192.168.1.1:7887 and 192.168.1.1:7888 are considered distinct entries).


Anchor
1384330
1384330
To set configuration options that control selection of the hosts in the REMOTE_HOST list, see the HOST_SELECTION and CONNECT_TIMEOUT options.

Anchor
1384337
1384337
To set configuration options that control processing of the hosts in the REMOTE_HOST list, see the DNS_EXPAND and MFT_SAFE_MODE options.

Anchor
1384344
1384344
The following text briefly describes each of these options.

Anchor
1384345
1384345
HOST_SELECTION

Anchor
1384349
1384349
UCMD Manager uses the HOST_SELECTION option to control which host in the REMOTE_HOST list is selected first. UCMD Manager can be configured to always select the first host or to select a randomly chosen host as it begins its attempts to connect to a remote Universal Broker. In either case, after a host is selected, UCMD Manager processes the list sequentially until either a connection succeeds or all hosts in the list have been tried.

Anchor
1384354
1384354
CONNECT_TIMEOUT

Anchor
1384358
1384358
UCMD Manager uses the CONNECT_TIMEOUT option to specify how long it will wait for a connection attempt to succeed before it moves on to the next host in the list.

Anchor
1384363
1384363
DNS_EXPAND

Anchor
1384364
1384364
To set configuration options that control processing of the hosts in the REMOTE_HOST list, the DNS_EXPAND and MFT_SAFE_MODE options are provided.

Anchor
1384374
1384374
The DNS_EXPAND option controls the number of IP addresses returned when UCMD Manager issues a DNS query to resolve a host name. If the Manager is configured to expand the results of the query, all IP addresses defined for a particular host name are returned and expanded (in-place) within the list of hosts. Otherwise, only the first host is returned, and no expansion is performed.

Anchor
1384379
1384379
MFT_SAFE_MODE

Anchor
1384383
1384383
The MFT_SAFE_MODE option controls the situations in which more than one host may be specified in the REMOTE_HOST list when manager fault tolerance (MFT) is enabled. Automated restarts may result in an MFT restart being tried on a system that is different from the original system. If a restartable MFT process is not found on that system, new work may be started. The MFT_SAFE_MODE option guards against duplicate processing in this situation.

Usage

Method

Syntax

IBM i

UNIX

Windows

z/OS

Command Line, Short Form

-i hostlist


(tick)

(tick)

(tick)

Command Line, Long Form

-host hostlist


(tick)

(tick)

(tick)

Environment Variable

UCMDHOST hostlist

(tick)

(tick)

(tick)


Configuration File Keyword

host hostlist

(tick)

(tick)

(tick)

(tick)

STRUCM Parameter

HOST(hostlist)

(tick)




Values

Anchor
1384518
1384518
hostlist is a list of one or more hosts, in the following format:

Wiki Markup
host1\[\[:port1\],host2\[:port2\],host3\[:port3\],...hostn\[:portn\]\]

Anchor
1384520
1384520
In this format:

  • host is the IP address (in dotted decimal notation) or host name of the system upon which the command may run.
  • port is an optional port number (or service name), which is necessary only if the remote Universal Broker is accepting incoming connections on a port that is different from the value specified by the REMOTE_PORT option.
Note
titleNote

The port number, when specified, must be separated from the host by a colon ( : ).

Info
titleHP NonStop

Anchor
1384531
1384531
Only a single host can be specified, either as an IP address in dotted decimal notation or a host name.

Anchor
1384417
1384417
In addition, a port number only can be specified with the REMOTE_PORT option. Specifying a port number in the host list is not supported.