Maintaining Valid Job Scheduling Definitions

Since job scheduling definitions must be syntactically correct at all times, the user must consider the following issues when specifying Line Editing commands:

The result of a Line Editing command is dependent on the line on which the command is specified. For example, command D deletes either a single or a logical line based on the line type.
Logical lines form a unit and cannot be separated.
When a logical command is specified within a logical line, that is, on a subparameter line or an additional parameter line, the specified operation is performed on the entire logical line.
Block commands must be specified on the main lines of the block. For example, to delete an ON block, specify command DB (Delete Block) on the ON line.
Blank parameter lines are added automatically by Control-M, to allow the user to specify additional parameters, and cannot be deleted.
BMC recommends that, wherever possible, you use commands D, C, R, and M for editing, instead of DS, DL, CS, CL, RS, RL, MS, and ML, because these commands automatically retain the logical structure of the job scheduling definition.

Example 1

Before: Insert additional DO statements within a DO block using command I (Insert).

Figure 393 Example - Inserting A DO Statement - Before

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

COMMAND ===> SCROLL===> CRSR

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

__ AUTO-ARCHIVE Y SYSDB Y MAXDAYS MAXRUNS

__ SYSOUT OP (C,D,F,N,R) FROM

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

__ MAXRERUN 3 RERUNMEM INTERVAL FROM

__ STEP RANGE FR (PGM.PROC) . TO .

__ ON PGMST ANYSTEP PROCST CODES S*** U**** C2000 ***** A/O

__ CODES

I_ DO IFRERUN FROM $ABEND . TO . CONFIRM Y

__ DO RERUN

__ DO

__ ON PGMST PROCST CODES A/O

__ DO

__ ON SYSOUT FROM 001 TO 132 A/O

__ DO

__ ON VAR

__ DO

__ SHOUT WHEN TIME + DAYS TO URGN

__ MS

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

COMMANDS: EDIT, DOC, PLAN, JOBSTAT 16.44.31

After

Figure 394 Example - Inserting A DO Statement - After

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

COMMAND ===> SCROLL===> CRSR

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

__ AUTO-ARCHIVE Y SYSDB Y MAXDAYS MAXRUNS

__ SYSOUT OP (C,D,F,N,R) FROM

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

__ MAXRERUN 3 RERUNMEM INTERVAL FROM

__ STEP RANGE FR (PGM.PROC) . TO .

__ ON PGMST ANYSTEP PROCST CODES S*** U**** C2000 ***** A/O

__ CODES

__ DO IFRERUN FROM $ABEND . TO . CONFIRM Y

__ DO

__ DO RERUN

__ DO

__ ON PGMST PROCST CODES A/O

__ DO

__ ON SYSOUT FROM 001 TO 132 A/O

__ DO

__ ON VAR

__ DO

__ SHOUT WHEN TIME + DAYS TO URGN

__ MS

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

COMMANDS: EDIT, DOC, PLAN, JOBSTAT 14.49.42

Example 2

Before: Delete an ON PGMST block. Use of the DB (Delete Block) command is the preferred method. The DB command removes all parameters, comments, continuation lines, and separator lines of the specified block. DB must be specified on a main line of the block, that is, ON PGMST. In this example, the ON PGMST block is deleted.

Figure 395 Example - Deleting A Block - Before

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

COMMAND ===> SCROLL===> CRSR

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

__ ===================================================================

__ OUT

__ AUTO-ARCHIVE Y SYSDB Y MAXDAYS MAXRUNS

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

__ SYSOUT OP (C,D,F,N,R) FROM

__ MAXRERUN 3 RERUNMEM INTERVAL. FROM

__ STEP RANGE FR (PGM.PROC) . TO

DB ON PGMST ANYSTEP PROCST CODES S*** U**** C2000 ***** A/O

__ CODES

__ DO IFRERUN FROM $ABEND . TO . CONFIRM Y

__ DO RERUN

__ DO

__ ON PGMST PROCST CODES A/O

__ DO

__ ON SYSOUT FROM 001 TO 132 A/O

__ DO

__ ON VAR

__ DO

