purge_change_lists (SAP CC 5.0 Admin+)

purge_change_lists

Definition

To delete the transported change lists created before a specified date

Command Usage

Syntax

purge_change_lists <REF_DATE>

Command Arguments

Name	Description
`<REF_DATE>`	The reference date (ISO 8601 date format: yyyy-MM-ddTHH:mm:ss), used to delete the change lists created before this date.

Detailed Information

The purge_change_lists command deletes all the change lists which:

Have been created before the specified date
Have already been transported, which means related to an executed transport request

This command deletes data located in the TRANSPORT_REQUEST, TRAN_DESTINATION, CHANGE_LIST, CHAN_OBJECT and CHAN_OBJECT_SNAPSHOT tables of the Core database.

Caution

The execution of the purge_change_lists command may take time, depending on the quantity of technical data which must be removed. To avoid latency, we highly recommend you to perform this operation during off-peak periods.

Note

The purge_change_lists command returns to the command prompt only when all the elements concerned by the operation have been deleted.

Technical Operations: Purging and Archiving

You use this command to purge the change lists which have already been transported.

Authorization

To work with this command in the user interface, you must have a specific role in your SAP CC user profile.

Refer to the SAP CC 5.0 Security Guide for more user assistance and information about the necessary authorizations.

Additional Information

Consult the SAP CC 5.0 Operations Guide for more information about the periodic tasks.

Messages

Code	Message	Action
invalidToDate	The date specified does not respect the ISO 8601 format (yyyy-MM-ddTHH:mm:ss): {toDate}
purgeChangeListsStarted	The purge operation of change lists started at ''{date}''
purgeChangeListsEnded	The purge operation of change lists ended at ''{date}''
purgeChangeListsProcessed	The deletion of ''{processedCount}'' change lists before ''{toDate}'' successfully ended.
purgeChangeListsNothingToProcess	No change list has to be deleted before ''{}''.