2.21 PURGEOLDTASKS

Valid For

Manager

Description

Use the PURGEOLDTASKS parameter to purge Extract and Replicat tasks after a specific amount of time or after they have stopped gracefully. You can indicate when to delete a task according to the following rules:

  • The task was last started a specific number of days or hours ago. If the task never was started, its creation time is used as the basis for applying the rules.

  • The task stopped gracefully or never was started. This rule takes precedence over the time the task was last started. Use this rule to prevent abnormally terminated tasks from being purged.

No more than 300 PURGEOLDTASKS parameter statements may be used in the same Manager parameter file.

Default

None

Syntax

PURGEOLDTASKS {EXTRACT | REPLICAT | ER} group
{AFTER number {DAYS | HOURS} | USESTOPSTATUS}
EXTRACT | REPLICAT | ER

The process for which you want to purge tasks. Use the ER option to specify both Extract and Replicat process types.

group

The group name or a wildcard to specify multiple groups.

AFTER number {DAYS | HOURS}

Purges if the task has not been updated for a specified number of days or hours.

USESTOPSTATUS

Purges if the task was stopped gracefully or never was started.

Example

The following example deletes all Extract tasks that have not been updated for at least three days, and it deletes the test_rep Replicat task if it stopped gracefully and has not been updated for at least two hours.

PURGEOLDTASKS EXTRACT *, AFTER 3 DAYS
PURGEOLDTASKS REP test_rep, AFTER 2 HOURS, USESTOPSTATUS