§Restart§Rerun and/or Restart Window (Under Control-M/Restart)

When Control-M/Restart is available, and the job scheduling definition of a job whose execution fails contains a DO IFRERUN statement, the job can be restarted.

Manual intervention is required for the job restart in the following cases:

No DO RERUN statement is defined following the DO IFRERUN statement in the job scheduling definition. In this case, the job appears in the Active Environment screen with a failed job status.
The CONFIRM field of the DO IFRERUN statement contains a value of Y (Yes). In this case, job appears in the Active Environment screen with a failed job status.
No maximum number of reruns is defined in field MAXRERUN, or the maximum number reruns defined in field MAXRERUN has been performed. In this case, the job appears in the Active Environment screen with a status of ENDED NOT "OK" – RERUN NEEDED.

To manually request rerun and/or restart for such a job, enter option R (Rerun) for the job.

The following confirmation window is opened when either option R (Rerun) or option C (Confirm) is entered in the Active Environment screen for a job requiring rerun and/or restart under Control-M/Restart.

Figure 56 §Restart§ Active Environment Rerun and/or Restart Confirmation Window

Filter: ------- CONTROL-M Active Environment ------ DOWN <D> - (3)

COMMAND ===> SCROLL ==> CRSR

O Name Owner Odate Jobname JobID Typ ----------- Status ------------

DAILYPRD PRODMNGR 110405 JOB Wait Schedule

DAILYSYS SYSTEM 110405 +---------------------------------(3.R)+

IOALDNRS PRODMNGR 110405 | Job IEFBR14 Is to be Rerun |

IOACLCND PRODMNGR 110405 | Please Confirm (Y/N) |

R IEFBR14 K39 110405 | With Restart N (?/Y/N) | o CC

| ---------------------------------- |

| Verify JCL N (Y/N) |

IEFBR14 N98A 110405 | Rerun if fails N (Y/N) |

IEFBR14 K39 110405 | ---------------------------------- |

IEFBR14 K39A 110405 | From Step/Proc . |

IEFBR14 K39A 110405 | To Step/Proc . |

========= >>>>>>>>>>>>> | Recapture Abend Codes (Y/N/R) | < ========

| Recapture Cond Codes (Y/N/R) |

| Step Adjustment (Y/N) |

| ---------------------------------- |

| Flow Rerun |

| (Type 'R' to change options) |

| Forward Flow |

| Backward Flow |

| View Jobs in Flow |

| ---------------------------------- |

Opt: ? Why L Log H Hold Z Z| Restart Parm Member Name IEFBR14 | ys. E JVer

N Net D Del F Free S S+--------------------------------------+ m 08.36.28

Fill in the fields of the window as follows, and press Enter:

Table 75 §Restart§ Fields of the Active Environment Rerun and/or Restart Confirmation Window

Field	Description

