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