set hostlist
Purpose
Adds or removes entries from the host list. For DialServ, the host list provides a means to map a phone number (in the local name field) to a network destination, (in the resolves_to field).
When accessing a device by name, the Digi device attempts to locate the name in the host list. When a match is found, the host name is mapped to the alias. Typically, this host list is used as a first means of locating the destination address before using the domain name system (DNS).
Each host list entry consists of a local name string which resolves to a destination. The destination can be either an IP Address or Fully Qualified Domain Name (FQDN). Creating several entries in the host list allows a many-to-one mapping of multiple host names to a single destination, as well as a one-to-many mapping of a host name to multiple destinations. The one-to-many mapping allows a fail-over option; that is, a connection to the resolves_to name for the first host match in the list is attempted. If that connection attempt fails, the resolves_to name for the next match in the host list is used.
Required permissions
For Digi products with two or more users, permissions must be set to set permissions s-hostlist=read to display the current host list, and set permissions s-hostlist=rw to display and configure the host list. See set permissions for details on setting user permissions for commands.
Syntax
set hostlist [{add|remove}]
local_name=host address or name as known locally
resolves_to=host address or name that will be resolved
Options
{add|remove}
Adds or removes an entry in the host list.
local_name=host address or name as known locally
A local name string that maps to a destination.
resolves_to=host address or name that will be resolved
The destination to which the local_name value resolves. This destination can be either an IP Address or Fully Qualified Domain Name (FQDN).
PDF
