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

RMTHOSTALT requires a separate collector to be running that will accept data in the event that the RMTHOST becomes unavailable.

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.

RMTHOSTALT does not support dynamically created collectors. To use RMTHOSTALT, you must specify the RMTHOST PORT number explicitly (the static method).

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