OPTION XMPURGE-BY-DATE

The following is the FileMan Entry for the option [XMPURGE-BY-DATE]

Whether this option should be scheduled, or whether XMAUTOPURGE or XMPURGE should be scheduled instead depends on the policy of the VistA System Manager

Select OPTION: INQUIRE TO FILE ENTRIES  

OUTPUT FROM WHAT FILE: OPTION// 
Select OPTION NAME: XMPURGE-BY-DATE       Purge Messages by Origination Date
ANOTHER ONE: 
STANDARD CAPTIONED OUTPUT? Yes//   (Yes)
Include COMPUTED fields:  (N/Y/R/B): NO// BOTH Computed Fields and Record Number
 (IEN)
DISPLAY AUDIT TRAIL? No//   NO

NUMBER: 1999                           NAME: XMPURGE-BY-DATE
  MENU TEXT: Purge Messages by Origination Date
  TYPE: run routine                     CREATOR: DEADMOND,COLIN
  LOCK: XMMGR                           PACKAGE: MAILMAN
 DESCRIPTION:   You must hold the XMMGR and XMSTAR keys to run this option.  
  
 XMPURGE-BY-DATE will delete *all* messages originating before a cutoff date.
 It will delete those messages from users' mailboxes, and then delete them from
 the MESSAGE file, along with any responses chained to them. This flexible
 option can be run interactively or scheduled to run on a recurring basis, the
 cutoff date can be controlled, users may or may not be sent a warning bulletin
 to warn them of the purge ahead of time, and the option may produce a report
 to show how many messages and responses it deleted.  
  
 When the option is run interactively: 
  
 1) It asks for the cutoff date. The default is based on the DATE PURGE CUTOFF
 DAYS field (10.03) in the MAILMAN SITE PARAMETERS file (4.3). If that field is
 null, it defaults to 730 days (2 years) in the past.  
  
 2) It asks whether to run the option in Test mode. In Test mode, the option
 will not purge any messages, just report how many and which would have been
 purged.  
  
 3) It asks for the output device on which to print the report. The purge and
 report can be queued here to run later.  
  

Enter RETURN to continue or '^' to exit: 
 4) If it's queued more than 3 days in the future, the option immediately 
 broadcasts the XM DATE PURGE WARNING bulletin to all users to notify them of
 the upcoming purge and give them a chance to save off old messages beforehand. 
  
 5) If it's queued less than 3 days in the future, or is not queued, no 
 bulletin is sent.  
  
 When the option is scheduled: 
  
 1) The option runs at the scheduled time, as specified by the QUEUED TO RUN AT
 WHAT TIME field (2) of the OPTION SCHEDULING file (19.2).  
  
 2) If the RESCHEDULING FREQUENCY field (6) of file 19.2 is set, the option is
 scheduled to run repeatedly.  
  
 3) It uses the DATE PURGE CUTOFF DAYS field, or the default of 730 days if 
 it's empty, to calculate the cutoff date.  
  
 4) It does not run in Test mode.  
  
 5) If the DATE PURGE GRACE PERIOD field (10.04) of file 4.3 is empty, the 
 purge runs at the time for which the option is scheduled.  
  
 6) Otherwise, at the scheduled time the option only broadcasts the XM DATE 
 PURGE WARNING bulletin to all users and queues a second task to perform the
 date purge GRACE PERIOD number of days later.  
  
 7) If the DEVICE FOR QUEUED JOB OUTPUT field (3) of file 19.2 is empty, the
 purge runs without printing a report.  
  
 8) Otherwise it prints the report on the selected device.  
  

Enter RETURN to continue or '^' to exit: 
 *Messages in SHARED,MAIL's mailbox and messages in the POSTMASTER's remote
 transmit queues and server baskets (including released patch messages on
 FORUM) are exempt from the purge.  
  ROUTINE: ENTER^XMA32                  SCHEDULING RECOMMENDED: YES
  UPPERCASE MENU TEXT: PURGE MESSAGES BY ORIGINATION 



