jclb unit 5

8/21/2019 JCLb Unit 5

1/58

z/OS MVS JCL Intermediate

© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed.

8/21/2019 JCLb Unit 5

2/58

$age 2



()I* +etermining the %%e-ti#e JCL

("ing a Jo Log

Identi%y the JCL in %%e-t

Interpreting rror Me""age"

Corre-ting JCL rror"

*opi-"

8/21/2019 JCLb Unit 5

3/58

$age



Unit Introduction

*hi" 1nit %o-1"e" on identi%ying and -orre-ting -ommon JCL error" that -an o--1r hen a pro-ed1re i" 1"ed.

*hi" 1nit di"-1""e" ho to identi%y an e%%e-ti#e JCL 3the a-t1a! JCL re"1!ting %rom the 1"e o% a pro-ed1re in a

me""age !og.

*hi" 1nit a!"o e5p!ain" ho to !oo6 at "y"tem me""age", error me""age" and the e%%e-ti#e JCL to i"o!ate and

-orre-t -ommon JCL error".

Unit: Determining the Effective JCL

Introd1-tion

8/21/2019 JCLb Unit 5

4/58

$age 4



t the end o% thi" 1nit, yo1 i!! e a!e to

• Identi%y the JCL in e%%e-t at 7o e5e-1tion time ye5amining a 7o !og

• Spe-i%y the part" o% a 7o !og that -an he!p yo1 ana!yzethe e%%e-ti#e JCL

• Identi%y and -orre-t -ommon JCL error" that -an o--1rhen a pro-ed1re i" 1"ed

Unit Objectives


Introd1-tion

8/21/2019 JCLb Unit 5

5/58

$age &




("ing a Jo Log




*opi-"

8/21/2019 JCLb Unit 5

6/58

$age 8



t the end o% thi" topi-, yo1 i!! e a!e to

• Identi%y an e%%e-ti#e JCL

• +e"-rie a 7o !og and "pe-i%y it" -ontent"

• 5p!ain ho to re91e"t a JCL !i"ting

Topic Objectives

Unit: Determining the Effective JCL Topic: Using a Job Log

Introd1-tion

8/21/2019 JCLb Unit 5

7/58

$age :



What is an effective JCL?

;hen a pro-ed1re i" in#o6ed, the "y"tem

-omine" oth the "1mitted JCL and the JCL

that i" "tored ith the pro-ed1re. *he re"1!ting

JCL i" -a!!ed the e%%e-ti#e JCL.

%%e-ti#e JCL i" the JCL in e%%e-t at the time o% 7o

e5e-1tion.

Effective JCL


Con-ept"

8/21/2019 JCLb Unit 5

8/58

$age '



Examining Effective JCL

n e%%e-ti#e JCL i" e5amined %or the %o!!oing rea"on"

• *o en"1re that the e%%e-ti#e JCL "ati"%ie" a!! the pro-e""ing re91irement", parti-1!ar!y i% it -ontain" an1mer o% o#erride" and addition"

• *o %ind the "o1r-e o% the pro!em i% a 7o i" not "1--e""%1!!y e5e-1ted


Con-ept"

8/21/2019 JCLb Unit 5

9/58

$age <



n e%%e-ti#e JCL i" -he-6ed y e5amining the 7o!og.

In addition to the !i"ting o% e%%e-ti#e JCL 1"edd1ring 7o e5e-1tion, a 7o !og -an a!"o -ontainthe %o!!oing

• Sy"tem me""age"

• +etai!ed error me""age" %or "pe-i%i-"tatement" o% e%%e-ti#e JCL

• =e"o1r-e>a!!o-ation/7o>"tep

termination>"tat1" me""age"

Job Log


Sy"tem Me""age"

JES2 JOB LOG--SYSTEM EPP1 - NODE SPC

09.11.58 JOB0355 TEFC452I - JOB NOT RUN-

JCL ERROR

-----JES2 JOB STATISTICS-----

+etai!ed rror Me""age

STMT NO. MESSAGE

3 IEFC630I UNIDENTIFIED EY!ORD

PATM

=e"o1r-e !!o-ation Me""age"

IEF23"1 4BB ALLOCATED TO DD1

Con-ept"

8/21/2019 JCLb Unit 5

10/58

$age ?0



e!uesting a JCL Listing

programmer -an re91e"t that pro-ed1re

"tatement" e !i"ted in a 7o !og y -oding the#a!1e

? a" the %ir"t MS@LVL "1parameter o% the JOB

"tatement.

## JOB ...MSGLE$EL%1

Con"ider the *=)SC* pro-ed1re di"-1""ed in

the %ir"t topi- o% thi" 1nit. *he JCL "tatement" in the

pro-ed1re o1!d e !i"ted on the 7o !og %or

MAJOB.

##MYJOB JOB 3""-44-124"&

## D.ROSE&MSGLE$EL%'1(

##JSTEP1 E)EC TRANSACT


Con-ept"

8/21/2019 JCLb Unit 5

11/58

$age ??



Enter the subparameter that "ou #ou$d code on a job statement to obtain a $isting of procedurestatements% if the" are not inc$uded b" defau$t&

##MYJOB JOB 123&D.GREEN******************************

're We on Trac(?


=e#ie

8/21/2019 JCLb Unit 5

12/58

$age ?2



MS@LVL JOB "tatement parameter that -ontro!" the printing o% JCL "tatement"

and a!!o-ation me""age".

)$ossar"

Unit: Using Special DD Statements Topic: Using Backward Reference

@!o""ary

8/21/2019 JCLb Unit 5

13/58

$age ?



)o that yo1 ha#e -omp!eted thi" topi-, yo1 "ho1!d e a!e to

