Updated in release: 8.0.1
official_host_name channel option specifies the "name" of the system with which this channel communicates. The
official_host_name may be either a fully qualified host name, in the case of a channel dedicated to communicating with one particular system,
msconfig> show channel:l.official_host_name role.channel:l.official_host_name = host.domain.com
or in the case of a more "generic" channel used for communicating with multiple systems (such as the Internet-communication channel
official_host_name tends to be a generic, place-holder name, e.g.,
msconfig> show channel:tcp_local.official_host_name role.channel:tcp_local.official_host_name = tcp-daemon
In legacy configuration, the official host name is specified as the first name on the second line of a channel definition:
tcp_local ...keywords... tcp-daemon
Each channel must have its own, unique
official_host_name; no duplication with other channels is allowed. As of MS 6.1, the official host name is limited to 128 characters; in prior versions the limit was 40 characters. An official host name is required for each channel; omitting an official host name from a channel definition is an error.
Note that the
official_host_name on the
l channel (lowercase "L" channel) has somewhat special significance, as it is used/assumed at certain times by the MTA; and normally, it would be set to match the value of the
ldap_local_host MTA option.
As of 8.0.1, the option if not set for a channel will default to
channel-name.hostname in Unified Configurations.