The purge quue UI action allows you to purge a queue of all messages in it. This is useful if you ran a large bulk share and no longer want or need a subscriber to consume these messages.

(info) NOTEIn v3.24.0+ the user can no longer purge a queue that contains over 1 million records. The user must contact support to purge the queue.

(info) NOTEPurging queues is only supported if you have been provisioned in a vhost. Please contact support@perspectium.com to set this up and for more information.

Procedure

To purge a queue in your ServiceNow instance, follow these steps:


Access your shared queue 

Navigate to Perspectium > Replicator > Shared Queues and select the queue you want to purge.

Purge Queue

Under the Related Links, click Purge Queue. When clicked, purge queue will attempt to connect to the endpoint URL using the queue user and password to purge the queue of all the messages it currently contains. The result of trying to purge the queue will be displayed in the status field.

(warning) WARNING: Proceed with caution when purging a queue as the messages cannot be recovered.