Distributed Action Handler 25.3
Distributed Action Handler Help

# Distribute the QueueInfo Action

After you configure asynchronous actions, you can use the `QueueInfo` action to check the status of the action queue or a specific action, and manage the action queue.

To check a specific action, send the `QueueInfo` action with the asynchronous action token returned by the child server. DAH uses the host and port information in the token to send the action to the correct child server.

By default, DAH retrieves this information from the child servers at startup to match the value in the token to its child server configuration.

If DAH cannot retrieve this information, it uses the HostPortAlias configuration parameter to apply the child server configuration options to the `QueueInfo` action. DAH matches the HostPortAlias information to the child server configuration. For example, using the HostPortAlias configuration allows DAH to apply the appropriate SSL settings for the child server.

## Find the Alias for a Child Server

If DAH cannot retrieve host and port information from its child servers for any reason, it uses the configured value of HostPortAlias to match tokens to its child servers.

The host and port that you specify for a child server in the HostPortAlias parameter must exactly match the host and port information in the asynchronous action tokens. This value does not necessarily match the Host and Port configuration parameters. For example, you might set Host to the computer name, and the token might return an IP address.

To find the host and port for a child server

1. Open the DAH configuration file in a text editor.

2. In the `[Logging]` section, set LogLevel to `Full`.

3. Save and close the configuration file.

4. Restart the DAH for your changes to take effect.

5. After the DAH has started, send a `QueueInfo` action to the DAH. Set the `Token` parameter to an action token for the child server for which you want to find the alias. For example:

       action=QueueInfo&Token=FOO-123&QueueAction=getstatus

6. Open the action log. In a default unified configuration, this file is located in the following directory:

       installdir/logs

7. Find the log message of the following type:

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

   This `Host` and `Port` value is the value that you must use in the HostPortAlias configuration parameter.

## Use HostPortAlias

You can apply a host and port alias:

- individually for each child server by using the HostPortAlias configuration parameter.

- for all child servers by using the UseDefaultHostPortAlias configuration parameter.

  In this case, if DAH cannot retrieve the child server host and port from the child servers, it matches the host and port information in the ansynchronous action tokens to the Host and Port parameters for each child server. You can use this option if the configured values exactly match the values in the asynchronous action token.

To set HostPortAlias for individual child servers

1. Open the DAH configuration file in a text editor.

2. Find the `[IDOLServerN]` or `[DAHEngineN]` configuration sections.

3. Set the HostPortAlias parameter to the host and port for the child server; separate the values with a colon. The host must exactly match the host and port in the asynchronous action token.

4. Save and close the configuration file.

5. Restart the DAH for your changes to take effect.

To set HostPortAlias for all child servers

1. Open the DAH configuration file in a text editor.

2. In the `[Server]` section, set the UseDefaultHostPortAlias configuration parameter to `True`.

3. Save and close the configuration file.

4. Restart the DAH for your changes to take effect.

Related Topics

- Find the Alias for a Child Server

Copyright 2025 Open Text
Version 25.3 | Last updated July 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Distributed Action Handler 25.3

Topic Title: Distribute the QueueInfo Action