Lithium Connector 26.1
Lithium Connector Help

# OnQueueEvent

Lithium Connector generates an event when an asynchronous action queue becomes full, becomes empty, or the queue size passes certain thresholds. The `OnQueueEvent` parameter specifies the name of the handler to use to handle these events.

- A `QueueFull` event occurs when the action queue becomes full.
- A `QueueFilling` event occurs when the queue size exceeds the value of QueueFillingThreshold and the last event was a `QueueEmpty` or `QueueEmptying` event.
- A `QueueEmptying` event occurs when the queue size falls below the value of QueueEmptyingThreshold and the last event was a `QueueFull` or `QueueFilling` event.
- A `QueueEmpty` event occurs when the action queue becomes empty.

The name that you specify must represent a section in the configuration file that contains the LibraryName parameter and any other settings for the event handler. For example:

    [ActionName]
    OnQueueEvent=MyHandler
    QueueFillingThreshold=0.7
    QueueEmptyingThreshold=0.4

    [MyHandler]
    LibraryName=LuaHandler
    LuaScript=./handle_queue_event.lua

In the example above, the Lua script might respond to the events by sending a notification to an administrator.

An event contains the following information:

`queueEventType` | The type of event, for example `QueueFull` or `QueueFilling`.
`maxQueueSize` | The maximum size of the queue.
`queueSize` | The current size of the queue (not present for `QueueEmpty` events).

Type: | String
Default: |
Required: | No
Configuration Section: | ActionName or Actions where ActionName is the name of an asynchronous action.
Example: | `OnQueueEvent=EventHandler`
See Also: | Event Handler Configuration OnStart OnFinish OnError QueueEmptyingThreshold QueueFillingThreshold

Copyright 2025 Open Text
Version 26.1 | Last updated January 2026

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 Lithium Connector 26.1

Topic Title: OnQueueEvent