Official_host_name Option

From Messaging Server Technical Reference Wiki
Jump to: navigation, search

Updated in release: 8.0.1

The 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 =

or in the case of a more "generic" channel used for communicating with multiple systems (such as the Internet-communication channel tcp_local), the official_host_name tends to be a generic, place-holder name, e.g.,

msconfig> show 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...

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.

See also: