DB2 Version 9.7 for Linux, UNIX, and Windows

AltHostName CLI/ODBC configuration keyword

Specifies the alternate host name to be used if the primary server specified by HOSTNAME cannot be contacted (Client Reroute.)

db2cli.ini keyword syntax:
AltHostName = fully qualified alternate host name | IP address of node
Usage notes:
This can be set in the [Data Source] section of the db2cli.ini file for the given data source, or in a connection string.

This parameter specifies a fully qualified host name or the IP address of the node where the alternate server for the database resides.

If the primary server returns alternate server information, it will override this AltHostName setting. However, this keyword is read only. That means the db2cli.ini will not be updated with the alternate server information received from the primary server.