• Identi%y an e%%e-ti#e JCL

• +e"-rie a 7o !og and "pe-i%y it" -ontent"

• 5p!ain ho to re91e"t a JCL !i"ting

Topic *ummar"


S1mmary

8/21/2019 JCLb Unit 5

14/58

$age ?4




("ing a Jo Log




*opi-"

8/21/2019 JCLb Unit 5

15/58

$age ?&




• Veri%y the 7o !og !i"ting

• Identi%y "pe-ia! notation" in a 7o !og !i"ting

•

Identi%y the "e91en-e o% JCL "tatement" in e%%e-t

• Identi%y JCL that in#o6e" a -ata!oged pro-ed1re

• Identi%y and ana!yze an e%%e-ti#e JCL in a 7o !og

Topic Objectives

Unit: Determining the Effective JCL Topic: Identifying the JCL in Effect

Introd1-tion

8/21/2019 JCLb Unit 5

16/58

$age ?8



*he !i"ting o% a 7o !og -an e 1"ed to #eri%y i% there"1!ting JCL %or the 7o i" hat i" re91ired.

*he 7o !og i" a!"o 1"e%1! to #eri%y the JCL and todi"ting1i"h eteen

•

JCL "tatement" "1mitted• Statement" "tored in the pro-ed1re

• JCL in e%%e-t

In a 7o !og !i"ting, "pe-ia! notation" in -o!1mn" ?, 2,and di"ting1i"h eteen di%%erent -ategorie" o%"tatement" a" "hon on the ne5t "!ide.

Job Log Listing


Con-ept"

8/21/2019 JCLb Unit 5

17/58

$age ?:



+otations in a Job Log Listing

*he ta!e ao#e i!!1"trate" the notation" 1"ed on a 7o !og to identi%y JCL "tatement".

+otations in Co$umns ,%-% and .

*tatement identified

Cata!oged$ro-ed1re

In>"tream$ro-ed1re

// // Statement" yo1 "1mit ith the 7o, in-!1ding in>"tream pro-ed1re de%inition"3i% app!i-a!e and any a!teration" to ++ "tatement".

DD "tatement in a pro-ed1re de%inition that i" 1"ed d1ring a 7o e5e-1tion

/ D/ ++ "tatement in a pro-ed1re de%inition that yo1 ha#e o#erridden

E DD "tatement in a pro-ed1re de%inition, other than a -omment "tatement, thatthe "y"tem -on"ider" to e a -omment

EEE EEE -omment or 7o entry "1"y"tem -ontro! "tatement


Con-ept"

8/21/2019 JCLb Unit 5

18/58

$age ?'



/atch the job $og notations be$o# #ith the (inds of statements the" identif"0

?. D/ . JCL "tatement" yo1 "1mit

2. B. ++ "tatement in an in>"tream pro-ed1re that i" o#erridden

. // C. -omment or -ontro! "tatement

4. EEE +. "tatement %rom a -ata!oged pro-ed1re that i" 1"ed

're We on Trac(?


=e#ie

8/21/2019 JCLb Unit 5

19/58

$age ?<



*he JCL "hon on the right i!!1"trate" ho toidenti%y the JCL in e%%e-t at 7o e5e-1tion timehen 1"ing an in>"tream pro-ed1re.

In the e5amp!e, the JCL i" %or a 7o namedLF*S*2 that in#o6e" an in>"tream pro-ed1renamed *=)SC*. *he JCL %or LF*S*2

-ompri"e" the %o!!oing

• *he JOBLIB "tatement identi%ie" the!irary "toring the program" to ee5e-1ted

•

*he *=)SC* pro-ed1re de%inition appear" eteen the $=OC and $)+"tatement"

• *he %ina! "tatement e5e-1te" thepro-ed1re

JCL in Effect 1 In2*tream 3rocedure

##LA+TEST2 JOB 31SPC090156!&ROSE&

