Specifying automatic restart for operations that fail

The automatic recovery function lets you specify, for each job or started task, automatic recovery actions for specific failures. You specify recovery actions by including HCL Workload Automation for Z recovery statements in the job. Automatic recovery parameters that refer to job steps are supported only for jobs that execute on z/OS systems.

If automatic job recovery fails or if a job does not have recovery statements when it fails, you can modify the job and create or change the recovery statements. Use the J row command on the HANDLING OPERATIONS ENDED IN ERROR panel to edit the job. The EDITING JCL FOR AN MVS JOB panel in An example of RECOVER statements shows some recovery statements (1 to 3). The beginning of the recovery statement 1 has been changed from //*% to //*> showing that action has already been taken on the statement.

Figure 1. An example of RECOVER statements
EQQMJCLE ---------------- EDITING JCL FOR AN MVS JOB -------------------------
Command ===>                                                  Scroll ===> PAGE

Edit JCL below and press END to finish or CANCEL to reject:

Application           : PAYW              weekly payroll jobs
Operation             : CPU1 20           pay07, pay10, and pay16
Status of operation   : Ended in error    S0C4
Jobname               : PAYWEEK           JCL last updated by: XRAYNER

****** ***************************** TOP OF DATA *****************************
000001 //PAYWEEK  JOB  (890122,NOBO),'SAMPLE',
000002 //       MSGCLASS=H,NOTIFY=XRAYNER,CLASS=A
000003 //OUTPUT1  OUTPUT DEST=LAB21,DEFAULT=YES
000004 //*>OPC SCAN
000005 //*       PAYMORE PAYROLL SAMPLE -- PAYWEEK
000006 //*       THIS JOB RUNS PAY07, PAY10, AND PAY16
000007 //*>OPC RECOVER ERRSTEP=PAY07,RESTART=NO                1
000008 //*%OPC RECOVER ERRSTEP=PAY10,STEPCODE=4,TIME=2000-0400 2
000009 //*%OPC RECOVER ERRSTEP=PAY16,ADDAPPL=PAYRECOV          3
000010 //*
000011 //* OPC MSG:
000012 //* OPC MSG: I  ***  R E C O V E R Y   A C T I O N S   T A K E N  * * *
000013 //PAY07    EXEC PGM=PAY07,PARM='4'
000014 //STEPLIB  DD DSN=XRAYNER.OPC.LOADLIB,DISP=SHR

You can add further recovery directives to the job, save the job, and initiate recovery by entering the ARC row command beside the failing operation on the HANDLING OPERATIONS ENDED IN ERROR panel.

You can also use the ARC command to initiate recovery outside the hours specified for automatic recovery.

If a request to start automatic recovery is received while a restart and cleanup action is still in progress, the request is denied.