Stephen Linkin Houston Community College 19-Jan-07 © Mike Murach & Associates, HCC, IBM 1 RESTART And Other Program Execution Facilities

2 Objectives Applied Objectives Code RESTART On A JOB Statement To Restart A Job: a. F rom The Beginning Of The First Job Step b. F rom The Beginning Of A Named Job Step Within A Job Or Cataloged Procedure Assuming a Is Set To WLM Compatibility Mode, Code PERFORM Parameter On A JOB Or EXEC Statement To Specify Performance Group For Job Or Job Step. Code A Command Statement To Issue An MVS Or JES Command From The JCL Stream.

© Mike Murach & Associates, HCC, IBM3 Objectives Knowledge Objectives Explain Checkpoints And How They’re Used In A Job. Describe How And Why Restart Processing Is Used. Explain What An Automatic Restart Is. Describe What A Performance Group Is. Name The JES2 And JES3 Statements Used To: a. R estart A Job When The System Fails b. S end A Message To The Operator c. S pecify A Job’s System Affinity

© Mike Murach & Associates, HCC, IBM4 Supporting Checkpoints Programming Languages And Utilities LanguageUse COBOLUse the RERUN clause in the I-O-CONTROL paragraph of the Input-Output Section to generate checkpoints within a COBOL program. The ddname for the data set that stores the checkpoints is specified in the RERUN clause. PL/IUse the CALL PLICKPT feature to generate checkpoints within a PL/I program. The ddname for the checkpoint data set is SYSCHK. Assembler languageUse the CHKPT macro instruction to generate checkpoints. The DCB macro specifies the ddname for the checkpoint data set. JCLUse the CHKPT parameter on the DD statement to generate checkpoints whenever the end of a volume is reached for a sequential data set. The ddname for the checkpoint data set is SYSCKEOV. DFSORTUse the CKPT parameter in sort control statements to generate checkpoints. The ddname for the checkpoint data set is SORTCKPT.

© Mike Murach & Associates, HCC, IBM5 The CHKPT Parameter Of The DD Statement The Syntax Sample Job Step With EOV Checkpoints CHKPT=EOV //STEP1 EXEC PGM=INVUPD //INVOUT DD DSN=MM01.INV.OUT,DISP=(NEW,KEEP), // UNIT=TAPE,VOL=SER=(TAPE01,TAPE02), // CHKPT=EOV //SYSCKEOV DD DSN=CHECK.SAVE,DISP=MOD

© Mike Murach & Associates, HCC, IBM6 The RESTART Parameter Of The JOB Statement The Syntax RESTART= ( {* } [,checkid] ) {stepname } {stepname.procstepname} ValueExplanation * * System is to restart the job at the first job step. Stepname Stepname System is to restart the job at the beginning of the named job step or at a checkpoint within that job step. stepname.procstepname stepname.procstepname Restart the job at the beginning of the named job step of the cataloged procedure or at a checkpoint within that job step. Stepname identifies the EXEC statement that calls the procedure and procstepname identifies the job step within the procedure. checkid checkid The name of the checkpoint where the system restarts execution.

© Mike Murach & Associates, HCC, IBM7 Using The RESTART Parameter A deferred step restart A deferred checkpoint restart //MM01F JOB (36512),'LE MENENDEZ',RESTART=STEP3 //MM01G JOB (36512),'J TAYLOR',RESTART=STEP3.INV3020 //MM01H JOB (36512),'M MURACH',RESTART=(STEP2,CKPT4) //SYSCHK DD DSNAME=MM01.CHECK,DISP=OLD

© Mike Murach & Associates, HCC, IBM8 The RD Parameter Of The JOB And EXEC Statements The Syntax A JOB statement that uses the RD parameter An EXEC statement that uses the RD parameter RD= {R} {RNC} {NR} {NC} //MM01A JOB (36512),MENENDEZ,RD=R //STEP2 EXEC PGM=APRUPD,RD=RNC

© Mike Murach & Associates, HCC, IBM9 RESTART Parameter Of The JES2 /*JOBPARM Statement The Syntax A job that uses the JES2 RESTART parameter RESTART= {Y} {N} //MM01A JOB (36512),MENENDEZ,NOTIFY=MM01 /*JOBPARM RESTART=Y

© Mike Murach & Associates, HCC, IBM10 FAILURE Parameter Of The JES3 //*MAIN Statement The Syntax Example of using the JES3 FAILURE parameter FAILURE= {RESTART} {CANCEL} {HOLD} {PRINT} //MM01B JOB (36512),MENENDEZ,NOTIFY=MM01 //*MAIN FAILURE=HOLD

© Mike Murach & Associates, HCC, IBM11 PERFORM Parameter Of The JOB And EXEC Statements The Syntax A JOB Statement Using PERFORM An EXEC Statement Using PERFORM PERFORM=group //MM02D JOB (36512),'G MURACH',PERFORM=10 //APRCALC EXEC PGM=APRCALC,PERFORM=3

© Mike Murach & Associates, HCC, IBM12 JES2 /*MESSAGE Statement The Syntax /*MESSAGE statement sending message to operator /*MESSAGE message /*MESSAGE NOTIFY ON-CALL PROGRAMMER IF JOB ABENDS

© Mike Murach & Associates, HCC, IBM13 JES3 //*OPERATOR Statement The Syntax //*OPERATOR sends message to operator //*OPERATOR message //*OPERATOR CALL R MENENDEZ – EXT 22 WITH RESULTS

© Mike Murach & Associates, HCC, IBM14 The JCL COMMAND Statement The Syntax COMMAND statement requesting execution of SEND command //[name] COMMAND 'command command-operand' x //MSG1 COMMAND 'SEND ''PRODUCTION JOB ACCTNG1B IS NOW COMP LETE.'',USER=(MM01)' **SENDS MESSAGE TO MM01**

© Mike Murach & Associates, HCC, IBM15 End Presentation