Publishing Engine Programmer's Guide > The Arbortext Publishing Engine Request Manager > Predefined Dynamic Components > Arbortext Queue Request Functions > Queued Transaction Management Functions > f=qt-move
  
f=qt-move
This function moves a queued transaction up or down in its queue. The move may result in changing the transaction's priority.
In addition to id and response-format, this request requires two parameters:
direction (required)
Specifies either up or down ( not case sensitive). up moves the transaction toward the top of the queue, and down moves the transaction toward the bottom of the queue.
places (required)
Specifies either all or a positive integer to represent the number of transactions to bypass.
This function moves the transaction past the number of transactions specified by places in the direction specified by direction.
After the transaction is moved, the transaction's priority is adjusted as follows:
If the transaction was moved up, its priority is set to the priority of the transaction behind it.
If the transaction was moved down, its priority is set to the priority of the transaction ahead of it.
If the value of the places parameter is greater than the number of transactions the specified transaction can bypass, then the transaction is moved to either the head or end of the queue as specified by direction.
If this request specifies an immediate request, a queued transaction that has finished, or if the id parameter does not identify an active transaction, this function will return an error.