Maintaining previous runs in the History Jobs file

Under Control-M, active jobs are maintained in the Active Jobs file. Once these jobs are ended and likely no longer needed, they are generally deleted from the Active Jobs file during maintenance. However, if Control-M/Restart is used at the site, these job runs can be placed in the History Jobs file before being deleted from the Active Jobs file, in case they are needed again. Jobs in the History Jobs file can be restored back to the Active Jobs file.

Whether a job is placed in History Jobs file, and for how long it remains, depends on either of two RETENTION parameters in the job scheduling definition:

• The RETENTION - # OF DAYS TO KEEP parameter indicates the maximum number of days the job remains in the History Jobs file before being deleted.
• The RETENTION - # OF GENERATIONS TO KEEP parameter indicates the maximum number of generations of the job to keep in the History File. Once that number of generations is reached, older job runs are deleted for each new job run added to the file.

Retention of jobs in the History Jobs file is available only for jobs that are run under Control-M.