BuildForge Help

Scheduling Purges

You can control when the system conducts purges of old jobs, by creating schedules for classes of jobs. You create these schedules just as you would create a schedule to launch a project, but you select the "Class Purge Schedule" option instead of a project. When you do this, the system checks for jobs to purge of the class you select at the time(s) you select in the schedule. For each job that qualifies, the system creates a purge job and puts the job in the waiting queue.

By default, the system checks for jobs that should be purged (based on the class properties which define rules for automatic deletion) at intervals set by the Purge Check Time system setting (which defaults to every 15 minutes). This behavior can lead to purges competing for system resources with ordinary jobs.

If you create a schedule for a class of job, the system only checks for jobs to purge when the schedule activates. If no schedule exists for a particular class, the system uses the default behavior for the jobs of that class. If you want to restrict all purges to specific times, you must create at least one schedule for each class.

To define a purge schedule, create a schedule as usual, but select "Class Purge Schedule" in the Project field. Then select a class in the Class field.

The following example shows how to set up a purge schedule to purge Production-class jobs on Saturdays at noon. With such a schedule in effect, on Saturdays at noon the system checks all the Production jobs, and schedules purge jobs for all the jobs that meet the Production class's deletion criteria.