Open topic with navigation

TIBCO iProcess® Engine 11.10.0

# Purging Cases

The following command instructs the iProcess background process to purge one or more cases of a procedure. This is a command line option only.

Note | This command requests confirmation from the user (with an “Are you sure you want to do this” message), but this may be suppressed with a `-y` flag on the end of the command line enabling it to be run from a batch file. If you want to purge a large number of cases you should consider using the `swbatch` utility instead. See Batch Processing Cases.

To purge one or more cases of a procedure, enter one of the following commands:

    swutil PURGE procname caselist [-y] [-d] [-P priority]
    swutil PURGE procname ALL_CASES [-y] [-d] [-P priority]
    swutil PURGE procname dd_mm_yyyy [-y] [-d] [-P priority]

where:

| • | `procname` is the procedure name. If the named procedure has sub-procedures, the cases for the sub-procedures will also be purged.

| • | `caselist` is a list of case numbers to be purged separated by commas and with hyphens denoting ranges of case numbers, for example: `2,5-10` denotes case 2 and cases 5 to 10 inclusive. All cases in the range are purged whether they are open or closed.

`ALL_CASES` denotes all cases of the procedure whether they are open or closed.

| • | `dd_mm_yyyy` purges all cases terminated up to and including a particular date, which is specified as the day, month and year numbers (in that order) separated by underscores.

| • | `-y` suppresses the request for confirmation from the user.

| • | `-d` purges cases without triggering events that are set for the `OnBeforePurge` event. If you are running the `swutil PURGE` command without the `-d` option, these events are triggered before purging the case. For more information about the `OnBeforePurge` event, see TIBCO iProcess Modeler Procedure Management.

| • | `-P` `priority` specifies the internal message queue priorities. For more information about message priorities, see "Message Prioritizing" in the appropriate TIBCO iProcess Engine (Database) Administrator’s Guide.

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO iProcess® Engine

Copyright © 1994-2025. Cloud Software Group, Inc. All Rights Reserved.