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.