baseline jcl day2

04/12/23 1

ER/CORP/CRS/OS02/003-2

JCL

DAY 2

04/12/23 2


EXEC STATEMENTS

PGM COND

PROC PARM

ACCT REGION

ADDRSPC TIME

PERFORM

04/12/23 3


IMPORTANT EXEC PARAMETERS positional parameters (PGM & PROC)

ex. //STEP1 EXEC PGM=IEFBR14

• The PGM parameter identifies the name of the program that is to be executed.

ex. //STEP1 EXEC PROC=MYPROC

• The PROC parameter identifies the name of the procedure that is to be called.

04/12/23 4


SEARCH SEQUENCE OF A PROGRAM

JOB PACK AREA

JOB LIBRARY /STEP LIBRARY

FIXED LINK PACKAREA - FLPA

MODIFIED LINK PACKAREA - MLPA

SYS1.LINKLIB

PAGEABLE LINK PACKAREA (PLPA)

PGM NOTFOUND

04/12/23 5


MVS 370 memory map

Nucleus

System Region

User Region

SWA

Unallocated storage

CSA

PLPA

SQA

Common area

Private area

System area

Virtual Storage

0 MB

16 MB

04/12/23 6


IMPORTANT EXEC PARAMETERS keyword parameters (PARM)

ex. //STEP1 EXEC PGM=IEBUPDT,PARM=MOD

• The PARM parameter is used to supply information to a program as it executes.

04/12/23 7


IMPORTANT EXEC PARAMETERS keyword parameters (ADDRSPC)

ex. //STEP1 EXEC PGM=IEBUPDT, // ADDRSPC=VIRT

• The ADDRSPC parameter is to indicate to the system that the job step is to use either VIRT (virtual) or REAL (real) storage.

• By default it is virtual.

04/12/23 8


IMPORTANT EXEC PARAMETERS keyword parameters (COND)

ex. //STEP3 EXEC PGM=IEBUPDT,COND=(8,LE,STEP1)

• The COND Permits the execution of steps to depend on the return code from the previous steps.

• The question should be is 8 less than the RC code of STEP1. If Yes then Bypass STEP3 If No Execute STEP3

• The COND parameter is also a JOB parameter.

04/12/23 9


IMPORTANT EXEC PARAMETERS keyword parameters (COND)

COND =

FALSE

TRUE

EXECUTE

BYPASS

04/12/23 10


COND parameter in detail

Format :

COND=( 0/4/6/8/12/16 , GT/GE/LT/LE/EQ/NE , step name , EVEN/ONLY )

RC comparison code (0 - 4095)

Condition

EVEN : step will be executed even if previous steps terminate abnormally

ONLY : step will be executed only if previous stepsterminate abnormally.

Only code in the exec statementnot in job statement

04/12/23 11


COND parameter examples (in JOB statement) 000100 //INF6244A JOB COND=(4,LT) 000200 //STEP1 EXEC PGM=IEFBR14 000300 //STEP2 EXEC PGM=IFBR14 000400 //STEP3 EXEC PGM=IEFBR14

• STEP1 executes with RC = 0

• STEP2 executes with RC *S806 that is it is greater than 4

• Job terminates

04/12/23 12


COND parameter examples (in EXEC statement)

000100 //INF6244A JOB 000200 //STEP1 EXEC PGM=IEFBR14 000300 //STEP2 EXEC PGM=IEFBR14,COND=(0,EQ,STEP1)


• STEP2 does not execute

04/12/23 13



000100 //INF6244A JOB 000200 //STEP1 EXEC PGM=IEFBR14 000300 //STEP2 EXEC PGM=IEFBR14,COND=ONLY



000100 //INF6244A JOB 000200 //STEP1 EXEC PGM=IFBR14 000210 //STEP2 EXEC PGM=IEFBR14 000220 //STEP3 EXEC PGM=IEFBR14,COND=ONLY

• STEP1 abends with RC = *S806

