IMAP Connector 25.4
IMAP Connector Help

# QueueInfo

The `QueueInfo` action provides information about the asynchronous actions that the ACI server has queued, is processing, or has finished. You can use the `QueueInfo` action to:

- pause and resume processing the queued actions
- cancel a queued action
- change the priority of a queued action
- retrieve the action parameters passed to an action that is pending or in progress
- monitor the progress of an action that is in progress (if the action supports progress reporting)
- determine whether an action has finished
- retrieve the results of a finished action

When you use `QueueAction=getStatus` to check the status of actions, you can use the `Sort-By` and `Sort-Order` parameters to sort the returned actions. If you do not specify these parameters, the actions are sorted by the time they were received, with the most recent action listed first. You can also use the `State` parameter to filter the actions that are returned by their status.

`QueueInfo` is a synchronous action.

## Parameters

Parameter | Description | Required
--- | --- | ---
ActionID | A string to use to identify an ACI action. | No
Priority | To change the priority of an action using `QueueAction=changePriority`, specify the new priority as an integer. | Required when `QueueAction=changePriority`
QueueAction | The action to perform on the queue. | Yes
QueueName | The name of the queue to query. There is one queue for each asynchronous action. | Yes
Token | To specify a single action in the queue, specify the token. | Required when `QueueAction=cancel` or `QueueAction=changePriority` or `QueueAction=progress`

When `QueueAction=getStatus`, you can use the following action parameters to filter and sort the actions that are returned:

Parameter | Description | Required
--- | --- | ---
Finished-After | Return actions that finished after the specified time. | No
Finished-Before | Return actions that finished before the specified time. | No
Max-Priority | Return actions with a priority the same as or lower than the specified value. | No
MaxResults | The maximum number of results to return in response to a request with `QueueAction=getStatus`. | No
Min-Priority | Return actions with a priority the same as or higher than the specified value. | No
Queued-After | Return actions that were added to the queue after the specified time. | No
Queued-Before | Return actions that were added to the queue before the specified time. | No
Sort-By | The property to use to sort the actions that are returned (`queue-time`, `start-time`, `finish-time`). | No
Sort-Order | The order used to sort the actions that are returned (`ascending`, `descending`). | No
Start | The index of the first result to return in response to a request with `QueueAction=getStatus`. The index of the first result is `1`. | No
Started-After | Return actions that began processing after the specified time. | No
Started-Before | Return actions that began processing before the specified time. | No
State | The actions to return, based on their current state (`queued`, `running`, `finished`). This parameter accepts a comma-separated list of states. If you do not set this parameter, information is returned for all actions. | No

When you use `QueueAction=progress` to check the progress of an action, you can use the following parameters to determine the level of detail to show.

Parameter | Description | Required
--- | --- | ---
AllStages | By default, the response merges finished stages and does not expand pending stages into sub-stages. To show this information, set this parameter to `True`. | No
MaxDepth | The maximum number of levels to include in the output. For example, if you set `MaxDepth=0`, the progress of an action is reported, but the progress of its stages is not. If you set `MaxDepth=2`, the progress of an action and its stages is reported, and each stage can be divided into sub-stages. The depth is not limited by default. | No

## Examples

To return the status of all actions in the `Process` action queue:

    http://localhost:1234/action=QueueInfo&QueueAction=GetStatus&QueueName=Process

To return the status and results of the ten most recently finished actions in the `Process` queue, sorted by the time the server finished processing them, with the most recently completed action listed first:

    http://localhost:1234/action=QueueInfo&QueueAction=GetStatus&QueueName=Process&State=finished&Sort-By=finish-time&Sort-Order=descending&MaxResults=10&Start=1

To change the priority of an action:

    http://localhost:1234/action=QueueInfo&QueueAction=changePriority&QueueName=Process&Token=...&priority=100

To return the progress of a specific action:

    http://localhost:1234/action=QueueInfo&QueueAction=progress&QueueName=Fetch&Token=...&AllStages=false&MaxDepth=1

To return the action parameters passed to an action that is pending or in progress:

    http://localhost:1234/action=QueueInfo&QueueAction=getActionParameters&QueueName=Process&Token=...

## Response

