Organization and integrity of the current plan
HCL Workload Automation for Z is designed so that in most error situations, the current plan can be automatically recovered. If you need to recover the plan manually, see Customization and Tuning.
These data sets are used for current plan integrity:
- EQQCKPT
- Checkpoint data set
- EQQCP1DS
- Primary current-plan data set
- EQQCP2DS
- Alternate current-plan data set
- EQQCXDS
- Current plan extension data set
- EQQDBnn
- Current and inactive extended-auditing data logs
- EQQDBARC
- Extended-auditing data archive log
- EQQDLnn
- Current and inactive dual job-tracking logs
- EQQJTnn
- Current and inactive job-tracking logs
- EQQJTARC
- Job-tracking archive log
- EQQNCPDS
- New current-plan data set
- EQQNCXDS
- New current plan extension data set
- EQQSIDS
- Side information data set
However, the explanation of the current plan process uses
these logical terms to describe the current plan and its associated
data sets:
- Current plan
- Used when describing the current plan in general. The current plan consists of the active current-plan data set, the extension (CX) data set, and the side data set (EQQSIDS). These data sets are described later.
- Active current plan
- Refers to the current-plan data set that is currently in use within HCL Workload Automation for Z. It might be either EQQCP1DS or EQQCP2DS. Every time a current plan backup is performed, HCL Workload Automation for Z switches the active current plan to the other data set. For a detailed description of the current plan backup process, see The current-plan backup process.
- Backup current plan
- Refers to the current-plan data set that is not currently in use. This data set contains a backup copy of the current plan. It might be either EQQCP1DS or EQQCP2DS.
- Side information
- Refers to a file (EQQSIDS) that contains frequently referenced database information, ETT criteria, and configuration information.
- Current plan extensions
- Refers to a file that contains current special resource information. The current file refers to EQQCXDS, and the daily planning process creates EQQNCXDS.
- New current plan
- Refers to a new version of the current plan, which is created by one of the daily planning batch jobs. It always refers to EQQNCPDS.
- Current and inactive job-tracking log
- Refers to the data sets used to log updates to the current plan and to record auditing information for the requested files. You must use at least two job-tracking logs, referenced by ddnames EQQJT01 and EQQJT02. You can use up to 99 job-tracking logs. The job-tracking logs are used in a cyclic manner, HCL Workload Automation for Z automatically switches to the next available job-tracking log after a current plan backup. The data from the inactive data set is copied to the archive log, and the data set is considered emptied in preparation for future use. You should use at least 5 job-tracking logs (this is the default number specified by the JTLOGS keyword of the JTOPTS statement).
- Current and inactive extended-auditing data log
- If you specified AMOUNT(EXTENDED) in the AUDIT statement, refers to the data sets used to log updates to the databases and to record auditing information for the requested files. You must use at least two extended auditing data logs, referenced by ddnames EQQDB01 and EQQDB02. You can use up to 99 extended-auditing data logs. The extended-auditing data logs are used in a cyclic manner, HCL Workload Automation for Z automatically switches to the next available log after a current plan backup. The data from the inactive data set is copied to the archive log, and the data set is considered emptied in preparation for future use. You should use at least 5 extended-auditing data logs (this is the default number specified by the JTLOGS keyword of the JTOPTS).
- Current and inactive dual job-tracking log
- If the dual logging function has been requested, HCL Workload Automation for Z duplicates the job-tracking records in the corresponding dual job-tracking log. Dual logs are switched at the same time, and in the same sequence, as the job-tracking logs. So the number of dual job-tracking data sets is determined by the number of normal job-tracking data sets.
- Job-tracking archive log
- Represents the accumulated job-tracking data since the new current plan was created. When the job-tracking log is switched, the data from the inactive data set is appended to the archive log. The archive log is copied to the track-log data set referenced by the EQQTROUT ddname during the daily planning process. When HCL Workload Automation for Z takes over the NCP, the archive data set is emptied.
- Extend-auditing data archive log
- Represents the accumulated extended-auditing data since the new current plan was created. When the extended-auditing data log is switched, the data from the inactive data set is appended to the archive log. The archive log is copied to the extended-auditing data set referenced by the EQQDBOUT ddname during the daily planning process. When HCL Workload Automation for Z takes over the NCP, the archive data set is emptied.
- Checkpoint
- Refers to the EQQCKPT data set, which contains information about the current status of the HCL Workload Automation for Z system, including which current plan and job-tracking data sets are currently active.
The basic principle of current plan recovery is that if the active current plan becomes unusable for any reason, HCL Workload Automation for Z must always be able to create an up-to-date current plan from the backup current plan and the job-tracking logs. For detailed information about how HCL Workload Automation for Z creates a current plan again, see Customization and Tuning.