• STEP2 does not execute ( if a single step abends all other steps are bypassed if no COND statement is there )


04/12/23 14



000100 //INF6244A JOB 000210 //STEP1 EXEC PGM=IEFBR14 000300 //STEP2 EXEC PGM=IEFBR14,COND=EVEN



000100 //INF6244A JOB 000200 //STEP1 EXEC PGM=IFBR14 000210 //STEP2 EXEC PGM=IEFBR14 000220 //STEP3 EXEC PGM=IEFBR14,COND=EVEN

• STEP1 abends with RC = *S806

• STEP2 does not execute ( if a single step abends all other steps are bypassed if no COND statement is there )


04/12/23 15



//INF6244A JOB //STEP1 EXEC PGM=IEFBR14 //STEP2 EXEC PGM=IEFBR14 //STEP3 EXEC PGM=IEFBR14,

// COND=((0,NE,STEP2),ONLY)


• STEP2 executes with RC = 0 000100 //INF6244A JOB 000200 //STEP1 EXEC PGM=IEFBR14 000210 //STEP2 EXEC PGM=IEFBR14 000220 //STEP3 EXEC PGM=IEFBR14, 000230 // COND=((0,NE,STEP2))





04/12/23 16



000100 //INF6244A JOB 000200 //STEP1 EXEC PGM=IEFBR14 000210 //STEP2 EXEC PGM=IEFBR14 000220 //STEP3 EXEC PGM=IEFBR14, 000230 // COND=((0,NE,STEP2),(0,NE,STEP1))


• STEP2 executes with RC = 0 000100 //INF6244A JOB 000200 //STEP1 EXEC PGM=IEFBR14 000210 //STEP2 EXEC PGM=IEFBR14 000220 //STEP3 EXEC PGM=IEFBR14, 000230 // COND=((0,NE,STEP2),(0,EQ,STEP1))





04/12/23 17


COND parameter examples (STEP overriding JOB)

000100 //INF6244A JOB COND=(0,NE) 000200 //STEP1 EXEC PGM=IEFBR14 000210 //STEP2 EXEC PGM=IEFBR14 000220 //STEP3 EXEC PGM=IEFBR14



000100 //INF6244A JOB COND=(0,NE) 000200 //STEP1 EXEC PGM=IEFBR14 000210 //STEP2 EXEC PGM=IEFBR14 000220 //STEP3 EXEC PGM=IEFBR14,COND=(0,EQ,STEP2)




• STEP3 executes with RC = FFLUSH

04/12/23 18


IMPORTANT EXEC PARAMETERS keyword parameters (IF/THEN/ELSE/ENDIF)

ex. // IF (STEPA.RC GE 4) THEN //jcl statements // ELSE //jcl statements // ENDIF

• The IF/THEN/ELSE/ENDIF statement construct provides a simple means of selectively executing job steps.

• It is available in Release 4 or later , of MVS/ESA and eliminates the need to struggle with the COND parameter.

04/12/23 19


IF/THEN/ELSE/ENDIF parameter examples

000100 //INF6244A JOB 2933100P,AMLAN,MSGCLASS=A,CLASS=A 000120 //STEP1 EXEC PGM=IEFBR14 000121 // IF (STEP1.RC GT 0) THEN 000130 //STEP3 EXEC PGM=IEFBR14 000150 //DD1 DD DSN=INF6244.TRUE.PS,DISP=(NEW,CATLG), 000160 // VOL=SER=INUSR2, 000170 // SPACE=(TRK,(1,1)), 000180 // DCB=(LRECL=80,BLKSIZE=800,RECFM=FB) 000190 // ELSE 000191 //STEP4 EXEC PGM=IEFBR14 000200 //DD2 DD DSN=INF6244.FALSE.PS,DISP=(NEW,CATLG), 000300 // VOL=SER=INUSR2, 000400 // SPACE=(TRK,(1,1)), 000500 // DCB=(LRECL=80,BLKSIZE=800,RECFM=FB) 000600 // ENDIF 000610 /* STEPNAME PROCSTEP RC