Confirm	Valid values are: Y (Yes) – Job rerun is requested. The job is returned for possible resubmission by Control-M (provided that all runtime conditions are met). The status of the job is changed according to the value of the With Restart field. N (No) – No action is taken. The job is not rerun. The status of the job remains unchanged.
With Restart	This field is applicable only if Y is entered for Confirm. If N is entered for Confirm, this field is ignored. Valid values are: Y (Yes) – When the job is rerun, it is restarted using the Restart facilities of Control-M/Restart. The status of the job is changed to WAIT SCHEDULE (WITH RESTART). N (No) – The Restart facilities of Control-M/Restart are not used. The status of the job is changed to WAIT SCHEDULE. ? – Opens the Restart Step List window, which contains a list of the job’s steps. This list can then be used for specifying From Step and To Step values. For more information, see Step List Window.
Verify JCL	Whether to perform the JCL verification before the rerun. Valid values are: Y (Yes) – Perform the verification. N (No) – Do not perform the verification.
Rerun if fails	When the verification fails, whether to continue and perform the rerun or to stop the rerun process. Valid values are: Y (Yes) – Proceed and perform the rerun. N (No) – Stop the rerun process.
From Step/Proc	The pgmstep (and optionally procstep) names at which the restart of the job is to be attempted.
To Step/Proc	The pgmstep (and optionally procstep) names at which the restarted job terminates processing. Optional. The From Step/Proc and To Step/Proc fields display from and to step values specified in the DO IFRERUN statement. These values may be modified. If a From Step/Proc value is specified, and the To Step/Proc field is blank, the job is rerun up to and including the last step.
Recapture Abend Codes	Whether to enable abend code recapture. This field is applicable only if Y is entered for WITH RESTART. (If N is entered for WITH RESTART, this field is ignored.) Valid values are: Y (Yes) – Automatic abend code recapture is performed. N (No) – Abend code recapture is prevented. R (RESET) – Abend code reset is performed. ' ' (Blank) – The job member or the $DEFAULT member in the CTR.PARM library is used. If the $DEFAULT member is not found, the Control-M/Restart default is used to perform the recapture.
Recapture Abend Codes	Note: If ordering a restart of a job from a step after an abended step, type N in this field. If not, only steps that specify the JCL parameters COND=ONLY or COND=EVEN run during restart.
Recapture Cond Codes	This field is applicable only if Y is entered for With Restart. (If N is entered for With Restart, this field is ignored.) Valid values are: Y (Yes) – Automatic condition code recapture is performed. N (No) – Condition code recapture is prevented. R (RESET) – Condition code reset is performed. ' ' (Blank) – The job member or the $DEFAULT member in the CTR.PARM library is used. If the $DEFAULT member is not found, the Control-M/Restart default is used to perform the recapture.
Step Adjustment	This field is applicable only if Y is entered for With Restart. (If N is entered for With Restart, this field is ignored.) Valid values are: Y (Yes) – Automatic step adjustment is performed. N (No) – Step adjustment is prevented. ' ' (Blank) – The job member or the $DEFAULT member in the CTR.PARM library is used. If the $DEFAULT member is not found, the Control-M/Restart default is used to perform the step adjustment.
Note: Values specified for Recapture Abend Codes, Recapture Cond Codes and Step Adjustment override all other parameter specifications and the default. They apply to the current restart only.
Flow Rerun	Whether to open the Flow Rerun Options window. Type R in this field to open the window.
Forward Flow	This is a display only field that indicates whether to enable the restart of a successive series of jobs, beginning with the selected job: Y (Yes) – The job is restarted along with all its successor jobs. N (No) – Only the selected job is restarted.
Backward Flow	This is a display only field that indicates whether to enable the restart of a preceding series of jobs, ending with the selected job: Y (Yes) – The job is restarted along with all its predecessor jobs. N (No) – Only the selected job is restarted.
View Jobs in Flow	This is a display only field that indicates whether to generate a Rerun Flow Job List. This list enables the user to select specific jobs (or SMART Table Entity) in the selected flow or flows to be restarted. For more information, see Rerun Flow Job List Window. Y (Yes) – The Flow Rerun Job List screen is displayed. The list contains: — The job's successors (if Y was specified in Forward Flow) — The job’s predecessors (if Y was specified in Backward Flow) — The jobs’s successors and predecessors (if Y was specified in both fields). N (No) – The Rerun Flow Job List is not displayed. If the job is a SMART Table Entity, and Y was not specified in either the Forward Flow or Backward Flow fields, the generated list contains the jobs in the SMART Table. (If Y was not specified in either of the fields, and the job is not a SMART Table Entity, then this value is ignored and no list is displayed.)
Restart Parm Member Name	Name of the member that contains control parameters for the job restart. The specified value must be a valid member name of 1 through 8 characters. The default value, displayed in the window, is the member that contains the JCL of the job. This member is either the value in the MEMNAME field of the Zoom screen, or the NAME field of the Active Environment screen.

Note the following points about From Step/Proc and To Step/Proc values:

Pgmstep name can be any specific program step name or $FIRST. $FIRST resolves to the first step of the job if procstep name is blank. Otherwise, $FIRST resolves to the first step in the procedure identified by procstep.
$ABEND and $EXERR are not recognized by Control-M/Restart and must not be specified as restart steps in this window. ($ABEND and $EXERR are valid only in job scheduling definitions.)
If specifying a procstep name when there are nested procedures, specify the procstep name of the innermost procedure in which the program is included.
Entering $FIRST in the first From Step/Proc field followed by $CLEANUP in the adjacent (second) From Step/Proc field reruns the job for Cleanup (that is, run the Control-M/Restart cleanup step and flushes the job). All other parameters entered in the Restart window are ignored.

Note: AutoEdit resolution is performed at time of cleanup job submission. For example, if a job with AutoEdit date variable %%DATE is submitted for cleanup the day after the original run, the resolution of the variable during cleanup varies from that of the original run.

The RERUN request and, in Control-M/Restart, the RESTART decision are recorded in the IOA Log file. If the Control-M monitor is active, the RERUN request is accepted after a few seconds.

Parent Topic

Tracking and Control Facility