Setting up ESP Workload Automation backup and recovery

Products

• ESP Workload Automation

Issue/Introduction

How do you set up backup and recovery for ESP Workload Automation files?

Environment

Component: ESP WORKLOAD AUTOMATION 
Release:   12.0

Resolution

Backup and recovery can be done for the following key files:

HISTFILE
EVENT
INDEX
JOBINDEX
JOBSTATS
USERDEF

The backup datasets can be defined in the init parm. The scheduled times that these backups run depends on the file as listed above. The files and the commands that set the backup schedule are listed below. To start the backups, each file has a command that starts with BKUP. For example, BKUPEVS to backup the event data set. In addition, the history file also can be scheduled for a backup as defined in the init parm.

In addition to static backups, the product also can record all changes to the files. So if backup is done on Friday and then recovered on Sunday, all changes to the files can be applied. This is called JOURNALING. Each change to a file is recorded in an SMF record and these records are read in when a recovery is done.

This is how journaling is set up:
In the INIT parms add a SMFREC record for the SMF record number to use. 
For example:  SMFREC 200

This will use SMF record 200 for journaling of file changes. This SMF record number must be unique.
Then in each of the files being backed up, the JOURNAL option should be specified in their init parm.

To restore a dataset, issue the restore command. The following is an example:

//RESTORE JOB...        
//STEP01 EXEC PGM=ESP,PARM='SUBSYS(ESPx)' 
//STEPLIB  DD DSN=your.esp.loadlib,DISP=SHR
//SYSPRINT DD SYSOUT=*
//JOURNAL  DD DSN=hlq.BACKUP(0),DISP=SHR
//         DD DSN=hlq.BACKUP(-1),DISP=SHR
//SYSIN DD *
   UTIL
   RESTORE HISTFILE('hlq.HISTFILE') +
   NEWDSNAME('hlq.NEW.HISTFILE') +
   BACKUP('hlq.BACKUP.HISTFILE') +
   SMFID(200)
/*

In the above example,  the DD JOURNAL points to the datasets that contains SMF records. The SMF records in the file must be for the time period between the backup and the restore(all the updates).

Perform the above for each file that was backed up. For the remaining files, they need to be restored from pack backups(DFDSS) or reformatted. This is all dependent on the file.