## CLASS%B

##JOBLIB DD DSN%TSOC,IS.TESTJCL.LOAD&

## DISP%S,R

##TRANSACT PROC

##PSTEP1 E)EC PGM%PROG1

##DD1 DD DSN%TSOC,IS.INTRAN&## DISP%S,R

##DD2 DD DSN%TSOC,IS.MASTER&

## DISP%S,R

##DD3 DD SYSOUT%A

##DD4 DD DSN%$ALID&UNIT%SYSDA&

## DISP%'NE!&PASS(&

## SPACE%'TR&'1&1((##PSTEP2 E)EC PGM%PROG2

##DD5 DD DSN%$ALID&

## DISP%'OLD&DELETE(##DD6 DD SYSOUT%A&PEND

##JSTEP E)EC TRANSACT


Con-ept"

8/21/2019 JCLb Unit 5

20/58

$age 20



JCL *tatements in Effect

1. ##LA+TEST2 JOB '31SPCO3090156!(&ROSE&CLASS%B

2. ##JOBLIB DD DSN%TSOC,IS.TESTJCL.LOAD&DISP%S,R

##TRANSACT PROC##PSTEP1 E)EC PGM%PROG1

##DD1 DD DSN%TSOC,IS.INTRAN&DISP%S,R

##DD2 DD DSN%TSOC,IS.MASTER&DISP%S,R

##DD3 DD SYSOUT%A##DD4 DD DSN%$ALID&UNIT%SYSDA&DISP%'NE!&PASS(&SPACE%'TR&'1&1((

##PSTEP2 E)EC PGM%PROG2##DD5 DD DSN%$ALID&DISP%'OLD&DELETE(

##DD6 DD SYSOUT%A## PEND

3. ##JSTEP E)EC TRANSACT

4. TRANSACT PROC

5. ##PSTEP1 E)EC PGM%PROG16. ##DD1 DD DSN%TSOC,IS.INTRAN&DISP%S,R

". ##DD2 DD DSN%TSOC,IS.MASTER&DISP%S,R8. ##DD3 DD SYSOUT%A9. ##DD4 DD DSN%$ALID&UNIT%SYSDA&DISP%'NE!&PASS(&SPACE%'TR&'1&1((

10. ##PSTEP2 E)EC PGM%PROG211. ##DD5 DD DSN%$ALID&DISP%'OLD&DELETE(

12. ##DD6 DD SYSOUT%A

*he JCL portion o% the 7o !og %or LF*S*2 i" "hon ao#e.


Con-ept"

8/21/2019 JCLb Unit 5

21/58

$age 2?



evie# the effective JCL for job L'4TE*T-% on the previous page0 The 55 notation identifies the

JCL statements that are submitted #ith the job that invo(es the T'+*'CT procedure0 Which of

the fo$$o#ing are inc$uded?

. JOB "tatement

B. JOBLIB ++ "tatement

C. ++ o#erride "tatement

+. *=)SC* pro-ed1re de%inition

're We on Trac(?


=e#ie

8/21/2019 JCLb Unit 5

22/58

$age 22



n e5amp!e o% JCL that in#o6e" a -ata!ogedpro-ed1re named COB(CL i" "hon on the right.S*$? o% COB(CL -ompi!e" a COBOL program.

*here are addition and o#erride "tatement" %orS*$? a" %o!!o"

• COB.SASI) i" an addition ++ "tatementthat identi%ie" the "o1r-e mod1!e to e-ompi!ed

• LG+.SASLMO+ i" an o#erride ++"tatement that "pe-i%ie" the data "et and

memer name

JCL in Effect 1 Cata$oged 3rocedure

##LA+MYJOB JOB 31SPCO3090156!&

## ROSE&CLASS%B##JSTEP1 E)EC COBUCL

##COB.SYSIN DD

## DSN%TESTJCL.CNTL'PROG1(&

## DISP%S,R

##LED.SYSLMOD DD

## DSN%TESTJCL.LOAD'PROG1(&

## DISP%S,R&UNIT%3390-1&

## $OL%SER%EDP$T2

Contin1edH


Con-ept"

8/21/2019 JCLb Unit 5

23/58

$age 2



*he e5amp!e o% JCL that in#o6e" a -ata!ogedpro-ed1re named COB(CL "hon on the right,here S*$2 !in6 edit" the re"1!ting COBOLo7e-t program.

*here are addition and o#erride "tatement" %orS*$2 a" %o!!o"

• COB.SASI) i" an addition ++ "tatementthat identi%ie" the "o1r-e mod1!e to e-ompi!ed

• LG+.SASLMO+ i" an o#erride ++

"tatement that "pe-i%ie" the data "et andmemer name

JCL in Effect 1 Cata$oged 3rocedure 6cont7d8