The following XML is a sample response from `action=QueueInfo&QueueAction=GetStatus`. Each action in the queue appears between `<action>` tags.

    <autnresponse>
      <action>QUEUEINFO</action>
      <response>SUCCESS</response>
      <responsedata>
        <actions>
          <action>
            <status>Queued</status>
            <queued_time>2021-May-24 13:53:25</queued_time>
            <time_in_queue>89</time_in_queue>
            <priority>0</priority>
            <token>...</token>
          </action>
          <action>
            <status>Processing</status>
            <queued_time>2021-May-24 13:53:24</queued_time>
            <time_in_queue>72</time_in_queue>
            <process_start_time>2021-May-24 13:54:36</process_start_time>
            <time_processing>18</time_processing>
            <token>...</token>
          </action>
          <action>
            <status>Finished</status>
            <queued_time>2021-May-24 13:53:09</queued_time>
            <time_in_queue>1</time_in_queue>
            <process_start_time>2021-May-24 13:53:10</process_start_time>
            <time_processing>86</time_processing>
            <process_end_time>2021-May-24 13:54:36</process_end_time>
            <token>...</token>
          </action>
        </actions>
      </responsedata>
    </autnresponse>

The response includes the following information:

- `status` - the current status of the action.

  - `Queued` - the action is waiting to be processed.
  - `Processing`
  - `Finished`
  - `Error`
- `queued_time` - the time when the action was added to the queue.
- `time_in_queue` - the amount of time (in seconds) that the action spent in the queue before processing began.
- `process_start_time` - the time when the server started processing the action.
- `time_processing` - the amount of time (in seconds) that the server spent processing the action.
- `process_end_time` - the time when the server finished processing the action.
- `priority` - actions that are `Queued` have a priority, and when resources become available those with a higher priority are processed first. To change the priority assigned to a queued action, you can use `action=QueueInfo&QueueAction=ChangePriority`.

The following XML is a sample response from the `QueueInfo` action, with the parameter `QueueAction=getActionParameters`. The full action was `action=queueinfo&queuename=fetch&queueaction=getActionParameters&token=...`, because this example was sent to a connector. The `<status>` element can return `Queued`, `Processing`, `Finished`, or `Error`. You cannot view the parameters for an action that has finished or failed, so the `<parameters>` element is not present for those actions.

    <autnresponse xmlns:autn="http://schemas.autonomy.com/aci/">
      <action>QUEUEINFO</action>
      <response>SUCCESS</response>
      <responsedata>
          <request>
             <token>MTAuMi4xMDUuMTEyOjcwMDQ6RkVUQ0g6LTY1OTA0MjI4Mg==</token>
             <status>Queued</status>
             <parameters>
                <parameter name="TaskSections" value="MyTask1"/>
                <parameter name="FetchAction" value="Synchronize"/>
             </parameters>
          </request>
       </responsedata>
    </autnresponse>

The following is an example progress report returned by a File System Connector (`action=QueueInfo&QueueAction=Progress&QueueName=Fetch&MaxDepth=4&Token=...`). The `MaxDepth` parameter has limited the depth of the `<stage>` elements returned in the response. For the File System Connector, this limits the depth of the displayed folder structure (the subfolders of "Folder01", "Folder02", and "Folder03" are not displayed).

    <autnresponse>
      <action>QUEUEINFO</action>
      <response>SUCCESS</response>
      <responsedata>
        <action>
           <token>MTAuMi4xMDUuMTAzOjEyMzQ6RkVUQ0g6MTAxNzM0MzgzOQ==</token>
           <status>Processing</status>
           <progress>
              <building_mode>false</building_mode>
              <percent>7.5595</percent>
              <time_processing>18</time_processing>
              <estimated_time_remaining>194</estimated_time_remaining>
              <stage title="MYTASK" status="Processing" weight="1" percent="7.5595">
                 <stage title="Ingestion" status="Processing" weight="999" percent="7.567">
                    <stage title="C:\Test Files\" status="Processing" weight="6601" percent="7.567" progress="0" maximum="6601">
                       <stage title="Folder01" status="Processing" weight="2317" percent="43.116" progress="999" maximum="2317"/>
                       <stage title="Folder02" status="Pending" weight="2567"/>
                       <stage title="Folder03" status="Pending" weight="1715"/>
                       <stage title="." status="Pending" weight="2"/>
                    </stage>
                 </stage>
              <stage title="Deletion" status="Pending" weight="1"/>
              </stage>
           </progress>
        </action>
      </responsedata>
    </autnresponse>

Copyright 2025 Open Text
Version 25.4 | Last updated October 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 IMAP Connector 25.4

Topic Title: QueueInfo