Previous Topic

Next Topic

Book Contents

Book Index

Post-Processing Parameters

Figure 22 Post-Processing Parameters

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

 OUT      BAKCKPL02-ENDED-OK   ODAT +                               

 AUTO-ARCHIVE Y          SYSDB   Y      MAXDAYS       MAXRUNS       

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

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

 MAXRERUN      RERUNMEM             END-TABLE

 CAPTURE BY   (W - WORD / C - CHAR)

 CYCLIC TYPE: C                                  INTERVAL     FROM

 INTERVAL SEQUENCE: +         +         +         +         +         

 SPECIFIC TIMES:                                             TOLERANCE

                     +           +           +           +     

 STEP RANGE         FR (PGM.PROC)          .         TO      .      

 ON PGMST ANYSTEP  PROCST         CODES C0008  U0048            A/O 

   DO                                                               

 ON SYSOUT                                   FROM 001 TO 132    A/O

   DO                                                               

 ON VAR                                                             

   DO                                                               

 SHOUT WHEN          TIME       +     DAYS      TO             URGN

   MS 

Table 40 Post-Processing Parameters

Parameter

Description

OUTM

Prerequisite conditions to be added and/or deleted when the job finishes OK.

§Restart§ AUTO-ARCHIVE

Yes or No indicator (Y/N) specifying whether to automatically archive SYSDATA. Subparameters are:

  • SYSDB – Yes or No indicator specifying whether to archive SYSDATA of jobs to a common data set (Y) or to unique data sets (N)
  • MAXDAYS – maximum number of days (from 00 through 98, or 99) to retain archived SYSDATA of jobs that ended NOTOK
  • MAXRUNS – maximum number of runs (from 000 through 999) for which the archived SYSDATA must be retained for jobs that ended NOTOK

RETENTION

Either of the following subparameters (but not both) can be used to specify how long the job must remain in the History Jobs file:

  • # OF DAYS TO KEEP – number of days the job must be retained
  • # OF GENERATIONS TO KEEP – number of runs of the job that must be retained

SYSOUT

Action to perform with the job sysout when the job finishes OK.

MAXRERUN

Maximum number of reruns to be performed for the job, if DO RERUN is requested. (Called RERUN – MAXRERUN prior to version 6.0.00.)

RERUNMEM

Name of member to be submitted in case of a DO RERUN request. (Called RERUN – RERUNMEM prior to version 6.0.00.)

END-TABLE

Whether the job is an end point for the SMART table (Y/N).

CAPTURE BY

Data to extract from the job's JES output datasets (JESYSMSG, JESJCL, and JESMSGLG) and place into a Control-M AutoEdit variable.

INTERVAL

Amount of time, in minutes, to wait between reruns or between cycles of a cyclic job.

STEP RANGEM

Step range (FROM or TO PGMST, and optionally PROCST) name to be referenced by ON statements.

ONM

Job processing criteria that determine whether the accompanying DO actions are performed:

To organize ON statements in blocks, you can use an A/O (AND/OR) conjuctional parameter to open and link additional ON statements.

DO actionM

Actions to be performed when the ON step/code event criteria are satisfied. Valid DO actions are described in "DO Actions" below.

SHOUTM

Message to be sent to a specified destination in a specified situation:

  • WHEN – Situations under which to send the message.
  • TO – Destination of the message.
  • URGN – Urgency of message.
  • MS – The message, in free text. Control-M AutoEdit System variables are supported.

DO Actions

The following are a description and example of each of the DO actions.

DO COND – Add or delete a prerequisite condition.

ON PGMST UPDATE   PROCST          CODES S***   U****           A/O

     DO COND          PL-BACKOUT-REQUIRED    ODAT +               

     DO                                                           

DO CTBRULE – Invoke the Control-M/Analyzer Runtime environment and execute the specified Control-M/Analyzer rule, which performs the balancing operations defined in the rule on SYSDATA. Arguments can be passed to Control-M/Analyzer. Available only at sites in which Control-M/Analyzer is active.

