AngeliaSchedulerTM - On-Line Help - Completed Task Purging Options
Completed Task Purging Options are those that determine what happens to tasks once completed (or
aborted or cancelled). If completed tasks are not removed from the Configuration Database from time to time, the
size of that database will eventually get too large and adversely impact performance. Therefore, configuring the
system to automatically purge completed task on some reasonable basis is recommended. The options available are as follows:
- Completed Task Purging Status – determines whether or not Completed Task purging is
allowed at all (the default and recommended setting is "On").
- Automatically Purge Completed Tasks – turns Automatic Completed Task Purging on and
off – meaningless unless "Completed Task Purging Status" is enabled ("On"). If Completed
Task Purging Status is enabled and Automatically Purge Completed Tasks is disabled then only manual purging (ie –
purging initiated by a Remote Queue Manager user) can occur.
- Completing Task Triggers Auto Purge – meaningless if either Automatically Purge Completed
Tasks or Completed Task Purging Status are disabled. When this setting is enabled (set to "Yes"),
a queue will be evaluated for purging of completed tasks whenever a task executing on that queue completes.
If disabled (set to "No") then Automatic Purging will occur daily for all queues at the time specified
in Auto Purge Scheduled Time Of Day (see below).
- Auto Purge Scheduled Time Of Day – if Completing Task Triggers Auto Purge is
"No" but Auto Purging is enabled, then all queues will be purged once each day at the time specified in
this item (hh:mm[:ss]).
- Protect Tasks From Purging Basis – whenever a queue is purged, some completed tasks may be
allowed to remain on the queue. The basis for this decision may be either number of tasks to retain
("Task") or maximum age in days of tasks to retain ("Day"). If "Task" then the
number of tasks specified in the "Keep Task" items below will be retained. If "Day" then
only tasks older than the number of Days specified in the "Keep Task" items below will be retained.
In either case, use "0" (zero) if you do not wish any completed tasks to be retained.
- Keep Aborted Task (Days or Tasks) – maximum age in days or maximum number of tasks to be
retained that were completed in "Aborted" status (ie – they were terminated via Remote Queue Manager
"Abort Task" status setting while they were running).
- Keep Cancelled Task (Days or Tasks) – maximum age in days or maximum number of tasks to
be retained that were completed in "Cancelled" status (ie – they were terminated via Remote Queue Manager
"Cancel Task" status setting prior to execution).
- Keep Completed Task (Days or Tasks) – maximum age in days or maximum number of tasks to be
retained that were completed normally.
- Keep Failed Task (Days or Tasks) – maximum age in days or maximum number of tasks to be
retained that were completed but "Failed".