STEP1 00 STEP3 FLUSH

STEP4 00

04/12/23 20


COMMON keyword PARAMETERS in JOB & EXEC

TIME

COND

REGION

04/12/23 21


DD STATEMENTS

ddname DD *

VOL DATA

DCB SYSOUT

DSN DUMMY

UNIT DLM

DISP SYSUDUMP

SYSMDUMP SYSABEND

REFERBACK JOBLIB

STEPLIB

04/12/23 22


DSN

• The name of the data set

• Simple Name : 1 to 8 chars

• Qualified Name : separated by periods each name 1 to 8 chars total 44 characters including periods

• Temporary data sets : &&TEMP or do not mention DSN parameter

• Refer back : DSN=*.STEP1.DD1

04/12/23 23


DISP

NEW ,DELETE ,DELETE

OLD ,KEEP ,KEEP

DISP= SHR ,CATLG ,CATLG

MOD ,UNCATLG ,UNCATLG

,PASS

04/12/23 24


DCB

LRECL=n (VALUE IN BYTES)

RECFM=(F/FB/V/VB/U)

BLKSIZE= multiple of LRECL

DSORG=(PS/PO/DA)

04/12/23 25


SPACE

SPACE=(space units,(primary,secondary,dir),RLSE)

space unit - TRK(tracks)/CYL(cylinders)/BLOCKSIZE in

bytes

eg: SPACE=(1024,(100,200)

SPACE=(TRK,(10,5) - allocate 10 tracks primarily and if

required as secondary allocation 5 tracks

04/12/23 26


UNIT• Hardware address• Type• Group

// UNIT=0320 OR// UNIT=3390 OR // UNIT=SYSDA

To use the same unit that has been used by prior DD statement// UNIT=AFF=ddname

04/12/23 27


VOL

• It is used to specify a disk volume or specific tapes.

// VOL=SER=INUSR2,UNIT=SYSDA

To referback a volume used by some prior DD statement use:// VOL=REF=ddname

04/12/23 28


SYSOUT

// DDNAME DD SYSOUT=CLASS

• SYSOUT is used to route output to a device.

// DDNAME DD SYSOUT=A

If you want to send the output to the same device described by MSGCLASS of the job use

// DDNAME DD SYSOUT=*

04/12/23 29


JOBLIB STATEMENTS

ex. //INFOSYS1 JOB //JOBLIB DD DSN=INFOSYS.COMPLIB.LOAD,

• The JOBLIB statement defines the library where the program is residing. It is placed after the JOB statement and is effective for every JOB steps.

• // DISP = (what should be the disposition)• // DISP = SHR

• //STEP1 EXEC PGM=INHOUSE

04/12/23 30


STEPLIB STATEMENTS

ex. //STEP1 EXEC PGM=INHOUSE //STEPLIB DD DSN=INFOSYS.COMPLIB.LOAD,

• The STEPLIB statement defines the library where the program is residing. It is placed after the EXEC statement and is effective for that particular step and overrides any JOBLIB statement.

• // DISP = (what should be the disposition)• // DISP = SHR

04/12/23 31


The first JCL to create a PS.

//AMLANX JOB 1234,AMLAN,CLASS=A,MSGCLASS=(1,1) TO CREATE PS

//STEP1 EXEC PGM=IEFBR14

//PS1 DD DSN=AMLAN.FLOWER.ROSE,UNIT=SYSDA,VOL=SER=INUSR2,// DCB=(LRECL=80,RECFM=FB,BLKSIZE=800),SPACE=(TRK,(1,1)),// DISP=(NEW,CATLG)

04/12/23 32


That’s all for

DAY

2

baseline jcl day2

Documents

iefbr14 step2 exec pgm

iefbr14 step3 exec pgm

step1 step1

iefbr14 step1

step2 step1

pgm parameter

exec statementspgm

rc code of step1