RMTHOSTALT

Valid for

Extract

Description

Use RMTHOSTALT to identify an alternative IP address and Collector in case the primary address or collector cannot be reached. After n retries of any TCP/IP errors (default is five), Extract attempts to connect and send data over the connection specified by RMTHOSTALT.

Specify RMTHOSTALT immediately after the corresponding RMTHOST entry. RMTHOSTALT applies only to the previous RMTHOST. Only one RMTHOSTALT entry is allowed per RMTHOST entry.

You can make one or more RMTHOST entries to identify multiple target nodes. Only one entry is active at any time.

In the event that a switch is made to the alternate address, and more errors occur, attempts will be made to switch back to the primary path.

Syntax

RMTHOSTALT {host_name | ip_address}, PORT port_number
[, IPINTERFACE ip_address]
[, TCPIPPROCESSNAME process_name [@ip_address]]
[, USEIPV4ONLY]

host_name: The host name. If ip_address is specified, do not specify host_name.
ip_address: The IP address. Either version (IPv4 or IPv6) of the address internet protocol is acceptable. If host_name is specified, do not specify ip_address.
port_number: The port number. There is no default port for RMTHOSTALT. The port entered here is required and must match the port on which the target Collector is listening.
IPINTERFACE ip_address: Restricts Extract to the specified IP address.
TCPIPPROCESSNAME process_name @ip_address: Restricts Extract to the specified process name. The optional @ip_addresss restricts Extract to the specified IP address.
USEIPV4ONLY: Forces the use of version 4 of the address internet protocol (IPv4) when both IPv4 and IPv6 protocols are configurated and compatible.

Example

The following example causes data to be output over TCP/IP process $ZTC0 to the system designated by 192.0.2.1 on port 7830. If errors are encountered, and three consecutive retries fail, data is output over TCP/IP process $ZTC1 to the system designated by 192.0.2.2 on port 7831.

TCPIPSWITCHERRS 3
RMTHOST 192.0.2.1, PORT 7830, TCPIPPROCESSNAME $ZTC0
RMTHOSTALT 192.0.2.2, PORT 7831, TCPIPPROCESSNAME $ZTC1
RMTTRAIL $DATA5.GGSDAT.RT