ON PGMST ANYSTEP    PROCST          CODES OK                     A/O

      DO CTBRULE   = BALKPL   ARG DOREPORT,UPDATEDB               

      DO                                                          

DO FORCEJOB – Force (schedule) a job under Control-M.

ON PGMST   UPDATE   PROCST            CODES S***   U****       A/O

   DO FORCEJOB   TABLE  PLPROD    JOB PLBCKOUT  UFLOW N    DATE ODAT

                LIBRARY GENERAL    

   DO

§Restart§ DO IFRERUN – Perform a restart under Control-M/Restart when the job is manually or automatically rerun. This DO action is available if you have Control-M/Restart installed at your site.

ON PGMST ANYSTEP    PROCST          CODES S0C1                   A/O

DO IFRERUN FROM GLSTEP01.GLPROC02 TO GLSTEP05 . GLPROC03 CONFIRM N

    DO

DO MAIL – Send an e-mail message to the specified recipients.

ON PGMST   UPDATE   PROCST         CODES C0000                 A/O

    DO MAIL                                                          

    TO   ACCT-SMITH                                                  

    CC                                                               

  SUBJ VERIFICATION                                                

  TEXT CHECK OK                                                    

    DO                                                             

DO NOTOK – Define the termination status of the job as NOTOK.

ON PGMST   UPDATE   PROCST          CODES C0004                A/O

    DO NOTOK                                                      

    DO                                                            

DO OK – Define the event within the job as OK.

ON PGMST ANYSTEP  PROCST        CODES C0008  U0048             A/O

    DO OK                                                         

    DO                                                            

DO REMEDY – Open a Remedy Help Desk ticket.

    ON PGMST STEP1    PROCST             CODES C0012            A/O

    DO REMEDY                                      URGENCY U

SUMM JOB %%JOBNAME ON NODE %%$NODEID ENDED WITH RETURN CODE %%COMPSTAT

DESC CONTROL-M JOB %%JOBNAME RUN %%RN ENDED ON NODE %%$NODEID RETURN

      CODE %%COMPSTAT: APPLICATION: %%APPL, TABLE: %%TABLE

Note: To close the ticket, the Control-M user will have to access the Remedy online services.

DO REMFORCE – Force one or more jobs under a remote Control-M.

     DO REMFORCE    CONTROL-M   MPM900            UFLOW N DATE 251214

TABLE table_name

JOB    jobname

LIBRARY

VAR    %%Var1=Value1

VAR    %%Var2=Value2

DO RERUN – Indicate that a job must be rescheduled for a rerun.

ON PGMST ANYSTEP    PROCST       CODES S0C1                       A/O

    DO IFRERUN    FROM GLSTEP01 . GLPROC02 TO GLSTEP05 . GLPROC03    CONFIRM N

     DO RERUN                                                          

     DO

DO SET – Assign a value to a Control-M AutoEdit variable.

ON PGMST ANYSTEP    PROCST        CODES C0008    U0048              A/O

     DO SET       VAR= %%RUNTYPE=CHK                                 

     DO                                                              

Note: Since DO SET values are dependent upon fulfillment of ON step or codes criteria, the values are assigned after job execution and used for subsequent cyclic runs and rerun.

DO SHOUT – Message to be sent to specified location.

ON PGMST     UPDATE     PROCST           CODES S***    U****           A/O

    DO SHOUT     TO    OPER2              URGENCY R                  

     = A BACKOUT OF FILE-XXXX IS GOING TO RUN SOON                  

    DO SHOUT     TO    USER-DBA           URGENCY R                  

     = ABEND OF THE UPDATE STEP, PLEASE CHECK IT                      

    DO                                                              

DO STOPCYCL – Stop recycling a cyclic task.

ON PGMST ANYSTEP    PROCST         CODES >C0008                      A/O

    DO STOPCYCL                                                     

    DO                                                              

DO SYSOUT – Action to perform with the job sysout.

ON PGMST     UPDATE     PROCST         CODES S***    U****            A/O

    DO SYSOUT    OPT C PRM P                                    FRM

    DO                                                             

Parent Topic

Job Scheduling Definition Screen – Defining Schedules