Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Deferring items in an agent queue

Updated on August 25, 2021

You can defer a work item in an agent queue if the work item has a status of scheduled or immediate. Deferring a work item moves the item to the Broken queue and is useful when you do not want the agent to process the item and you do not want to delete the item.

To view agent queues, you must have the PegaRULES:SysOpsObserver role and to take actions on queue items, you must also have the PegaRULES:SysOpsAdministrator role.

  1. In the navigation pane of Admin Studio, click ResourcesAgent queues.
  2. Click Scheduled or Immediate.
  3. In the Queue(s) grid, click the queue that contains the items that you want to defer.
  4. Defer items using one of the following methods:
    • To defer individual items:
      1. In the Item(s) grid, select the items that you want to defer.
      2. Click Defer.

      A message is displayed indicating the number of items that were deferred.

    • To defer all items currently in the queue, click Defer All.

The request is submitted and deferral happens in the background. Depending on the number of items in the queue, deferring all items in the queue can take some time. As the items are being deferred, click Refresh to update the grid and the Total Items field in the status block.

Note: An empty queue might not be the result of this action because new items might be added to the queue after the defer request is submitted.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us