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

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	Step and code event criteria that determine if the accompanying DO actions are performed PGMST/PROCST – program step (and optionally the procedure step) to check for the specified code criteria CODESM – execution event codes, such as U0234, SB37, and C0004 A/O – AND/OR conjunctional parameter that opens (and links) 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 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 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