##JSTEP2 E)EC COBUCL

##COB.SYSIN DD

## DSN%TESTJCL.CNTL'PROG2(&

## DISP%S,R

##LED.SYSLMOD DD

## DSN%TESTJCL.LOAD'PROG2(&## DISP%S,R


Con-ept"

8/21/2019 JCLb Unit 5

24/58

$age 24



portion o% the e%%e-ti#e JCL in the 7o !og %or LFMAJOB i" "hon ao#e. *he JCL "tatement" that are"1mitted are identi%ied y the // notation. *he "tatement" %rom the pro-ed1re de%inition that are 1"ed areidenti%ied y the notation.

*he addition ++ "tatement %or pro-ed1re "tep COB i" "tatement ??. *he o#erride "tatement %or pro-ed1re"tep LG+ 3"tatement ?& appear" at the point here the ++ "tatement to e o#erridden appear". *he"tatement to e o#erridden i" pre-eded y the / notation.

Effective JCL in a Job Log

1. ##LA+MYJOB JOB 3ISPCO3090156!&ROSE&MSGCLASS%T&CLASS%T&MSGLE$EL'1&1(2. ##JSTEP1 E)EC COBUCL

3. ))COBUCL PROC

4. ))COB E)EC PGM%IFCBL00

5. ))SYSPRINT DD SYSOUT%/

6. ))SYSUT1 DD UNIT%SYSDA&SPACE%'CYL&'1&1((

". ))SYSUT2 DD UNIT%SYSDA&SPACE%'CYL&'1&1((8. ))SYSUT3 DD UNIT%SYSDA&SPACE%'CYL&'1&1((

9. ))SYSUT4 DD UNIT%SYSDA&SPACE%'CYL&'1&1((

10.))SYSLIN DD DSN%//LOADSET&UNIT%SYSDA&

)) DISP%'MOD&PASS(&SPACE%9TR&93&300&DCB%BLSIE%800

11.##COB.SYSIN DD DSN%TESTJCL.CNTL'PROG1(&DISP%S,R

12.))LED E)EC PGM%IE!&PARM%LIST&MAP&COND%'5&LT&COB(&

. . .

15.##LED.SYSLMODDD DSN%TESTJCL.LOAD'PROG1(&UNIT%SYDA&DISP%S,R

)#SYSLMOD DD DSN%GOSET&DISP%'&PASS(&NIT%SYSDA&SPACE%'CYL&'1&1&1&(0


Con-ept"

8/21/2019 JCLb Unit 5

25/58

$age 2&



evie# the effective JCL in job $og for L'4/9JO:% on the previous s$ide0 +otice that the s"stem

merges the cata$oged procedure statements into the job stream at the appropriate p$aces0 Order

the fo$$o#ing statements to ref$ect the se!uence of effective JCL in the examp$e0

. Statement" o% pro-ed1re "tep COB

B. C "tatement to in#o6e the pro-ed1re

C. ddition "tatement %or COB

+. JOB "tatement

. ++ "tatement that i" o#erridden

. Statement o% pro-ed1re "tep LG+

@. O#erride "tatement %or pro-ed1re "tep LG+

're We on Trac(?


=e#ie

8/21/2019 JCLb Unit 5

26/58

$age 28



)$ossar"

JOBLIB "pe-ia! ++ "tatement that identi%ie" in a pri#ate !irary, hereprogram" re"ide.


@!o""ary

8/21/2019 JCLb Unit 5

27/58

$age 2:



Topic *ummar"


• Veri%y the 7o !og !i"ting

• Identi%y "pe-ia! notation" in a 7o !og !i"ting

• Identi%y the "e91en-e o% JCL "tatement" in e%%e-t

• Identi%y JCL that in#o6e" a -ata!oged pro-ed1re

• Identi%y and ana!yze an e%%e-ti#e JCL in a 7o !og


S1mmary

8/21/2019 JCLb Unit 5

28/58

$age 2'




