Registry Start Purge Scheduled Events (sys-start-sprgeschdldevnt)

Purpose:

In version 6.1, this entry enabled you to implement the optional purge of all events (not just triggered and canceled) attached to closed work orders when the Purge Scheduled Events function is run. By default, only events over sixty days old will be purged. However, this registry entry also enables you to change the default number of days.

In versions 6.2 and up, the Purge function was altered so that it operates as follows:

1. Determine the Purge Thru date by applying the DaysToSave setting (if this registry setting does not include DaysToSave=#, 60 days will be used) to the current system date.

2. Purge ALL cancelled and executed events THAT ARE NOT WORK ORDER RELATED.

3. For Work Order Related Events: only purge those Scheduled Events belonging to Work Orders whose WO Escalation Status is set to Cancelled or Billed AND whose Date Closed makes it eligible for the purge.

4. When the purge is run, the Escalation Profile Rn will be dropped from Work Orders whose Events were purged. This is done to prevent the creation of undesirable new escalation events if someone edits a 'closed' work order.

Testing Your Registry Entries
The system does not verify the validity of registry entries. Be sure to test your registry entries after completing them to verify that they are functioning correctly.

Important Fields

Id:

sys-start-sprgeschdldevnt

Specify Number of Days Old to Purge

Version 7.1 Additional Contents: DaysToSave=#

Version 7.2 Setting Key: DaysToSave Setting Value: #

Where # is replaced by the number of days old an event must be to be purged. If you do not include this option, only events older than 60 days will be purged.

Purge All Events for Closed Work Orders

Version 7.1 Additional Contents:IncludeClosedWorkOrders=true (deprecated for V6.2 and up)

Version 7.2 and Up Setting Key: IncludeClosedWorkOrders Setting Value: true (default is false)

This setting is deprecated. If this option is included, the purge will affect all scheduled events older than the number of days to save – rather than just triggered and cancelled events.

Examples:

DaysToSave=30

IncludeClosedWorkOrders=true

When the Purge Scheduled Event function is run, all events older than 30 days will be purged from closed work orders.

DaysToSave=45

IncludeClosedWorkOrders=false

When the Purge Scheduled Event function is run, triggered and canceled events older than 45 days will be purged from work orders.

Restore original behavior (not recommended)

 RetainAllEventsForOpenWOs=false

 This registry entry is NOT recommended. If implemented, the following behavior will be in effect:

1. Determine the Purge Thru date by applying the DaysToSave setting to the current system date.
2. Purge ALL cancelled and executed events regardless of work order status. 
3. If IncludeClosedWorkOrders is True, eliminate all remaining events for closed work orders.  An example would be a contingent Alarm that never went 'active' and has an Event Status of OnHold.
4. Clear the Escalation Profile Rn for qualifying 'closed' work orders.  This is done to prevent the creation of additional escalation events in the event someone edits a 'closed' work order