MAINFRAMES

JCL – Job Control Language

NAGARAJU DOMALA
JCL – JOB CONTROL LANGUAGE

Session 5

Nagaraju Domala
SESSION OBJECTIVES
At the end of this session participants would have understood

 How to code JCL Procedures

 Types of JCL Procedures
 Usage of JCL Procedures
 How to code JCL Procedures Overrides

Nagaraju Domala
 Points to Cover
 Categories of procedures and definitions
 In stream procedures
 Catalogued procedures
 Syntax rules in procedures
 Regular overrides of DD and EXEC statements
 Symbolic overrides of DD and EXEC statements

Nagaraju Domala
 Categories of procedures and definitions

PROCEDURES:
It is a prepacked JCL.
JCL needed by many different users
A JCL executed on a repetitive basis
JCL often repeated within the execution of a single job
A procedure is invoked by specifying its name in an EXEC statement.
//STEP1 EXEC INV3000 ( OR )
//STEP1 EXEC PROC=INV3000
 A name is always required on a PROC statement.
 The word PROC is optional.
 A procedure invoking EXEC statement causes previously stored JCL
statements to be read into the job stream.
A procedure can not invoke another procedure.

Nagaraju Domala
 Categories of procedures and definitions

TYPE OF PROCEDURES:
 In-stream procedures
Coded in the executing job
max of 15 per JOB

 Catalogued Procedure
Member of a PDS (procedure library)
max 255 steps

Nagaraju Domala
 Syntax rules in procedures