("ing a Jo Log




*opi-"

8/21/2019 JCLb Unit 5

29/58

$age 2<




• I"o!ate JCL "tatement" -a1"ing error me""age"

• 5amine a "y"tem me""age

•

=e-ognize the "tatement n1mer a""o-iated ith anerror me""age

• Identi%y and interpret error me""age"

Topic Objectives

Unit: Determining the Effective JCL Topic: Interpreting Error Messages

Introd1-tion

8/21/2019 JCLb Unit 5

30/58

$age 0



JCL *tatements Causing Error /essages

In%ormation pro#ided in the 7o !og -an a!"o e 1"ed to i"o!ate JCL "tatement" -a1"ing error me""age". *heerror" -an e -orre-ted in the C and ++ "tatement" that are "1mitted hen yo1 in#o6e the pro-ed1re.

*o i"o!ate and -orre-t JCL error", yo1 may ha#e to e5amine the %o!!oing portion" o% the 7o !og, i!!1"trated inthe ne5t "!ide

• *he "y"tem me""age"

• *he !i"ting o% e%%e-ti#e JCL

• *he detai!ed error me""age" %or "pe-i%i- "tatement"

• *he re"o1r-e>a!!o-ation me""age" %or "pe-i%i- "tatement"

Contin1edH


Con-ept"

8/21/2019 JCLb Unit 5

31/58

$age ?



Job Log

1. ##LA+TEST2 JOB '31SPCO3090156!(&ROSE&CLASS%B2. ##JOBLIB DD DSN%TSOC,IS.TESTJCL.LOAD&DISP%S,R

##TRANSACT PROC##PSTEP1 E)EC PGM%PROG1

##DD1 DD DSN%TSOC,IS.INTRAN&DISP%S,R

##DD2 DD DSN%TSOC,IS.MASTER&DISP%S,R##DD3 DD SYSOUT%A

##DD4 DD DSN%$ALID&UNIT%SYSDA&DISP%'NE!&PASS(&SPACE%'TR&'1&1((

##PSTEP2 E)EC PGM%PROG2##DD5 DD DSN%$ALID&DISP%'OLD&DELETE(##DD6 DD SYSOUT%A

## PEND

3. ##JSTEP E)EC TRANSACT4. TRANSACT PROC

5. ##PSTEP1 E)EC PGM%PROG16. ##DD1 DD DSN%TSOC,IS.INTRAN&DISP%S,R

". ##DD2 DD DSN%TSOC,IS.MASTER&DISP%S,R8. ##DD3 DD SYSOUT%A9. ##DD4 DD DSN%$ALID&UNIT%SYSDA&DISP%'NE!&PASS(&SPACE%'TR&'1&1((

10. ##PSTEP2 E)EC PGM%PROG2

11. ##DD5 DD DSN%$ALID&DISP%'OLD&DELETE(

12. ##DD6 DD SYSOUT%A

*he JCL portion o% the 7o !og i" "hon ao#e.


Con-ept"

8/21/2019 JCLb Unit 5

32/58

$age 2



n e5amp!e o% a "y"tem me""age i" "hon ao#e. Sy"tem me""age" appear at the eginning o% a 7o !og.*hey gi#e in%ormation "1-h a" time o% the 7o, the 7o n1mer a""igned interna!!y, and 7o "tati"ti-".

I% the 7o i" not r1n e-a1"e o% a JCL error, a "y"tem me""age indi-ating the error i!! appear in thi" part o%the 7o !og.

JCL Error 1 *"stem /essage

JES2 JOB LOG SYSTEM EPP1 NODE SPC

09.11.58 JOB0355 TEFC452I JOB NOT RUN JCL ERROR

----JES2 JOB STATISTICS ----

1" CARDS READ

42 SYSOUT PUNC, RECORDS

0 SYSOUT PUNC, BYTES0.00 MINUTES E)ECUTION TIME

TIME


Con-ept"

8/21/2019 JCLb Unit 5

33/58

$age



*he e5amp!e ao#e "ho" detai!ed error me""age" %or LF*S*. *he"e type" o% me""age" appear at theend o% the 7o !og.

*he to arning me""age" that appear here to dra the 1"er" attention to 1nre"o!#ed ++)M 6eyordoperand" are JCL "tatement" ?< and &. In thi" -a"e, the 1nre"o!#ed operand" do not pre#ent the 7o %rome5e-1ting. !ater re"o1r-e a!!o-ation "tatement indi-ate" that the data "et a" a""igned d1mmy "tat1".

JCL Error /essages

STMT NO. MESSAGE

19 IEF6861 DDNAME REFERRED TO ON

DDNAME EY!ORD IN PRIOR STEP !AS

NOT RESOL$ED

35 IEF6861 DDNAME REFERRED TO ON

DDNAME EY!ORD IN PRIOR STEP !AS

NOT RESOL$ED----------

----------

IEF23"1 DMY ALLOCATED TO


Con-ept"

8/21/2019 JCLb Unit 5

34/58

$age 4



/atch the items from a job $og #ith the (ind of information the" can give "ou about a procedure&

?. =e"o1r-e a!!o-ation me""age" . ;hether or not a 7o ha" r1n

2. %%e-ti#e JCL B. "pe-i%i- pro!em and the "tatement in hi-h itmay appear

. +etai!ed rror Me""age" C. *he JCL the "y"tem ha" e5e-1ted

4. Sy"tem Me""age" +. Ko "y"tem re"o1r-e" are 1"ed

're We on Trac(?


=e#ie

/OS MVS JCL I t di t

8/21/2019 JCLb Unit 5

35/58

$age &