__ SHOUT WHEN TIME + DAYS TO URGN

__ MS

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

COMMANDS: EDIT, DOC, PLAN, JOBSTAT 14.52.02

After: The ON PGMST ANYSTEP block has been deleted.

Figure 396 Example - Deleting A Block - After

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

COMMAND ===> SCROLL===> CRSR

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

__ ===================================================================

__ OUT

__ AUTO-ARCHIVE Y SYSDB Y MAXDAYS MAXRUNS

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

__ SYSOUT OP (C,D,F,N,R) FROM

__ MAXRERUN 3 RERUNMEM INTERVAL. FROM

__ STEP RANGE FR (PGM.PROC) . TO .

__ ON PGMST PROCST CODES A/O

__ DO

__ ON SYSOUT FROM 001 TO 132 A/O

__ DO

__ ON VAR

__ DO

__ SHOUT WHEN TIME + DAYS TO URGN

__ MS

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

COMMANDS: EDIT, DOC, PLAN, JOBSTAT 14.53.58

Example 3

Before: Move multiple DO statements from one sub-block to another. Command MM (Multiple Move) is specified at the beginning and end of the DO statements that are moved. Command A (After) specifies the location after which these lines are placed.

Figure 397 Example - Moving Statements - Before

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

COMMAND ===> SCROLL===> CRSR

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

__ OUT

__ AUTO-ARCHIVE Y SYSDB Y MAXDAYS MAXRUNS

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

__ SYSOUT OP (C,D,F,N,R) FROM

__ MAXRERUN 3 RERUNMEM INTERVAL. FROM

__ STEP RANGE FR (PGM.PROC) . TO .

__ ON PGMST ANYSTEP PROCST CODES S*** U**** C2000 ***** A/O

__ CODES

__ DO IFRERUN FROM $ABEND . TO . CONFIRM Y

__ DO RERUN

MM DO COND STEP5_DONE ODAT +

__ DO SHOUT TO TSO-M22 URGENCY R

MM = STEP STEP05 PROCESSED

__ DO

__ ON PGMST STEP05 PROCST CODES S*** A/O

A_ DO IFRERUN FROM $ABEND . TO . CONFIRM N

__ DO

__ ON PGMST PROCST CODES A/O

__ DO

After: The two specified DO statements have been moved to the specified location.

Figure 398 Example - Moving Statements - After

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

COMMAND ===> SCROLL===> CRSR

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

__ OUT

__ AUTO-ARCHIVE Y SYSDB Y MAXDAYS MAXRUNS

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

__ SYSOUT OP (C,D,F,N,R) FROM

__ MAXRERUN 3 RERUNMEM INTERVAL. FROM

__ STEP RANGE FR (PGM.PROC) . TO .

__ ON PGMST ANYSTEP PROCST CODES S*** U**** C2000 ***** A/O

__ CODES

__ DO IFRERUN FROM $ABEND . TO . CONFIRM Y

__ DO RERUN

__ DO

__ ON PGMST STEP05 PROCST CODES S*** A/O

__ DO IFRERUN FROM $ABEND . TO . CONFIRM N

__ DO COND STEP5_DONE ODAT +

__ DO SHOUT TO TSO-M22 URGENCY R

__ = STEP STEP05 PROCESSED

__ DO

__ ON PGMST PROCST CODES A/O

__ DO

Example 4

Before: Copy ON PGMST and some of its DO statements to another ON PGMST block. Command CC (Multiple Copy) is specified at the beginning and the end of the parameters that is copied. Command B (Before) specifies the location before which these lines are placed.

Figure 399 Example - Copying Statements - Before

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

COMMAND ===> SCROLL===> CRSR

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

__ AUTO-ARCHIVE Y SYSDB Y MAXDAYS MAXRUNS

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

__ SYSOUT OP (C,D,F,N,R) FROM

__ MAXRERUN 3 RERUNMEM INTERVAL. FROM

__ STEP RANGE FR (PGM.PROC) . TO .

__ ON PGMST ANYSTEP PROCST CODES S*** U**** C2000 ***** A/O

__ CODES

