Purge the trading engine

Use the messagePurgeTool to delete all database records and files in the backup directory at once. This command-line utility is located in <Activator_install_directory>\Activator\tools. You must run the tool from this directory.

This tool has special options for use in DB2 environments. See parameter descriptions below.

Caution   Make sure the Activator server is turned off before using messagePurgeTool. This includes servers on all machines if you have a cluster environment.

Parameters

Run messagePurgeTool with one of the following parameters. You can only use one parameter at a time.

deleteAll

deleteAllSkipFiles

Deletes all records in the database, but does not delete backup files. If you have a large number of records, this option works faster than the deleteAll option. However, if you use it, you must manually delete backup files. For example, by deleting the backup directory.

resetMessages

Changes the purge dates of records in the database and of documents in the back-up directory. When messages are processed, the trading engine assigns future purge dates, based on the age interval set on the purge configuration page in the user interface. If you change the age interval, you can use the resetMessages option to change purge dates of existing records and documents in line with the changed interval.

For example, if the interval is 45 days, the system sets the purge date for messages processed today as the date 45 days in the future. On day 44, you change the interval to 90 days and then run the resetMessages option. The system re-calculates the purge dates of existing messages as 90 days in the future of the messages’ origination dates. This means on day 44, the purge date is set ahead 46 additional days, for a total of 90 days before purging.

The utility may take a while to run with this option if there are a large number of records to reset. See Configure automated trading engine purge.

Example

To delete all records in the database and all related backup files, run the following command:

messagePurgeTool -deleteAll

Event logging

Events related to running the messagePurgeTool are written to the messagePurgeTool.log file in the <Activator_install_directory>/Interchnge/logs directory.

Related Links