Sometime" the "tatement n1mer a""o-iated ith an error me""age i" not the a-t1a! "tatement to hi-h the

me""age app!ie". In thi" e5amp!e, "tatement ?< i" a""o-iated ith the error me""age. Koe#er, the errora-t1a!!y o--1r" in "tatement ?' a" "hon in the 7o !og.

" the "y"tem interpreted the JCL %or thi" 7o, it e5pe-ted "tatement ?< to e a ++ "tatement to a""ign a #a!1eto the ++)M operand in "tatement ?'. ;hen the "y"tem en-o1ntered an C "tatement in"tead, it-reated a me""age %or "tatement ?

8/21/2019 JCLb Unit 5

36/58

$age 8



" another e5amp!e o% interpreting error me""age", e5amine the "y"tem me""age" %or a 7o named

LS*S*< a" "hon ao#e to an"er the 91e"tion on the ne5t "!ide.

*"stem /essage 1 'n Examp$e

JES2 JOB LOG%%SYSTEM EPPI@MODE

SPC

16.31.28 JOBO3361 LASTEST9 STARTED@INIT 3"@CLASST@SYS EPPI

16.31.28 JOBO3361 IEF4581 LASTEST9 STARTED16.31.29 JOBO3361 IEC1301 DD2 DD STATEMENT MISSING

16.31.29 JOBO3361 LASTEST9 ENDED


Con-ept"


8/21/2019 JCLb Unit 5

37/58

$age :



In the examp$e on the previous s$ide% #hich one of the fo$$o#ing prob$ems is identified b" the

s"stem messages&

. *he 7o did not e5e-1te

B. ++ "tatement ++2 i" mi""ing

C. *here a" a JCL error

+. n operand a" 1nre"o!#ed

're We on Trac(?


=e#ie


8/21/2019 JCLb Unit 5

38/58

$age '



5amine the JCL !i"ting %or LS*S*< on theright. )ote that the pro-ed1re de%inition doe" notin-!1de a ++ "tatement named ++2.

Koe#er, a !ater addition "tatement 3"tatement

8/21/2019 JCLb Unit 5

39/58

$age <



efer to the effective JCL for L'*TE*T; on the previous s$ide0 :ased on this JCL% #hich of the

fo$$o#ing do "ou thin( is the $i(e$" cause of the error?

. n in-orre-t!y "e91en-ed addition "tatement

B. n in#a!id name %or an addition "tatement 3++I), not ++2

C. n in-orre-t!y "e91en-ed o#erride "tatement

're We on Trac(?


=e#ie


8/21/2019 JCLb Unit 5

40/58

$age 40



)$ossar"

