# HostPortAlias

The host and port to use to match information in asynchronous action tokens to this child server. This parameter applies only when Distributed Action Handler is in mirror-mode and distributing asynchronous actions to child servers (when AsynchronousCommands is set).

When you send the `QueueInfo` action to the Distributed Action Handler with a token, Distributed Action Handler uses the host and port information in the token to forward the action to the correct child server. By default, Distributed Action Handler contacts its child servers at startup to request this host and port information. If it cannot retrieve this information from its children, it uses the values configured in `HostPortAlias`.

In this case, Distributed Action Handler uses the `HostPortAlias` configuration parameter to match the asynchronous action token to the child server configuration. For example, this configuration allows Distributed Action Handler to apply SSL settings.

The host must exactly match the host information that the asynchronous action token returns. To check this value, set the Distributed Action Handler action log stream LogLevel to `FULL`. The Distributed Action Handler then logs the following message for each child server:

    Checking alias for engine host(Host) and port(Port).

Use these values in the `HostPortAlias`.

If these values match the Host and Port parameter, you can set UseDefaultHostPortAlias to `true` in the `[Server]` section to use this information as the `HostPortAlias`. If you set UseDefaultHostPortAlias to `false`, and do not set `HostPortAlias` for child servers, Distributed Action Handler does not use any value.

If you create a server group by specifying a comma-separated list of host names in the Host parameter, you must specify a value in the `HostPortAlias` parameter for each mirrored child server.

Type: | String
Default: |
Required: | No
Configuration Section: | IDOLServer`N` or DistributedEngine`N` or DAHEngine`N`
Example: | `HostPortAlias=12.3.4.56:9000`
See Also: | AsynchronousCommands UseDefaultHostPortAlias

_FT_HTML5_bannerTitle.htm