Distributed Action Handler 12.13

# 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/IDOL/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 2022 Micro Focus or one of its affiliates
Version 12.13 | Last updated October 2022

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 swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL Distributed Action Handler 12.13

Topic Title: Distribute the QueueInfo Action