Cyclic

Indicates that the job must run at a designated time, interval of time. A non-cyclic job is a job, which if its scheduling criteria is satisfied, is ordered once by Control‑M on a given day (discounting reruns caused by a Rerun Job parameter or manual reruns). A cyclic job is rescheduled after execution for an additional possible execution. The job executes again only when the following circumstances occur:

The first run has completed.
The runtime schedule and execution parameters are still satisfied.

A specified number of minutes has elapsed since the last completion of the job or the next specified runtime has been reached.

The cyclic job runs at the time designated according to the time or time intervals selected. The Run at and the Tolerance parameters can be set to enable a job to run after the specified time. If the job being executed runs over the proceeding job’s specified time, the proceeding job’s execution time window is extended to the number of minutes set in the Tolerance field. For example, if the Tolerance field is set to 15 minutes, the proceeding job can still be executed 0-15 minutes after the specified time. If the tolerance time interval has passed, the proceeding job will not be performed.

NOTE: The Run at option is relevant for one odate only. Specific times are sorted from each new day time to the next.

Additional information	Description

Usage	Optional
Format	Check box Selected – job is cyclic Clear – job is not cyclic
Alternate names	Control‑M/EM Utilities: CYCLIC Control-M Report: CYCLIC Control‑M/Server Utilities: -cyclic Control‑M for z/OS: Cyclic Control‑M/EM API: cyclic
Sub-parameters
Rerun Every	Fixed interval values to rerun a job: Minutes: 0-64,800 Hours: 0-1080 Days: 0-45
All intervals are from job's	Valid Values: End Start Target
Rerun using the following interval sequence	List of time intervals: Unit: Minutes, Hours, Days Amount:0-64,8000; 0-1080; 0-45
Run at	A list of specific times for the job to run. NOTE: This parameter supports time synonym.
Tolerance	Maximum delay in minutes permitted for a late submission when selecting a specific time (e.g. 5 minutes). Valid range: 0-999

Note the following:

Ordering a cyclic job as "non-cyclic": The %%CYCLIC variable can be used to override the Cyclic parameter for a job, or for all jobs in a folder. This variable is normally used when ordering a cyclic job for a single run.
NOTE: To indicate that all jobs ordered by the ctmorder utility (in Control‑M/Server) should run as non-cyclic jobs, include the following statement in the command line of the ctmorder utility: -variable %%CYCLIC N
Maximum number of days to wait for submission: The CYCLIC_MAXWAIT parameter for Control‑M/Server determines when cyclic jobs, which have executed at least once, should be removed from the Active Jobs database by the New Day procedure. Valid values are:
- KEEP – Jobs are removed from the Active Jobs database when Keep Active for days have passed regardless of whether the job ended OK. Default.
- NOT_KEEP – Jobs (non-cyclic and cyclic) are removed from the Active Jobs database at the next run of the New Day procedure. Cyclic jobs are not removed if they are executing when the New Day procedure begins. Instead, they are removed at the run of the following New Day procedure.
  For more information about Control‑M/Server parameters, see Control-M/Server parameters in Control‑M Administration.
Terminating a cyclic job: Special care should be taken when specifying a cyclic job. If not defined appropriately it may cause an endless loop in which the job is continually resubmitted for execution. If a cyclic job is executing when the New Day procedure is run, the job is changed to non-cyclic and an appropriate message is written to the Control‑M log. It is the user’s responsibility to review these messages and handle them accordingly.
You can prevent subsequent iterations of a cyclic job by using the Do Stop Cyclic parameter. If a cyclic job is terminated by a Stop Cyclic Run parameter, the View Details screen displayed by option Z in the ctmpsm utility contains Cyclic:T where T indicates "Terminated".
For z/OS jobs: Cyclic jobs cannot contain Rerun Job.

Parent Topic

Scheduling Parameters