Description

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

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

If multiple hosts are specified, the UEM 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 UEM Manager is unable to establish a connection to a Universal Broker on any of the hosts in the list, the UEM Manager will fail.

Each host in the REMOTE_HOST list also can include a port number or service name that the UEM 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 UEM Manager's configured value.

UEM 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).

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

The following text briefly describes each of these options. Each is briefly described below.

HOST_SELECTION

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

(See the HOST_SELECTION option for more information.)

CONNECT_TIMEOUT

UEM 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.

(See the CONNECT_TIMEOUT option for more information.)

DNS_EXPAND

The DNS_EXPAND option controls the number of IP addresses returned when UEM Manager issues a DNS query to resolve a host name. If the UEM 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.

(See the DNS_EXPAND option for more information.)

Usage

Method	Syntax	IBM i	HP NonStop	UNIX	Windows	z/OS
Command Line, Short Form	-i hostlist
Command Line, Long Form	-host hostlist
Environment Variable	UCMDHOST hostlist
Configuration File Keyword	host hostlist

Values

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

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

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.