Select OPTION NAME:    XMPURGE-BY-DATE     Purge Messages by Origination Date
ANOTHER ONE: 
STANDARD CAPTIONED OUTPUT? Yes//   (Yes)
Include COMPUTED fields:  (N/Y/R/B): NO// ^




Select OPTION:    INQUIRE TO FILE ENTRIES



OUTPUT FROM WHAT FILE: OPTION// 
Select OPTION NAME:    XMPURGE-BY-DATE     Purge Messages by Origination Date
ANOTHER ONE: 
STANDARD CAPTIONED OUTPUT? Yes// N  (No)
FIRST PRINT FIELD: [CAPTIONED        
  
Include COMPUTED fields:  (N/Y/R/B): NO// BOTH Computed Fields and Record Number
 (IEN)
DISPLAY AUDIT TRAIL? No//   NO
Heading (S/C): OPTION LIST// 
DEVICE:   VIRTUAL    Right Margin: 80// 
OPTION LIST                                             PAGE 1
--------------------------------------------------------------------------------


NAME: XMPURGE-BY-DATE
  MENU TEXT: Purge Messages by Origination Date
  TYPE: run routine                     CREATOR: SYSTEM,MANAGER
  LOCK: XMMGR                           PACKAGE: MAILMAN
 DESCRIPTION:   You must hold the XMMGR and XMSTAR keys to run this option.  
  
 XMPURGE-BY-DATE will delete *all* messages originating before a cutoff date.
 It will delete those messages from users' mailboxes, and then delete them from
 the MESSAGE file, along with any responses chained to them. This flexible
 option can be run interactively or scheduled to run on a recurring basis, the
 cutoff date can be controlled, users may or may not be sent a warning bulletin
 to warn them of the purge ahead of time, and the option may produce a report
 to show how many messages and responses it deleted.  
  
 When the option is run interactively: 
  
 1) It asks for the cutoff date. The default is based on the DATE PURGE CUTOFF
 DAYS field (10.03) in the MAILMAN SITE PARAMETERS file (4.3). If that field is
 null, it defaults to 730 days (2 years) in the past.  
  
 2) It asks whether to run the option in Test mode. In Test mode, the option
 will not purge any messages, just report how many and which would have been
 purged.  
  
 3) It asks for the output device on which to print the report. The purge and
 report can be queued here to run later.  
  
 4) If it's queued more than 3 days in the future, the option immediately 
 broadcasts the XM DATE PURGE WARNING bulletin to all users to notify them of
 the upcoming purge and give them a chance to save off old messages beforehand. 
  
 5) If it's queued less than 3 days in the future, or is not queued, no 
 bulletin is sent.  
  
 When the option is scheduled: 
  
 1) The option runs at the scheduled time, as specified by the QUEUED TO RUN AT

 WHAT TIME field (2) of the OPTION SCHEDULING file (19.2).  
  
 2) If the RESCHEDULING FREQUENCY field (6) of file 19.2 is set, the option is
 scheduled to run repeatedly.  
  
 3) It uses the DATE PURGE CUTOFF DAYS field, or the default of 730 days if 
 it's empty, to calculate the cutoff date.  
  
 4) It does not run in Test mode.  
  
 5) If the DATE PURGE GRACE PERIOD field (10.04) of file 4.3 is empty, the 
 purge runs at the time for which the option is scheduled.  
  
 6) Otherwise, at the scheduled time the option only broadcasts the XM DATE 
 PURGE WARNING bulletin to all users and queues a second task to perform the
 date purge GRACE PERIOD number of days later.  
  
 7) If the DEVICE FOR QUEUED JOB OUTPUT field (3) of file 19.2 is empty, the
 purge runs without printing a report.  
  
 8) Otherwise it prints the report on the selected device.  
  
 *Messages in SHARED,MAIL's mailbox and messages in the POSTMASTER's remote
 transmit queues and server baskets (including released patch messages on
 FORUM) are exempt from the purge.  
  ROUTINE: ENTER^XMA32                  SCHEDULING RECOMMENDED: YES
  UPPERCASE MENU TEXT: PURGE MESSAGES BY ORIGINATION