Publishing Engine Programmer's Guide > The Arbortext Publishing Engine Request Manager > Predefined Dynamic Components > Arbortext Queue Request Functions > Queued Transaction Management Functions > The f=qt-execute Request
  
The f=qt-execute Request
This function forces the queued transaction indicated by the id parameter to be executed as soon as possible. The Queued Transaction Scheduler will ignore the enabled and active states of the queue containing the transaction, as well as the transaction's hold state. It will make the transaction next in line by ignoring any transactions ahead of the target transaction.
The Queued Transaction Scheduler will not ignore the global com.arbortext.e3.transaction.maxConcurrentQueuedTransactions parameter or the maxConcurrentQueuedTransactions attribute on the Arbortext PE sub-process pool that will allocate a Arbortext PE sub-process to process this transaction.
There can be only one transaction designated to be next in line. If an f=qt-execute request specifies transaction A and then another f=qt-execute request specifies Transaction B before transaction A starts executing, transaction A will lose its special next-in-line status. The next transaction to execute would be B. Transaction A returns to its prior state and continues to follow the normal course of transaction scheduling.
If this request specifies an immediate request, a queued transaction that is executing or has finished, or if the id parameter does not identify an active transaction, this function will return an error.