This procedure removes all log records from the "System Maintenance Log" table (x_log) that are older than a system-calculated date.
A report is created that shows the purge specifications and summary statistics. In addition, you may choose to have the report include the detail of each deleted record. This report can be viewed in a Web browser (if you run the purge online), printed in one or more copies on one or more printers, emailed to a list of recipients, faxed to a list of recipients, or any combination of these options.
Also, you may choose to add all deleted records to an archive textfile named "x_log.d" in the directory specificed by the Archive Path value in the System Control Setup (on the Archiving tab). These records will be appended to the end of any existing file.
The archive file is created in an "export" format which allows the system administrator to easily reload some or all of these records into a database at some future time, if needed for some reason such as historical analysis or security audits.
Since the purge procedure may take some time to run if there are many records to be deleted, you may wish to schedule it to run in the background (immediately or at a scheduled time in the future). If your security permissions do not allow you to schedule background jobs, you should arrange for another person whose User ID does allow background scheduling to run this procedure.
The records that will be deleted are system maintenance log records whose "Log date" is older than a specified Retention Date.
The Retention Date is calculated as (today - "n" days), where "n" is the "Maintenance Logs" retention days value in the System Control Setup (on the Archiving tab).
Check the "Export . . ." checkbox if you want to save deleted records in an archive text file.
Check the "Print . . ." checkbox if you want the detail of each deleted record to be included in the report.
Click the Submit button to open the Output Routing and Scheduling window. After you have completed your entries in that window and clicked OK, you will be returned to this window and the host will be sent your purge specs, output routing specs and scheduling specs.
If you chose to run this purge in the background, you will receive a message that the job has been scheduled to run at the time you specified, and you can then select the Exit button or menu item to close this window.
If you chose to run this purge online, you must wait until the purge is completed before closing this window.
If you chose to view the report in a browser, a message will appear when the report is ready to view, and you can click the View button to display the report as a Web page in a Web browser window.
If you chose only printer, email or fax output, a message will appear informing you that the output is completed, and you can then select Exit to close this window.
If you started this procedure by mistake and do not want to run it, click the Exit button immediately and do NOT click the Submit button. If you decide to cancel after clicking the Submit button and while the Output Routing and Scheduling window is opened, you can click the Cancel button in that window and then click Exit in this window. Either way, this window will close WITHOUT running the purge procedure.