(nre"o!#ed )ot a""igned a #a!1e at pro-ed1re e5e-1tion.


@!o""ary


8/21/2019 JCLb Unit 5

41/58

$age 4?



Topic *ummar"


• I"o!ate JCL "tatement" -a1"ing error me""age"

• 5amine a "y"tem me""age

•

=e-ognize the "tatement n1mer a""o-iated ith anerror me""age

• Identi%y and interpret error me""age"


S1mmary


8/21/2019 JCLb Unit 5

42/58

$age 42




("ing a Jo Log




*opi-"


8/21/2019 JCLb Unit 5

43/58

$age 4




• *ra-6 the "o1r-e o% JCL error"

• Identi%y -ommon JCL error"

• Corre-t JCL error"

Topic Objectives

Unit: Determining the Effective JCL Topic:Correcting JCL Errors

Introd1-tion


8/21/2019 JCLb Unit 5

44/58

$age 44



Common JCL Errors

It -an e he!p%1! to 6no the ay the "y"tem interpret" JCL, hi!e tra-6ing the "o1r-e o% JCL error". *hea-t1a! -a1"e o% the error may di%%er %rom the -a1"e identi%ied in a detai!ed error me""age.

Common JCL error" made hen in#o6ing pro-ed1re" are

• Spe-i%ying C "tatement modi%i-ation" in an in-orre-t "e91en-e

• Mi""pe!!ing 6eyord parameter"

• Spe-i%ying o#erride and addition ++ "tatement" in an in-orre-t "e91en-e

• Spe-i%ying an in#a!id name %or an o#erride or addition ++ "tatement"

• Vio!ating JCL "ynta5 r1!e"


Con-ept"


8/21/2019 JCLb Unit 5

45/58

$age 4&



-ommon pro-ed1re 1"age error i" C "tatement modi%i-ation" that are not in -orre-t "e91en-e, that i",

not in pro-ed1re "tep "e91en-e. *he me""age" e!o indi-ate the 6ind o% "y"tem and error me""age thatmight re"1!t

• *he "y"tem me""age" !i"ted at the eginning o% the 7o !og indi-ate that the 7o did not e5e-1tee-a1"e o% a JCL error.

• *he detai!ed error me""age at the end o% the 7o indi-ate" that the "tep to e o#erridden a" not%o1nd in the pro-ed1re. *he o%%ending "tatement i" "tatement n1mer o% e%%e-ti#e JCL.

E

8/21/2019 JCLb Unit 5

46/58

$age 48



n e5amp!e o% the "tatement o% e%%e-ti#e JCL!i"ting i" on the right. *he C "tatement -odedto in#o6e the pro-ed1re -ontain" an error.

*he *IM parameter addition %or the $S*$2C "tatement o% the pro-ed1re i" "pe-i%iede%ore the $=M parameter addition %or the

$S*$? C "tatement. *he modi%i-ation" arenot "pe-i%ied in pro-ed1re "tep "e91en-e.

E

8/21/2019 JCLb Unit 5

47/58

$age 4:



=o# does the s"stem interpret the JCL?

;hen interpreting the JCL %or thi" 7o, the "y"tem"-an" the pro-ed1re "tep "e91en-e. It pa""e"thro1gh $S*$?, then add" the *IM parameterto $S*$2.

;hen it en-o1nter" the $=M parameteraddition, it -annot %ind a pro-ed1re "tep named$S*$? that %o!!o" $S*$2. It there%ore i""1e"the diagno"ti- that the "tep to e o#erridden-annot e %o1nd in the pro-ed1re.

Interpreting the JCL

3.##JSTEP E)EC TRANSACT& ## TIME.PSTEP2%1&

## PARM.PSTEP1%NOC,EC


Con-ept"


8/21/2019 JCLb Unit 5

48/58

$age 4'



evie# the statement used to invo(e the T'+*'CT procedure in the previous examp$e

3. ##JSTEP E)EC TRANSACT&TIME.PSTEP2%1&PARM.PSTEP1%NOC,EC

Code a -orre-t JCL "tatement to in#o6e the pro-ed1re ith the "pe-i%ied C "tatement addition".

##JSTEP E)EC TRANSACT&******************

're We on Trac(?


=e#ie


8/21/2019 JCLb Unit 5

49/58

$age 4<



nother -ommon JCL error i" mi""pe!!ing o% 6eyord operand" on the C or ++ "tatement". *he part" o%a 7o !og %or an in>"tream pro-ed1re named *=)SC* i" "hon ao#e. *he %o!!oing in%ormation i"pro#ided in the 7o !og

• *he "y"tem me""age" !i"ted at the eginning o% the 7o !og indi-ate that the 7o did not e5e-1tee-a1"e o% a JCL error.

• *he detai!ed me""age at the end o% the 7o indi-ate" an 1nidenti%ied 6eyord. *he o%%ending"tatement i" "tatement n1mer o% the e%%e-ti#e JCL, here $=M i" "pe!t a" $*M.

/isspe$$ing of >e"#ord Operands

----JES2 JOB LOG SYSTEM EPP1 NODE SPC

10.06.51 JOB02"02 IEFC452I LA+TEST5 JOB NOT RUN JCL ERROR

---JES2 JOB STATITICS---

20 CARDS READ

34 SYSOUT PRINT RECORDS

0 SYSOUT PUNC, RECORDS

2 SYSOUT SPOOL BYTES

0.00 MINUTES E)ECUTION TIME

STMT NO. MESSAGE 3 IEFC630I UNIDENTIFIED EY!ORD PATM


Con-ept"


8/21/2019 JCLb Unit 5

50/58

$age &0



're We on Trac(?

Examine statement number . of the effective JCL $isting0 Identif" the error in the E

8/21/2019 JCLb Unit 5

51/58

$age &?



*e!uence of *tatements

Improper "e91en-e o% o#erride and addition ++ "tatement" i" another -ommon JCL error. *hey -an e moredi%%i-1!t to diagno"e than tho"e %or C "tatement".

*he "pe-i%i-ation o% an addition ++ "tatement e%ore an o#erride ++ "tatement i" a parti-1!ar!y di%%i-1!t errorto i"o!ate. I% oth type" o% ++ "tatement are re91ired %or the "ame pro-ed1re "tep, the "y"tem doe" notre-ognize thi" a" an error. *he program e5e-1te" itho1t detai!ed error me""age". Koe#er, the error i"re%!e-ted in the o1tp1t o% the program, hi-h may e a"ed on in-orre-t data.

Se91en-ing r1!e" %or -oding o#erride and addition ++ "tatement" ithin a pro-ed1re "tep i" a" %o!!o"

?. Spe-i%y a!! o#erride ++ "tatement" %or a pro-ed1re "tep in "ame order a" in the pro-ed1re.

2. Spe-i%y any addition ++ "tatement" %or that "tep.


Con-ept"


8/21/2019 JCLb Unit 5

52/58

$age &2