__ DO IFRERUN FROM $ABEND . TO . CONFIRM Y

__ DO RERUN

__ DO

CC ON PGMST STEP05 PROCST CODES S*** A/O

__ DO IFRERUN FROM $ABEND . TO . CONFIRM N

CC DO COND STEP5_DONE ODAT +

__ DO SHOUT TO TSO-M22 URGENCY R

__ = STEP STEP05 PROCESSED

__ DO

B ON PGMST PROCST CODES A/O

__ DO

After: The specified ON PGMST and DO statements have been copied.

Figure 400 Example - Copying Statements - After

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

COMMAND ===> SCROLL===> CRSR

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

__ MAXRERUN 3 RERUNMEM INTERVAL. FROM

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

__ STEP RANGE FR (PGM.PROC) . TO .

__ ON PGMST ANYSTEP PROCST CODES S*** U**** C2000 ***** A/O

__ CODES

__ DO IFRERUN FROM $ABEND . TO . CONFIRM Y

__ DO RERUN

__ DO

__ ON PGMST STEP05 PROCST CODES S*** A/O

__ DO IFRERUN FROM $ABEND . TO . CONFIRM N

__ DO COND STEP5_DONE ODAT +

__ DO SHOUT TO TSO-M22 URGENCY R

__ = STEP STEP05 PROCESSED

__ DO

__ ON PGMST STEP05 PROCST CODES S*** A/O

__ DO IFRERUN FROM $ABEND . TO . CONFIRM N

__ DO COND STEP5_DONE ODAT +

__ DO

__ ON PGMST PROCST CODES A/O

__ DO

Example 5

Before: Insert a continuation line between existing continuation lines. It is recommended that command RS (Repeat Single) or R (Repeat) be used to repeat the previous line.

Figure 401 Example - Inserting A Line - Before

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

COMMAND ===> SCROLL===> CRSR

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

__ TIME ZONE:

__ ========================================================================

__ OUT

__ AUTO-ARCHIVE Y SYSDB Y MAXDAYS MAXRUNS

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

__ SYSOUT OP (C,D,F,N,R) FROM

__ MAXRERUN 3 RERUNMEM INTERVAL. FROM

__ STEP RANGE FR (PGM.PROC) . TO .

__ ON PGMST ANYSTEP PROCST CODES S*** U**** C2000 C3000 A/O A

RS CODES C4000 C5000 C6000 C7000

__ CODES C1200

__ ON PGMST STEP04 PROCST CODES ***** A/O

__ DO IFRERUN FROM $ABEND . TO . CONFIRM Y

__ DO RERUN

__ DO

__ ON PGMST STEP05 PROCST CODES S*** A/O

__ DO IFRERUN FROM $ABEND . TO . CONFIRM N

__ DO COND STEP5_DONE ODAT +

__ DO SHOUT TO TSO-M22 URGENCY R

__ = STEP STEP05 PROCESSED

After: The continuation line has been repeated. The repeated line can be modified as necessary.

Figure 402 Example - Inserting A Line - After

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

COMMAND ===> SCROLL===> CRSR

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

__ TIME ZONE:

__ =====================================================================

__ OUT

__ AUTO-ARCHIVE Y SYSDB Y MAXDAYS MAXRUNS

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

__ SYSOUT OP (C,D,F,N,R) FROM

__ MAXRERUN 3 RERUNMEM INTERVAL. FROM

__ STEP RANGE FR (PGM.PROC) . TO .

__ ON PGMST ANYSTEP PROCST CODES S*** U**** C2000 C3000 A/O A

__ CODES C4000 C5000 C6000 C7000

__ CODES C1200

__ ON PGMST STEP04 PROCST CODES ***** A/O

__ DO IFRERUN FROM $ABEND . TO . CONFIRM Y

__ DO RERUN

__ DO

__ ON PGMST STEP05 PROCST CODES S*** A/O

__ DO IFRERUN FROM $ABEND . TO . CONFIRM N

__ DO COND STEP5_DONE ODAT +

__ DO SHOUT TO TSO-M22 URGENCY R

Parent Topic

Editing Job Scheduling Definitions in the Edit Environment