RESTRICTIONS:
 THE NUMBER OF STEPS IN A PROC CANNOT EXCEED 255
 THE FOLLOWING ARE NOT PERMITTED TO RESIDE IN A PROC

 A JOB STMT
 AN EXEC STMT INVOKING A PROC
 A JOBLIB DD STMT
 A DD * STMT
 A DD DATA STMT
 A /* (DELIMITER) STMT
 A // (NULL) STMT
 INPUT STREAM (SYSIN) DATA
 A PEND STMT (FOR CATALOGED PROCEDURES ONLY)

Nagaraju Domala
 In stream procedures

 One of the main purpose of In stream procedures is to use them as testing

tools
 In stream procedures can also be convenient when a set of JCL must be
executed many times in only one job
 It must begin with a PROC statement and end with a PEND statement
 It should be coded before the first EXEC statement invoking the in-stream
procedure
000100 //UELA009A JOB (AMLAN),NOTIFY=UELA009A,CLASS=A
000210 //PROC1 PROC
000220 //STEP2 EXEC PGM=IEFBR14
000300 //DD1 DD DSN=&&TEMP,SPACE=(TRK,(1,1)),
000400 // DCB=(RECFM=FB,BLKSIZE=800,LRECL=80),
000500 // DISP=(NEW,KEEP),UNIT=SYSDA , VOL=SER=INUSR3
000600 // PEND
000610 //STEP1 EXEC PROC1
000700 /*

Nagaraju Domala
 Catalogued procedures

 It must be a member of PDS

 PEND statement is not permitted
 It can have a maximum of 255 steps
 The name of the library (PDS) should be specified if cataloged library is
not in the system defined library (SYS1.PROCLIB) using JES
JOBPARM statement or JCLLIB statement
 It must begin with a PROC statement and must not contain a PEND
statement
 It must be cataloged in order to access it that is it must be a member of
a PDS.

Nagaraju Domala
Catalogued procedures(Contd..)

Ex: Cataloged procedure:

000200 //MYPROC PROC

000210 //STEP2 EXEC PGM=IEFBR14
000220 //DD1 DD DSN=&&TEMP,SPACE=(TRK,(1,1)),
000230 // DCB=(RECFM=FB,BLKSIZE=800,LRECL=80),
000240 // DISP=(NEW,KEEP),UNIT=SYSDA
000250// VOL=SER=INUSR3

Ex: Cataloged procedure called through a JCL :

000100 //UELA009A JOB (AMLAN),NOTIFY=UELA009A,CLASS=A

000110 //LIB1 JCLLIB ORDER=(UELA009A.JCL.SOURCE)
000260 //STEP1 EXEC MYPROC

Nagaraju Domala
 Modifying the Procedure
 The biggest benefit of procedures is that minor adjustments can be made to
the JCL they contain to meet varying processing needs.

 Modify parameters coded on EXEC statements within the procedure (Add,

Replace or nullify any EXEC statement parameter except PGM)

 Modify parameters coded on DD statements within the procedure (Add,

Replace or nullify DD statement parameter)

 Add entirely new DD statements to the procedure

Nagaraju Domala
Modifying the Procedure ( Contd..)
EXEC:

All overriding exec parameters must be coded in the

exec statement that invokes the procedure.
"parameter.stepname=value“
Example:
//S1 EXEC PGM=SAMPLE,PARM=(U,V,W,X),REGION=900k
//IN1 DD DSN=ELTP.FILE1, DISP=OLD

OVERRIDING PARM VALUE

//A1 EXEC ELTP,PARM.s1=(U,V,W,y),REGION=900k

Nagaraju Domala
Modifying the Procedure ( Contd..)
DD:to override any parameters in the dd statement, a
independent DD statement must be coded as given below:

//stepname.ddname dd overriding parameters

NOTE: A dd statement cannot be removed by means of

overriding
Ex:
//IN1 DD DSN=ELTP.FILE1, DISP=OLD

OVERRIDING DSN NAME

//S1.IN1 DD DSN=ELTP.FILE3, DISP=OLD

Nagaraju Domala
 Modifying the Procedure ( Contd..)
• PROCEDURE SSP
 //S1 EXEC PGM=P1,PARM=&PEL

 EXAMPLE 1
 //A EXEC SSP,PEL=FLD
 SUBSTITUTION RESULTS IN :
 //S1 EXEC PGM=P1,PARM=FLD

 EXAMPLE 2
 //B EXEC SSP,PEL=‘FLD,TIME=(5,10)’
 SUBSTITUTION RESULTS IN :
 //S1 EXEC PGM=P1,PARM=FLD,TIME=(5,10)

Nagaraju Domala
 Modifying the Procedure ( Contd..)
 THE PROC STATEMENT :

• The purpose of the proc stmt is to contains symbolic override defaults

• It is an optional stmt but highly recommended if the proc contains symbolic

parameters

• If coded it must be the first stmt in a proc

• When a proc is executed, the system will substitute symbolic parameters

using the symbolic overrides coded in the exec stmt

• For those symbolic overrides not found in the exec stmt, the default symbolic
overrides in the proc stmt will be used

Nagaraju Domala
Modifying the Procedure ( Contd..)
Sample procedure:
//INV3000 PROC
//INV3010 EXEC PGM=INV3010
//SYSOUT DD SYSOUT=&CLASS
//INVMAST DD DSN=&DEPT..INVENTRY.MASTER, DISP=SHR
//INVSEL DD DSN=&&INVSEL,DISP=NEW,SPACE=(CYL,(&SPACE))
//SELCTL DD DUMMY
//INV3020 EXEC PGM=INV3020
//SYSOUT DD SYSOUT=&CLASS
//INVMAST DD DSNAME=&&INVSEL,DISP=(OLD,DELETE)
//INVSLST DD SYSOUT=&CLASS
// PEND

Invoking EXEC statement

//STEPA1 EXEC INV3000,CLASS=M,DEPT=MMA2,SPACE='5,1'

Nagaraju Domala
Modifying the Procedure ( Contd..)
 EFFECTIVE JCL
//INV3010 EXEC PGM=INV3010
//SYSOUT DD SYSOUT=M
//INVMAST DD DSNAME=MMA2.INVENTRY.MASTER,DISP=SHR
//INVSEL DD DSNAME=&&INVSEL,DISP=(NEW,PASS),
// UNIT=SYSDA,SPACE=(CYL,(5,1))
//SELCTL DD DUMMY
//INV3020 EXEC PGM=INV3020
//SYSOUT DD SYSOUT=M
//INVMAST DD DSNAME=&&INVSEL,DISP=(OLD,DELETE)
//INVSLST DD SYSOUT=M

Nagaraju Domala