Step Name: +EVERY

The value +EVERY is used without being accompanied by limiting step values when the code criteria must be satisfied for every step. The following examples all have the same impact – the code criteria must be satisfied for every step in the job without exception.

Note: A DO OK or DO NOTOK statement is ignored if it is specified in an ON PGMST +EVERY statement.

Examples

• ON PGMST +EVERY PROCST
• ON PGMST ANYSTEP PROCST +EVERY

  The ANYSTEP value is not a limiting value. In this case, it has the same meaning as +EVERY.

• ON PGMST +EVERY PROCST +EVERY

Value +EVERY is generally accompanied by a limiting step value when the code criteria must be satisfied for every step within the specified limits, as follows:

• If the limiting value is a PROCST value, the code criteria must be satisfied by all job steps from within the specified procedure.

  Example

  • ON PGMST +EVERY PROCST STEP1

  Every program step of procedure step STEP1 must be satisfied.

• If the limiting value is a PGMST value, the code criteria must be satisfied by all executions of the specified job step (or range of steps if a range is specified), from within the job steam and within all procedures.

  Examples

  • ON PGMST StepA PROCST +EVERY

  All executions of job step STEPA from within the job stream and within every procedure must be satisfied.

  • ON PGMST *Range1 PROCST +EVERY

  Executions of all job steps in Range1, from within the job stream and within every procedure, must be satisfied.

  Step name +EVERY can be specified with the following codes: Cnnnn, Sxxx, Unnnn, *xxxx, FLUSH, SNRUN and *****.

• When step name +EVERY is specified with codes Cnnnn, Sxxx, Unnnn and *xxxx, the following conditions must be satisfied to satisfy the ON statement:
  • If the steps that run (excluding FLUSH steps) satisfy the PGMST and PROCST criteria, they must also not contradict the Cnnnn, Sxxx, Unnnn or *xxxx codes.
  • At least one step runs and fulfills the above conditions.
• When step name +EVERY is specified with codes FLUSH, SNRUN or *****, the following apply:
  • ON PGMST +EVERY CODES FLUSH is satisfied if in each job step, a JCL COND or JCL IF/THEN/ELSE statement caused the step not to run.
  • ON PGMST +EVERY CODES SNRUN is satisfied if each job step did not run.
  • ON PGMST +EVERY CODES ***** is satisfied if each defined job step ran and no job step was flushed (that is, due to a JCL COND or JCL IF/THEN/ELSE statement).
• Force Control-M to end a job with a NOTOK status when every step in the job is flushed:

  ON PGMST +EVERY   PROCST          CODES FLUSH                       A/O A

  ON PGMST xxx      PROCST          CODES FLUSH                       A/O  

    DO NOTOK                                                               

  where the xxx is any one of the actual step names in the job stream that can be flushed.