" an e5amp!e o% the e%%e-t" o% in-orre-t"e91en-ing, -on"ider the *=)SC* pro-ed1rede%inition, the data "et I)*=) i" re!ated to ++?.

##DD1 DD DSN%INTRAN&DISP%S,R

*he 1"er intend" to in#o6e $S*$? o% thepro-ed1re 1"ing a data "et named );*=),rather than I)*=). Koe#er, the 1"er in-orre-t!y-ode" an o#erride "tatement %or $S*$? a%ter a#a!id addition "tatement.

3. ##JSTEP E)EC TRANSACT&

## PARM.PSTEP1%C,EC9. ##PSTEP1.DD2 DD DSN%MASTER&

## DISP%S,R

10.##PSTEP1.DD1 DD

## DSN%NE!TRAN&DISP%S,R

*e!uence of *tatements 1 'n Examp$e

Contin1edH

/'*TE

I+T'+


Con-ept"

+EWT'+

6I+TE+E O@EIE8


8/21/2019 JCLb Unit 5

53/58

$age &© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed.

*he 7o e5e-1te" "1--e""%1!!y %rom the "y"tem"#iepoint. *here are no detai!ed error me""age"in the 7o !og. Koe#er, the program in#o6ed in$S*$? e5e-1te" 1"ing data %rom the data "etre!ated to ++? in the pro-ed1re de%inition3I)*=), rather than the data %rom );*=).

*he "y"tem treat" "tatement ?0 a" anotheraddition "tatement, e-a1"e it i" "pe-i%ied a%terrather than e%ore, a pre#io1" #a!id addition"tatement.

*e!uence of *tatements 1 'n Examp$e 6cont7d8

/'*TE

6I+TE+E O@EIE8

I+T'+

I+COECT OUT3UT

+EWT'+

6WO+) O@EIE8

? 00 ?


Con-ept"

? 00 ?


8/21/2019 JCLb Unit 5

54/58

$age &4© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed.

*he e%%e-ti#e JCL portion o% the 7o !og "hon onthe right rein%or-e" the -on-!1"ion in the e5amp!e.

*he ++? ++ "tatement 3"tatement n1mer 8a" not o#erridden. *he D/ or / notation"pre-ede "tatement" that are o#erridden. *hat i",the data "et name a""o-iated ith ++? i" "ti!!

I)*=).

Effective JCL 1 Job Log

1.##LASTEST JOB...ROSE&CLASS%B

2.##JOBLIB DD DSN%TESTJECL&

## DISP%S,R

##TRANSACT PROC

##PSTEP1 E)EC PGM%PROG1

##DD1 DD DSN%INTRAN&DISP%S,R

--------

3.##JSTEP E)EC TRANSACT&

## PARM.PSTEP1%C,EC

4.TRANSACT PROC

5.PSTEP1 E)EC PGM%PROG1

6.##PSTEP1.DD1 DD DSN%NE!TRAN&

## DISP%S,R DD1 DD

DSN%INTRAN&DISP%S,R


Con-ept"


8/21/2019 JCLb Unit 5

55/58

$age &&© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed.

're We on Trac(?

evie# the override statements that the user coded0

9. ##PSTEP1.DD1 DD DSN%NE!TRAN&

## DISP%S,R

10.##PSTEP1.DD2 DD DSN%MASTER&

## DISP%S,R

Code the o#erride "tatement to -orre-t the error in the e5amp!e "hon ao#e.

##PSTEP1************************


=e#ie


8/21/2019 JCLb Unit 5

56/58

$age &8© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed.

're We on Trac(?

evie# the override statements that the user coded0

9. ##PSTEP1.DD1 DD DSN%NE!TRAN&

## DISP%S,R

10.##PSTEP1.DD2 DD DSN%MASTER&

## DISP%S,R

Code the addition "tatement to -orre-t the error in the e5amp!e "hon ao#e.

##PSTEP1.DD1 DD DSN%NE!TRAN&DISP%S,R

##PSTEP1************************


=e#ie


8/21/2019 JCLb Unit 5

57/58

$age &:© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed.

Topic *ummar"


• *ra-6 the "o1r-e o% JCL error"

• Identi%y -ommon JCL error"

•

Corre-t JCL error"


S1mmary


8/21/2019 JCLb Unit 5

58/58

)o that yo1 ha#e -omp!eted thi" 1nit, yo1 "ho1!d e a!e to

• Identi%y the JCL in e%%e-t at 7o e5e-1tion time ye5amining a 7o !og

• Spe-i%y the part" o% a 7o !og that -an he!p yo1 ana!yze

the e%%e-ti#e JCL

• Identi%y and -orre-t -ommon JCL error" that -an o--1rhen a pro-ed1re i" 1"ed

Unit *ummar"


jclb unit 5

Documents