Cleanup and maintenance of ESP and WA Restart Option Encore on EXHFILE History Data Set

Products

• ESP Workload Automation

Issue/Introduction

ESP WA Restart Option (Encore) stores information about jobs that are tracked by ESP.  These job history records are stored in the EXHFILE and are used for restart and rerun purposes.  The EXHFILE can grow very large and therefore old job history records must be purged regularly.  Records can be purged automatically using an installation setting or can be purged manually by running a job. 

The job history records on the EXH data set are processed in job groups. A job group consists of an initial run and all the restart runs. The job group concept prevents the purging of an initial job when a failed initial job is followed by a large number of unsuccessful restarts. A job group is considered complete when the most recent job is executed successfully.  The age of a job group is equal to that of its recent member.

Resolution

Instructions: 

- Automatic purging of old records:  set ESP init statement "ENCPARM PURGE JOB(jobmask)" on the Master and proxy subsystems.  
This statement can also be entered as a page mode command.  

Syntax: ENCPARM PURGE JOB(job-mask) [AGE(days)] [INCOMPLETEAGE(days)]  [KEEP(number)] [INCOMPLETEKEEP(number)]

If you do not specify the values for AGE, INCOMPLETEAGE, KEEP, INCOMPLETEKEEP, then ENCPARM PURGE uses the values initially set when the EXHFILE was formatted.  

Run job CYBRMQRY from the CD7YJCL sample library to see the current file retention values.

- Manual purging of old records: Run job CYBRMPRG from the CD7YJCL sample library.  ESP  and WA Restart Option can remain active while this job runs.

Note: Job CYBRMKEP from the CD7YJCL sample library can be used to change the file retention (AGE, INCOMPLETEAGE, KEEP, INCOMPLETEKEEP) values. ESP and WA Restart Option can remain active while this job runs.