Restarting jobs that recover application data


Restarting application data recovery jobs created online or by ARMBGEN uses the ARMBMJO program and the BMC AMI Recovery Manager JOB_RESTART table.

For the BMC AMI Recovery Manager JOB_RESTART table, see JOB_RESTART-table).

If any job or jobs in a multi-job set that recovers application data fails, you restart the job or jobs in one of the following ways:

Important

Do not code a RESTART parm on the JOB card.

  • Fix the problem and resubmit only the failing job or jobs. The ARMBMJO steps determine what jobs and steps need to be run.
  • If no jobs in the set are still executing, fix the problem and resubmit the entire JCL set. The ARMBMJO steps determine what jobs and steps need to be run.

    Important

    If a failing job is executing BMC AMI Recover using the UNLOADKEYS/BUILDINDEX strategy, for more information, see the BMC AMI Recover for Db2 documentation

Rerun or restart?

If any of the generated jobs fail, you must first determine what caused the failure and correct the situation. Then you should decide whether to rerun the entire job stream (by resubmitting the generated JCL) or restart the jobs at the point of failure.

You change the value of the PARM parameter in the ARMBMJO syntax to determine whether the jobs are to be rerun or restart. The following options are available:

  • To run the entire set of jobs for the first time, set PARM NEW/RESTART.

    A row is inserted in the JOB_RESTART table for the set of jobs, for each job, and for each step. All steps in all jobs will run.

  • To run the entire set of jobs after a failure without a restart, set PARM NEW.

    Edit the ARMBMJO syntax in the first job of the set changing NEW/RESTART to NEW. All steps in all jobs will run.

  • To run the entire set of jobs after a failure with restart set PARM NEW/RESTART.

    Submit the original set of JCL with no change. Only the steps that did not complete successfully will run.

  • To run an individual job from a set after a failure with restart set PARM NEW/RESTART.

    Submit only the failed job. Only the steps that did not complete successfully for that job will run.

  • To run an individual job from a set after a failure without restart, set PARM NEW.

    Edit the ARMBMJO syntax in the failed job and change NEW/RESTART to NEW. Submit only the failed job. All steps in the job will run. 

ARMBMJO CLEAR_TABLE

The ARMBMJO$ SAMPLIB contains the CLEAR_TABLE member. Run this member to delete all rows in the JOB_RESTART table. IDENTIFIER is optional, and if specified, deletes only rows for the named identifier.

CLEAR_TABLE
   SET_IDENTIFIER identifierName

This syntax is not generated by BMC AMI Recovery Manager. 

ARMBMJO report

The ARMBMJO$ SAMPLIB contains the following REPORT member:

REPORT
   SET_IDENTIFIER identifierName

Run this member to generate a report that selects all rows for the specified identifier and writes this information to a report similar to the one in the following figure. IDENTIFIER is optional and if it is not included, the report includes all rows in the JOB_RESTART table.

Notice that the report includes information at the following levels:

  • Set (set of jobs)—where the row in the report does not include information for either the JOBNAME or STEPNAME
  • Job—where the row in the report includes information for the JOBNAME but not the STEPNAME
  • Step—where the row in the report includes information for both the JOBNAME and the STEPNAME
IDENTIFIER: RDAJLW3.DEDL.D120325.T130826                                      
JOBNAME   STEPNAME  STATUS    EVENT     RC  START_TIME           END_TIME             OBJECTSET             UTILID

                    RESTART              0  2022-03-26-07.24.16  2022-03-26-07.25.30  PUBLIC.Q1642823_PART
JLW0001             COMPLETE             0  2022-03-26-07.24.16  2022-03-26-07.25.27
JLW0001   ARM0002   COMPLETE  DEL/DEF    0  2022-03-25-15.21.31  2022-03-25-15.22.58                        RDAJLW3.JLW0001
JLW0001   ARM0010   COMPLETE  RECOVER    0  2022-03-25-15.23.06  2022-03-25-15.23.14                        RDAJLW3.JLW0001
JLW0001   ARM0014   COMPLETE  REBUILDX   0  2022-03-25-15.23.18  2022-03-25-15.23.27                        RDAJLW3.JLW0001
JLW0001   ARM0019   COMPLETE  REPAIR     0  2022-03-26-07.25.26  2022-03-26-07.25.27                        RDAJLW3.JLW0001
JLW0002             COMPLETE             0  2022-03-26-07.24.16  2022-03-26-07.24.40
JLW0002   ARM0003   COMPLETE  RECOVER    0  2022-03-26-07.24.21  2022-03-26-07.24.27                        RDAJLW3.JLW0002
JLW0002   ARM0007   COMPLETE  REBUILDX   0  2022-03-26-07.24.28  2022-03-26-07.24.35                        RDAJLW3.JLW0002
JLW0002   ARM0012   COMPLETE  REPAIR     0  2022-03-26-07.24.38  2022-03-26-07.24.40                        RDAJLW3.JLW0002
JLW0003             COMPLETE             0  2022-03-26-07.24.18  2022-03-26-07.24.40
JLW0003   ARM0003   COMPLETE  RECOVER    0  2022-03-26-07.24.22  2022-03-26-07.24.28                        RDAJLW3.JLW00032012
JLW0003   ARM0007   COMPLETE  REBUILDX   0  2022-03-26-07.24.30  2022-03-26-07.24.36                        RDAJLW3.JLW0003
JLW0003   ARM0012   COMPLETE  REPAIR     0  2022-03-26-07.24.39  2022-03-26-07.24.40                        RDAJLW3.JLW0003
JLW0004             COMPLETE             0  2022-03-26-07.24.18  2022-03-26-07.24.33
JLW0004   ARM0003   COMPLETE  RECOVER    0  2022-03-26-07.24.22  2022-03-26-07.24.25                        RDAJLW3.JLW0004
JLW0004   ARM0007   COMPLETE  REBUILDX   0  2022-03-26-07.24.26  2022-03-26-07.24.29                        RDAJLW3.JLW0004
JLW0004   ARM0012   COMPLETE  REPAIR     0  2022-03-26-07.24.32  2022-03-26-07.24.33                        RDAJLW3.JLW0004
JLW0005             COMPLETE             0  2022-03-26-07.24.18  2022-03-26-07.25.30
JLW0005   ARM0004   COMPLETE  RECOVER    0  2022-03-25-15.23.41  2022-03-25-15.23.44                        RDAJLW3.JLW0005
JLW0005   ARM0008   COMPLETE  CHECKLPL   0  2022-03-26-07.25.24  2022-03-26-07.25.26                        RDAJLW3.JLW0005
JLW0005   ARM0012   COMPLETE  REBUILDX   0  2022-03-26-07.25.28  2022-03-26-07.25.30                        RDAJLW3.JLW0005


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*