Specific Range Name

Specifies a range of steps in the steps of an On PGMST statement.

Additional information	Description

Usage	Optional
Format	Consists of the Program and Return Status sub-parameters below.
Alternate names	Control‑M/EM Utilities: STEP_RANGE Control-M Report: Composed of the FROM PGMST, FROM PROCS TO PGMSTEP, and TO PROCSTEP parameters. Control‑M/Server Utilities: (none) Control‑M for z/OS: STEP RANGE Control‑M/EM API: step_range
Alternate formats
Control‑M/EM Utilities	STEP_RANGE is composed of the following parameters:
	NAME	1-7 character string.
	FPGMS	First program step in the range. 1-8 character string.
	FPROCS	First process step in the range. 1-8 character string.
	TPGMS	Last program step in the range. 1-8 character string.
	TPROCS	Last process step in the range. 1-8 character string.
Sub-parameters
Program	Defines the program name.
Return Status	See Code values.

Whenever a Specific Range Name statement is specified, it eliminates the need to define separate On PGMST, On PROCST, and On Codes statements and accompanying Do actions for each step in the range. The defined Specific Range Name can be used (without redefining the range) in subsequent On PGMST, On PROCST, and On Codes statements, by specifying the Specific Range Name, preceded by an asterisk (*), in the On PGMST field.

Any number of step ranges can be specified. After entering a Specific Range Name parameter, another Specific Range Name parameter line is automatically displayed.

Using all runs of a job including restarts

When processing On blocks, Control‑M can incorporate the results of all previous runs and restarts, filtering them for jobs restarted with the Control‑M for z/OS RESTART, RECAPTURE CONDITION or ABEND CODES parameters. Control‑M/Restart searches previous runs to determine which steps must be considered part of the restarted job.

For example, if one step finished successfully during its original run and another step finished successfully after a restart, the On block check for the successful finish for both steps produces a TRUE result and the On statement is satisfied.

Activation of this facility requires that the Control‑M for z/OS ALLRUNS parameter in the CTRPARM member be set to YES. When activated, this facility may apply to any specified step, step range, or to the +EVERY step value.

NOTE: For z/OS jobs only.

EXAMPLE: Control-M Properties Pane

Define program steps STEP20 through STEP29A as step range DF2. If any of these steps produce any system or user abend (except user abend U2030), rerun the job and sends a message to TSO-P43.

EXAMPLE: Control-M for z/OS interface

Define program steps STEP20 through STEP29A as step range DF2. If any of these steps produce any system or user abend (except user abend U2030), rerun the job and sends a message to TSO-P43.

JOB: PRDKPL01 LIB CTM.PROD.SCHEDULE FOLDER: PRODKPL

COMMAND ===> SCROLL===> CRSR

+-------------------------------------------------------------------------+

===========================================================================

OUT

AUTO-ARCHIVE Y SYSDB Y KEEP ACTIVE FOR MAXIMUM RERUNS

RETENTION: # OF DAYS TO KEEP 030 # OF GENERATIONS TO KEEP

OUPUT OP (C,D,F,N,R) FROM

MAXIMIM RERUNS RERUNMEM INTERVAL FROM

STEP RANGE DF2 FR (PGM.PROC) STEP20 . TO STEP29A .

STEP RANGE FR (PGM.PROC) . TO .

ON PGMST *DF2 PROCST CODES S**** U**** NU2030 A/O

RERUN JOB

NOTIFY TO TSO-P43 URGENCY R

= JOB PRDKPL03 ABENDED, THE JOB IS RERUN

ON PGMST PROCST CODES A/O

NOTIFY WHEN TO URGN

======= >>>>>>>>>>>>>>>>>>> END OF SCHEDULING PARAMETERS <<<<<<<<<<<<<<<< =====

COMMANDS: EDIT, DOC, PLAN, JOBSTAT 11.17.00

Parent Topic

On/Do Actions