jclb unit 6

8/21/2019 JCLb Unit 6

1/80

z/OS MVS JCL Intermediate

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

8/21/2019 JCLb Unit 6

2/80


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

'(I) Sym*o!i+ $arameter"

(M- and Sym*o!i+ $arameter"

)he (M- $arameter

Sym*o!i+ $arameter"

--C Statement $arameter

""igning i%%erent Va!e"

Statement $arameter"

e%a!t Va!e"

)opi+"

8/21/2019 JCLb Unit 6

3/80



In ear!ier nit" yo ha#e "een that pro+edre" +an *e modi%ied hen they are e3e+ted "ing o#erride and

addition "tatement". oe#er, the"e modi%i+ation" are "*5e+t to "tri+t "e6en+ing r!e", and they are not

a!ay" +on#enient to imp!ement.

)hi" nit de"+ri*e" to te+hni6e" that +an pro#ide an a!ternati#e, and o%ten ea"ier, mean" o% modi%ying

pro+edre" %or e3e+tion

• '"ing the (M- parameter on pro+edre "tatement"

• '"ing "ym*o!i+ parameter" on pro+edre --C and "tatement"

I% the"e parameter" are in+!ded in the pro+edre de%inition hen it i" +oded, #a!e" +an *e ea"i!y a""igned

at the time o% e3e+ting a pro+edre.

Unit Introduction

Unit: Symbolic Parameters

Introd+tion

8/21/2019 JCLb Unit 6

4/80



t the end o% thi" nit, yo i!! *e a*!e to

• 'nder"tand the prpo"e and %orm o% the (M-parameter in a pro+edre de%inition

• 7e"o!#e the (M- parameter hen e3e+ting apro+edre *y identi%ying the a+ta! data "et name" andattri*te" repre"ented *y the (M- parameter

• 'nder"tand the prpo"e and %orm o% "ym*o!i+parameter" in a pro+edre de%inition

• ""ign #a!e" to "ym*o!i+ parameter" at the time o%in#o8ing a pro+edre

Unit Objectives


Introd+tion

8/21/2019 JCLb Unit 6

5/80





)he (M- $arameter

Sym*o!i+ $arameter"




e%a!t Va!e"

)opi+"

8/21/2019 JCLb Unit 6

6/80


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

t the end o% thi" topi+, yo i!! *e a*!e to

• Identi%y the parameter #ariation" in pro+edre"

• Identi%y the te+hni6e" "ed to modi%y the parameter"

Topic Objectives

Unit: Symbolic Parameters Topic: DDNAME and Symbolic Parameters

Introd+tion

8/21/2019 JCLb Unit 6

7/80


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

Variation" in pro+edre "tatement" +an *e 6ite

+ommon *eteen di%%erent in"tan+e" o% a

pro+edre" "e to the ne3t, "+h a"

• (ame, !o+ation, or other attri*te" o%one or more data "et" identi%ied in thepro+edre

• (ame" o% one or more program" to *ee3e+ted

Parameter Variation in Procedure

Contined?


Con+ept"

8/21/2019 JCLb Unit 6

8/80


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

)he"e #ariation" +an *e a++ommodated *y

temporari!y modi%ying the pro+edre at the

time the pro+edre i" e3e+ted.

)hi" i" a++omp!i"hed *y adding or o#erriding

parameter" on the pro+edre --C and

"tatement".

)he"e modi%i+ation" are "*5e+t to "tri+t

%ormatting and "e6en+ing r!e".

Parameter Variation in Procedure (cont’d)

INTRAN

NEWTRAN

TRANSACT


Con+ept"

8/21/2019 JCLb Unit 6

9/80


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

I% #ariation" in pro+edre are +ommon, o#erride

and addition "tatement" +an *e a#oided.

!ternati#e" to "ing o#erride and addition

"tatement" are

• '"e the (M- parameter on one ormore "tatement" in the pro+edrede%inition

• '"e "ym*o!i+ parameter" to repre"ent--C or "tatement parameter" inthe pro+edre de%inition

Techniques to Change Parameters


Con+ept"

8/21/2019 JCLb Unit 6

10/80


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

A parameter is an actua! data set and its attributes"

Are #e on Trac$%


7e#ie

8/21/2019 JCLb Unit 6

11/80


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

(o that yo ha#e +omp!eted thi" topi+, yo "ho!d *e a*!e to

• Identi%y the parameter #ariation" in pro+edre"

• Identi%y the te+hni6e" "ed to modi%y the parameter"

Topic &ummar'


Smmary

8/21/2019 JCLb Unit 6

12/80





)he (M- $arameter

Sym*o!i+ $arameter"




e%a!t Va!e"

)opi+"

8/21/2019 JCLb Unit 6

13/80




• i"+"" the need %or the (M- parameter in apro+edre

• Identi%y the %orm o% a (M- parameter in apro+edre

• 7e"o!#e a (M- parameter

• Identi%y the +omponent" in a (M- parameter

Topic Objectives

Unit: Symbolic Parameters Topic: The DDNAME Parameter

Introd+tion

8/21/2019 JCLb Unit 6

14/80



)he (M- parameter i" "ed in a pro+edre

de%inition to repre"ent an inpt data "et.

It permit" the pro+edre "er to de%ine data "et

attri*te" at the time the pro+edre i" in#o8ed.

)he e3amp!e on the right "ho" that at #ario"time" the inpt data %or a pro+edre +o!d re"ide

on a dire+t a++e"" #o!me or a tape.

Input ata &treams

TRANSACT

(TAPE)

(DIRECT

ACCESS

VOLUMES)

A 00 A

A 00 A


Con+ept"

8/21/2019 JCLb Unit 6

15/80



epresenting an Input ata &tream

)he (M- parameter +on"i"t" o%

• parameter name (M- %o!!oed *y an e6a! "ign

• #a!e in thi" e3amp!e I($')

=or e3amp!e

//DD1 DD DDNAME=INPUT


Con+ept"

8/21/2019 JCLb Unit 6

16/80


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

)he )7(SC) pro+edre de%inition ith a

(M- parameter to repre"ent the inpt data

"et i" "hon on the right.

epresenting an Input ata &tream * An +,amp!e

//PSTEP1 EXEC PGM=PROG1,

//DD1 DD DDNAME=INPUT

//DD2 DD DSN=MASTER,DISP=SHR

//DD3 DD SYSOUT=A

//DD4 DD DSN=&&VALID,

// DISP=(NEW,PASS),

// UNIT=SYSDA,// SPACE=(TR,(1,1))

//PSTEP2 EXEC PGM=PROG2,//DD! DD DSN=&&VALID,

// DISP=(OLD,DELETE)


Con+ept"

8/21/2019 JCLb Unit 6

17/80


© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed. $age A; o% &0

t the time o% e3e+tion to in#o8e the pro+edre,yo o!d +ode

• n --C "tatement that e3e+te" thepro+edre

• "tatement to identi%y the attri*te"o% the data "et repre"ented *y(M-DI($')

)hi" i" +a!!ed re"o!#ing the (M- parameter.

=or e3amp!e, the (M- i" re"o!#ed ith a

data "et named I()7( a" "hon in the +ode

//STEP EXEC TRANSACT

//PSTEP1"INPUT DD DSN=INTRAN,

// DISP=SHR

eso!ving the -A.+ parameter

Contined?

TRANSACT

INTRAN

A 00 A


Con+ept"

8/21/2019 JCLb Unit 6

18/80


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

)he "tatement that re"o!#e" the (M-

parameter ha" to +omponent"

• )he name o% the pro+edre "tep inhi+h the "tatement +ontaining the(M- parameter i" "ed, %o!!oed*y a period

• )he #a!e a" "pe+i%ied in the (M-parameter

eso!ving the -A.+ parameter (cont’d)


//PSTEP1"INPUT DD DSN=INTRAN,

// DISP=SHR

Procedure

stepe/ines

the dataset

Va!ue

&peci/ies that the

data set is used

shared access mode


Con+ept"

8/21/2019 JCLb Unit 6

19/80


© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed. $age A@ o% &0

The /o!!o0ing is a procedure ca!!ed .1POC" The procedure uses the -A.+ parameter torepresent the data set in P&T+P2"

Code a statement to invo$e the procedure"

//#STEP EXEC $$$$$$$$$$$$$$$

Are #e on Trac$%

//PSTEP1 EXEC PGM=PGM1//DD1 DD DDNAME=INPUT


7e#ie

8/21/2019 JCLb Unit 6

20/80



The /o!!o0ing is a procedure ca!!ed .1POC" The procedure uses the -A.+ parameter torepresent the data set in P&T+P2"

Code a statement to reso!ve the -A.+ parameter 0ith a data set named .1ATA"

//#STEP EXEC MYPROC

$$$$$$$$$$$$$$$$$$$

Are #e on Trac$%

//PSTEP1 EXEC PGM=PGM1//DD1 DD DDNAME=INPUT


7e#ie

8/21/2019 JCLb Unit 6

21/80


© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed. $age 2A o% &0

)o e3e+te the )7(SC) pro+edre, the "er

e3e+te" the pro+edre "ing a data "et named

ME) in "hared a++e"" mode.

ME) re"ide" on a 11@0 dire+t a++e""

#o!me ith a #o!me identi%ier o% 49:;&F.

In thi" +a"e, the (M- parameter i" re"o!#ed

ith the data "et name o% ME).


//PSTEP1"INPUT DD DSN=MYDATA,

// UNIT=33%,// VOL=SER=4!'*

eso!ving the -A.+ parameter * +,amp!e 2

TRANSACT

MYDATA


Con+ept"

8/21/2019 JCLb Unit 6

22/80



)he (M- parameter in the "ame pro+edre

i" re"o!#ed %or "ing di%%erent inpt data.

)he "er in#o8e" the )7(SC) pro+edre and

dire+t" that inpt data *e ta8en %rom +ard image"

"pp!ied in the 5o* "tream.

eso!ving the -A.+ parameter * +,amp!e 3

//STEP EXEC TRANSACT//PSTEP1"INPUT DD +

(-.0 0 567)

"

"

"/+


Con+ept"

8/21/2019 JCLb Unit 6

23/80



I% an inpt data "et i" not needed %or the e3e+tion o% the pro+edre then the "tatement to identi%y thedata

"et "ho!d not *e +oded.

)he nre"o!#ed (M- i" atomati+a!!y treated a" a dmmy.

Avoiding an Input ata &et


Con+ept"

8/21/2019 JCLb Unit 6

24/80



)he (M- parameter +an *e "ed in a pro+edre de%inition in a" many a" %i#e "tatement" ithin ea+h

pro+edre "tep.

)he "e6en+ing r!e" to *e %o!!oed hen re"o!#ing (M- parameter" are

• )hey m"t *e +oded in pro+edre "tep "e6en+e

• "tatement" to re"o!#e (M- parameter" are +on"idered addition" and "ho!d *e "e6en+eda" "+h that i", in pro+edre "tep "e6en+e

• I% m!tip!e (M- parameter" are "pe+i%ied in a "ing!e "tep o% the pro+edre de%inition, the "tatement" to re"o!#e them +an *e +oded in any "e6en+e

u!es /or eso!ving -A.+ Parameters


Con+ept"

8/21/2019 JCLb Unit 6

25/80



The /o!!o0ing is a procedure ca!!ed A-1POC4

Code the statements required to reso!ve the procedure’s #++5-O -A.+ parameters tospeci/' #++5-O as an e,isting data set named #++53"

//#STEP EXEC ANYPROC

//$$$$$$$$$$$$$$$$$$$$$$$$$

Are #e on Trac$%

//PSTEP1 EXEC PGM=C8L!

//IN DD DDNAME=WEENO//OUT DD DSN=&&TEMP,

// DISP=(NEW,PASS),UNIT=SYSDA,// SPACE=(TR,(1,1))

//PSTEP2 EXEC PGM=C8L'

//PSD DD DSN=&&TEMP,DISP=(OLD,DELETE)//RPT DD DDNAME=OUTPUT


7e#ie

8/21/2019 JCLb Unit 6

26/80


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

The /o!!o0ing is a procedure ca!!ed A-1POC4

Code the statements required to reso!ve the procedure’s OUTPUT -A.+ parameters to speci/'OUTPUT to be a data set named &AV+"

//#STEP EXEC ANYPROC

//PSTEP1"WEENO DD DSN=WEE2

//$$$$$$$$$$$$$$$$$$$$$$$$$

Are #e on Trac$%

//PSTEP1 EXEC PGM=C8L!

//IN DD DDNAME=WEENO//OUT DD DSN=&&TEMP,

// DISP=(NEW,PASS),UNIT=SYSDA,// SPACE=(TR,(1,1))

//PSTEP2 EXEC PGM=C8L'

//PSD DD DSN=&&TEMP,DISP=(OLD,DELETE)//RPT DD DDNAME=OUTPUT


7e#ie

8/21/2019 JCLb Unit 6

27/80


© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed. $age 2; o% &0

'MME G parameter +oded in the "tatement that in"tr+t" the "y"tem to ignore a!! other parameter", ith the e3+eption o% CB.

6!ossar'

H!o""ary


8/21/2019 JCLb Unit 6

28/80


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


• i"+"" the need %or the (M- parameter in apro+edre

• Identi%y the %orm o% a (M- parameter in apro+edre

• 7e"o!#e a (M- parameter

• Identi%y the +omponent" in a (M- parameter

Topic &ummar'


Smmary

8/21/2019 JCLb Unit 6

29/80


© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed. $age 2@ o% &0



)he (M- $arameter

Sym*o!i+ $arameter"




e%a!t Va!e"

)opi+"

8/21/2019 JCLb Unit 6

30/80




• i"+"" the need o% "ym*o!i+ parameter"

• Identi%y the "ynta3 o% "ym*o!i+ parameter"

Topic Objectives

Unit: Symbolic Parameters Topic: Symbolic Parameters

Introd+tion

8/21/2019 JCLb Unit 6

31/80



&'mbo!ic Parameters

"ym*o!i+ parameter i" "ed in a pro+edre de%inition to repre"ent a pro+edre "tatement parameter or"*parameter. It +an a!"o *e "ed to *i!d %!e3i*i!ity into the pro+edre.

Sym*o!i+ parameter" are +oded hen pro+edre "tatement parameter" ho"e #a!e" are mo"t !i8e!y to

+hange %rom one pro+edre in#o+ation to another.

Sym*o!i+ parameter" are o%ten a""igned de%a!t #a!e". hen the pro+edre i" in#o8ed the de%a!t #a!e"+an

*e a++epted or appropriate #a!e" +an *e a""igned to them on the --C "tatement.


Con+ept"

8/21/2019 JCLb Unit 6

32/80



Sym*o!i+ parameter"

• re pre+eded *y an amper"and

• Con"i"t o% p to "e#en a!phanmeri+ to F, 0 to @ or nationa! K,,+hara+ter", *eginning ith an a!pha*eti+or nationa! +hara+ter

• Can repre"ent --C "tatement or "tatement parameter"

7orm o/ &'mbo!ic Parameters

Sym*o!i+ parameter" are pre+eded *y a"ing!e amper"and, herea" temporary data"et name" are pre+eded *y to amper"and".

Examples of Symbol!

Pa"ame#e"s

ACCT=&DEPT

PGM=&PROG1

//STEP1 EXEC PGM=PROG1,ACCT=&DEPT

//DD1 DD DSN=&WEE


Con+ept"

8/21/2019 JCLb Unit 6

33/80



#hich o/ the /o!!o0ing statements app!' to the use o/ s'mbo!ic parameters%

. )hey +an *e "pe+i%ied %or a or --C "tatement parameter

B. )hey repre"ent a pro+edre "tatement parameter or "*parameter

C. )hey are identi%ied in a pro+edre *y a pre+eding K "ign

. )hey are +oded in a pro+edre de%inition

Are #e on Trac$%


7e#ie

8/21/2019 JCLb Unit 6

34/80



7rom the /o!!o0ing items8 se!ect the s'mbo!ic parameters"

. CC)DH7$

B. SESO')D

C. S(DSE(

. VOLDS-7DS-7(O

Are #e on Trac$%


7e#ie

/OS MVS JCL I t di t

8/21/2019 JCLb Unit 6

35/80




• i"+"" the need o% "ym*o!i+ parameter"

• Identi%y the "ynta3 o% "ym*o!i+ parameter"

Topic &ummar'


Smmary


8/21/2019 JCLb Unit 6

36/80





)he (M- $arameter

Sym*o!i+ $arameter"

--C Statement $arameter"



e%a!t Va!e"

)opi+"


8/21/2019 JCLb Unit 6

37/80




• 7e+ognize "ym*o!i+ parameter"

• ""ign #a!e" to or n!!i%y --C "tatement parameter"

Topic Objectives

Unit: Symbolic Parameters Topic: EXEC Statement Parameters

Introd+tion


8/21/2019 JCLb Unit 6

38/80



n e3amp!e o% a "ym*o!i+ parameter to repre"entan --C "tatement parameter i" "hon on the

right.

ere the )7(SC) pro+edre i" de%ined ith a

"ym*o!i+ CC) parameter -$) %or $7OHA

in $S)-$A and $7OH2 in $S)-$2.

ACCT=&DEPT

ecogni9ing &'mbo!ic Parameter * An +,amp!e


//PSTEP1 EXEC PGM=PROG1,ACCT=&DEPT

//DD1 DD DSN=INTRAN,DISP=SHR


//DD3 DD SYSOUT=A


// DISP=(NEW,PASS),


//PSTEP2 EXEC PGM=PROG2,ACCT=&DEPT//DD! DD DSN=&&VALID,


//DD' DD SYSOUT=A

Con+ept"


8/21/2019 JCLb Unit 6

39/80



Assigning Va!ues to +:+C &tatement Parameters

hen e3e+ting )7(SC), a #a!e o!d *e a""igned to the "ym*o!i+ parameter on the --C "tatementthat in#o8e" )7(SC).

hen a""igning a #a!e to the "ym*o!i+ parameter the amper"and in %ront o% the "ym*o!i+ parameter i"

omitted.

)he %o!!oing "tatement a""ign" the #a!e H7$90 to the -$) "ym*o!i+ parameter

//#STEP EXEC TRANSACT,

// DEPT=GRP!


Con+ept"


8/21/2019 JCLb Unit 6

40/80



)he r!e" %or a""igning #a!e" to or n!!i%ying --C "tatement parameter" are

• Separate the #a!e a""ignment" or n!!i%i+ation" %rom operand" and %rom ea+h other "ing+omma".

• Spe+i%y the "ym*o!i+ parameter ithot the pre+eding amper"and, %o!!oed *y an e6a! "ign andthe #a!e.

• )o n!!i%y a "ym*o!i+ parameter "pe+i%y the "ym*o!i+ parameter ithot the pre+eding amper"and,%o!!oed *y an e6a! "ign. (o #a!e i" "pe+i%ied %or the "ym*o!i+ parameter hi!e n!!i%ying it.

• Sym*o!i+ parameter" +an *e n!!i%ied or a""igned #a!e" in any "e6en+e.

u!es /or Assigning Va!ues to or -u!!i/'ing +:+C &tatement Parameters


Con+ept"


8/21/2019 JCLb Unit 6

41/80



The e//ect o/ not coding a va!ue /or a s'mbo!ic parameter is to the s'mbo!icparameter .

Are #e on Trac$%


7e#ie


8/21/2019 JCLb Unit 6

42/80



The /o!!o0ing is the TA-&ACT procedure de/inition4

Code an +:+C statements to e,ecute the procedure and assign a va!ue o/ 6P3; to the

8/21/2019 JCLb Unit 6

43/80



(o that yo ha#e +omp!eted thi" topi+, yo i!! *e a*!e to

• 7e+ognize "ym*o!i+ parameter"

• ""ign #a!e" to or n!!i%y --C "tatement parameter"

Topic &ummar'


Smmary


8/21/2019 JCLb Unit 6

44/80





)he (M- $arameter

Sym*o!i+ $arameter"




e%a!t Va!e"

)opi+"


8/21/2019 JCLb Unit 6

45/80




• na!yze the +ondition" %or a""igning di%%erent #a!e" to"ym*o!i+ parameter"

• Modi%y a $HM parameter

Topic Objectives

Unit: Symbolic Parameters Topic: Assigning Different Values

Introd+tion


8/21/2019 JCLb Unit 6

46/80



i%%erent #a!e" +annot *e a""igned to the "ame"ym*o!i+ parameter hen in#o8ing the pro+edre.

=or e3amp!e, it i" not po""i*!e to a""ign H7$90to

-$) in $S)-$A and H7$A00 to -$) in

$S)-$2 n!e"" one o% the %o!!oing +ondition"e3i"t"

• di%%erent "ym*o!i+ parameterrepre"ent" ea+h o++rren+e o% theparameter

• n --C or "tatement o#erride oraddition "tatement i" "ed henin#o8ing the pro+edre

Conditions




//DD2 DD DSN=MASATER,DISP=SHR

//DD3 DD SYSOUT=A


// DISP=(NEW,PASS),




//DD' DD SYSOUT=A

Con+ept"


8/21/2019 JCLb Unit 6

47/80



)o i!!"trate the %ir"t +ondition, a""me the)7(SC) pro+edre ha" *een +reated to a!!o

%or to di%%erent #a!e" %or the --C "tatement

CC) parameter", a" %o!!o"

//PSTEP1 EXEC PGM=PROG1,ACCT=&DEPT1

"""//PSTEP2 EXEC PGM=PROG2,ACCT=&DEPT2

In the e3amp!e on the right, the )7(SC)

pro+edre ha" *een in#o8ed ith the #a!e"

H7$90 and H7$A00 %or $S)-$A and $S)-$2

re"pe+ti#e!y.

Assigning i//erent Va!ues * +,amp!e 2

Va!e" +an *e a""igned to the"ym*o!i+ parameter" in any order.


//#STEP EXEC TRANSACT,DEPT1=GRP!,

// DEPT2=GRP1

Con+ept"


8/21/2019 JCLb Unit 6

48/80



ere the pro+edre ha" *een +reated ithot"ym*o!i+ parameter"

//PSTEP1 EXEC PGM=PROG1

"""

//PSTEP2 EXEC PGM=PROG2

t the time o% in#o8ing the pro+edre, an

addition "tatement a" "hon on the right +an *e

+oded to a""ign an CC) #a!e o% H7$90 %or

$S)-$A and H7$A00 %or $S)-$2.

Assigning i//erent Va!ues * +,amp!e 3


//#STEP EXEC TRANSACT,

// ACCT"PSTEP1=GRP!,

// ACCT"PSTEP2=GRP1

Con+ept"


8/21/2019 JCLb Unit 6

49/80



As a procedure user8 0hen can 'ou assign di//erent va!ues to the same s'mbo!ic parameter%

. hen a "ym*o!i+ parameter repre"ent" the parameter

B. hen a di%%erent "ym*o!i+ parameter repre"ent" ea+h o++rren+e o% the parameter

C. hen yo +ode an addition or an o#erride "tatement hen in#o8ing a pro+edre

. (e#er

Are #e on Trac$%


7e#ie


8/21/2019 JCLb Unit 6

50/80



Assigning Va!ues to the P6. Parameter

)he $HM parameter i" the on!y --C "tatement parameter that +annot *e modi%ied ith an o#erride"tatement hen a pro+edre i" e3e+ted.

I% a "ym*o!i+ parameter i" "pe+i%ied in the pro+edre de%inition, an appropriate #a!e +an *e a""igned hen

in#o8ing the pro+edre.


Con+ept"


8/21/2019 JCLb Unit 6

51/80



In thi" e3amp!e, di%%erent #er"ion" o% the program" e3e+ted *y the )7(SC) pro+edre are *eing te"tedto

"ee hi+h #er"ion" *e"t "it departmenta! re6irement".

Sym*o!i+ parameter" are a""igned to the $HM parameter in the )7(SC) pro+edre --C "tatement, "o

the pro+edre "er +an "pe+i%y hi+h program #er"ion" are to *e e3e+ted.

The P6. Parameter * An +,amp!e


Con+ept"


8/21/2019 JCLb Unit 6

52/80



)he )7(SC) pro+edre de%inition ith"ym*o!i+ $HM parameter" %or the $S)-$A and

$S)-$2 --C "tatement" i" "hon on the right.

)he "tatement" "ed to in#o8e the pro+edre and

e3e+te program" )-S)A and )-S)2 o!d *e

//#STEP EXEC TRANSACT,PROG1=TEST1,

// PROG2=TEST2

)he "tatement" "ed to in#o8e the pro+edre and

e3e+te program" )-S)1 and )-S)4 o!d *e

//#STEP EXEC TRANSACT,PROG1=TEST3,

// PROG2=TEST4

&'mbo!ic P6. Parameters


//PSTEP1 EXEC PGM=&PROG1



//DD3 DD SYSOUT=A


// DISP=(NEW,PASS),


//PSTEP2 EXEC PGM=&PROG2//DD! DD DSN=&&VALID,


//DD' DD SYSOUT=A

Con+ept"


8/21/2019 JCLb Unit 6

53/80


The /o!!o0ing is the TA-&ACT procedure de/inition4

Code an +:+C statement to e,ecute

a") T+&T= /or P&T+P2 andb")T+&T; /or P&T+P3"

//#STEP EXEC $$$$$$$$$$$$$$$$$$$$$$$

Are #e on Trac$%

//PSTEP1 EXEC PGM=&PROG1


//DD2 DD DSN=MASTER,DISP=SHR//DD3 DD SYSOUT=A

//DD4 DD DSN=&&VALID,DISP=(NEW,PASS),// UNIT=SYSDA,

// SPACE=(TR,(1,1))//PSTEP2 EXEC PGM=&PROG2

//DD! DD DSN=&&VALID,DISP=(OLD,DELETE)

//DD' DD SYSOUT=A


7e#ie


8/21/2019 JCLb Unit 6

54/80


$HM G n --C "tatement parameter that name" the program to *e e3e+ted.

6!ossar'

H!o""ary



8/21/2019 JCLb Unit 6

55/80



• na!yze the +ondition" %or a""igning di%%erent #a!e" to"ym*o!i+ parameter"

• Modi%y a $HM parameter

Topic &ummar'


Smmary


8/21/2019 JCLb Unit 6

56/80




)he (M- $arameter

Sym*o!i+ $arameter"




e%a!t Va!e"

)opi+"


8/21/2019 JCLb Unit 6

57/80



• i"+"" ho to +hange a "tatement parameter

• 'nder"tand the r!e" %or a""igning a "tatementparameter #a!e

Topic Objectives

Unit: Symbolic ParametersTopic: DD Statement Parameters

Introd+tion


8/21/2019 JCLb Unit 6

58/80


Sym*o!i+ parameter" are o%ten "pe+i%ied %or "tatement parameter", i% the #a!e" %or tho"e

parameter" are !i8e!y to +hange.

Changing &tatement Parameters


A 00 A

A 00 A

WEE$%

WEE$&

DSN'WEE$

Con+ept"

TRANSACT


8/21/2019 JCLb Unit 6

59/80


=or e3amp!e, "ppo"e the identi%i+ation o% thedata "et +ontaining +"tomer tran"a+tion" %or

)7(SC) #arie" %rom ee8 to ee8.

&tatement Parameters * An +,amp!e


A 00 A

A 00 A

WEE$%

WEE$&

TRANSACT

% s # W e

e )

& * + W e e )

Con+ept"

DSN'WEE$


8/21/2019 JCLb Unit 6

60/80

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

)he )7(SC) pro+edre de%inition ith a"ym*o!i+ S( parameter #a!e %or the A

"tatement i" "hon on the right.

&tatement Parameters * An +,amp!e



//DD1 DD DSN=&WEE,DISP=SHR


//DD3 DD SYSOUT=A


// DISP=(NEW,PASS),




//DD' DD SYSOUT=A

Contined?

Con+ept"


8/21/2019 JCLb Unit 6

61/80

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

&tatement Parameters * An +,amp!e (cont’d)

)he %o!!oing --C "tatement i" "ed to in#o8e the pro+edre "ing --NA a" the inpt data "et

//#STEP EXEC TRANSACT,WEE=WEE1

By "imp!y a""igning the appropriate data "et name to --N hen the pro+edre i" in#o8ed, the

data "et" to *e "ed %or the other ee8" +an *e "pe+i%ied.


Con+ept"


8/21/2019 JCLb Unit 6

62/80


I% the "ame "ym*o!i+ parameter i" "ed torepre"ent an parameter "+h a" the '(I)

parameter in "e#era! "tatement", then the

#a!e need" to *e a""igned to the "ym*o!i+

parameter on!y on+e.

)he #a!e i" app!ied to a!! o++rren+e" o% theparameter. )he need to +ode "e#era! o#erride

"tatement" +an *e e!iminated.

Assigning Va!ues


+:+

WEE$%

WEE$&

DSN'WEE$

Con+ept"


8/21/2019 JCLb Unit 6

63/80


)he r!e" %or a""igning #a!e" to or n!!i%ying "tatement parameter" are

• Separate the #a!e a""ignment" or n!!i%i+ation" %rom parameter" and %rom ea+h other "ing+oma".

• Spe+i%y the "ym*o!i+ parameter ithot the pre+eding amper"and, %o!!oed *y an e6a! "ign and#a!e.

• )o n!!i%y a "ym*o!i+ parameter "pe+i%y the "ym*o!i+ parameter ithot the pre+eding amper"and,%o!!oed *y an e6a! "ign. )he #a!e %or the "ym*o!i+ parameter "ho!d not *e +oded.

• Sym*o!i+ parameter" +an *e n!!i%ied or a""igned #a!e" in any "e6en+e.

u!es /or Assigning Va!ues to &tatement Parameters


Con+ept"


8/21/2019 JCLb Unit 6

64/80

© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed. $age :4 o% &07e#ie

The /o!!o0ing >C? statements are /rom a procedure named A-1POC"

//S1 EXEC PGM=PROG1,ACCT=&GRP

//DD1 DD DSN=&INPUT,DISP=SHR

//"""

//S2 EXEC PGM=&A,ACCT=&GRP

#hich o/ the /o!!o0ing statements are correct to invo$e the procedure and speci/' the /o!!o0ingnu!!i/' the

8/21/2019 JCLb Unit 6

65/80


Assigning Va!ues to &tatement Parameters

hi!e a""igning #a!e" to "ym*o!i+ parameter"

• n appropriate #a!e that repre"ent" a data "et name m"t *e a""igned to the "ym*o!i+ parameter

• I% the "ym*o!i+ parameter i" not a""igned a #a!e, the "y"tem +on"ider" the "ym*o!i+ parameter to*e the name o% a temporary data "et *e+a"e it *egin" ith the amper"and +hara+ter


Con+ept"


8/21/2019 JCLb Unit 6

66/80

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

I/ no va!ue is assigned to a s'mbo!ic parameter in a procedure statement at the time o/invo$ing a procedure8 it is treated as a data set"

Are #e on Trac$%


7e#ie


8/21/2019 JCLb Unit 6

67/80

© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed. $age :; o% &0Introd+tion


• i"+"" ho to +hange a "tatement parameter

• 'nder"tand the r!e" %or a""igning a "tatementparameter #a!e

Topic &ummar'


Smmary


8/21/2019 JCLb Unit 6

69/80

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


• 'nder"tand ho to a""ign de%a!t #a!e" to parameter"

• ++ept de%a!t #a!e" %or parameter"

• (!!i%y de%a!t #a!e" %or parameter"

Topic Objectives

Unit: Symbolic Parameters Topic: Default Values

Introd+tion


8/21/2019 JCLb Unit 6

70/80

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

t the time "ym*o!i+ parameter" are +reated, +reator o% the pro+edre +an a!"o a""ign de%a!t #a!e" to theparameter".

#hat are the characteristics o/ de/au!t va!ues%

)he +hara+teri"ti+" o% de%a!t #a!e" are

• )hey are "pe+i%ied in the parameter %ie!d o% the $7OC "tatement

• )hey do not ha#e a pre+eding amper"and

• In the +a"e o% m!tip!e "ym*o!i+ parameter", they are "eparated *y a +omma

• )hey +an *e a""igned in any "e6en+e

ecogni9ing e/au!t Va!ues


Con+ept"


8/21/2019 JCLb Unit 6

71/80

© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed. $age ;A o% &0

In the )7(SC) pro+edre de%inition "hon onthe right, the $7OC "tatement a""ign" the de%a!t

#a!e H100 to -$) and the de%a!t #a!e

$7OH2 to $7OH.

e/au!t Va!ues * An +,amp!e

//TRANSACT PROC DEPT=G3,PROG=PROG2


// ACCT=&DEPT



//DD3 DD SYSOUT=A

//DD4 DD DSN=&&VALID,// DISP=(NEW,PASS),

// UNIT=SYSDA,

// SPACE=(TR,(1,1))

//PSTEP2 EXEC PGM=PROG,ACCT=&DEPT

//DD! DD DSN=&&VALID,


//DD' DD SYSOUT=A


Con+ept"


8/21/2019 JCLb Unit 6

72/80


#hich o/ the /o!!o0ing statements are true /or de/au!t va!ues%

. )hey are a""igned on the $7OC "tatement o% a pro+edre.

B. )hey are pre+eded *y an amper"and.

C. )hey m"t *e a""igned in a "pe+i%i+ "e6en+e.

. )hey +an *e o#erridden hen the pro+edre i" e3e+ted.

Are #e on Trac$%


7e#ie


8/21/2019 JCLb Unit 6

73/80


)he --C "tatement re6ired to a++ept thede%a!t #a!e" and "pe+i%y the data "et named

--NA i" "hon on the right.

Accepting e/au!t Va!ues

//#STEP EXEC TRANSACT,WEE=WEE1


Con+ept"


8/21/2019 JCLb Unit 6

74/80


Code an +:+C statements to invo$e the TA-&ACT procedure and accept de/au!t va!ues"

// EXEC $$$$$$$$$$$$$$$$$$$$$$$

Are #e on Trac$%


7e#ie


8/21/2019 JCLb Unit 6

75/80


-u!!i/'ing e/au!t Va!ues

#hen shou!d 'ou assign a va!ue%

#a!e %or a "ym*o!i+ parameter "ho!d *e a""igned or n!!i%ied on!y i%

• )he de%a!t #a!e" "pe+i%ied in the $7OC "tatement i" not appropriate %or that parti+!ar e3e+tiono% the pro+edre

• (o de%a!t #a!e i" "pe+i%ied %or the "ym*o!i+ parameter on the $7OC "tatement in the pro+edre

Contined?


Con+ept"


8/21/2019 JCLb Unit 6

76/80

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

)he r!e" %or o#erriding or n!!i%ying the de%a!t #a!e" are

• )o o#erride a de%a!t #a!e, "pe+i%y the "ym*o!i+ parameter ithot the pre+eding amper"and,%o!!oed *y an e6a! "ign and the appropriate #a!e

• )o n!!i%y a de%a!t #a!e, "pe+i%y the "ym*o!i+ parameter ithot the pre+eding amper"and,%o!!oed *y on!y an e6a! "ign

• )he o#erride" and n!!i%i+ation" %or de%a!t #a!e" +an *e "pe+i%ied in any "e6en+e

-u!!i/'ing e/au!t Va!ues (cont’d)


Con+ept"


8/21/2019 JCLb Unit 6

77/80

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

In thi" e3amp!e, the )7(SC) pro+edre i" to *ein#o8ed ith "ome inpt te"t data A

"tatement that re"ide" in a data "et named

)S)) and a te"t program named )-S)$7H

%or "tep $S)-$2.

Be+a"e thi" e3e+tion i" a te"t, a department

nm*er need not *e "pe+i%ied.

)h", the de%a!t #a!e" H100 "pe+i%ied %or

-$) and $7OH2 "pe+i%ied %or $7OH are

not needed.

-u!!i/'ing e/au!t Va!ues * Procedure e/inition

//TRANSACT PROC DEPT=G3,PROG=PROG2


// ACCT=&DEPT


//DD2 DD DSN=MASATER,DISP=SHR

//DD3 DD SYSOUT=A

//DD4 DD DSN=&&VALID,// DISP=(NEW,PASS),// UNIT=SYSDA,

// SPACE=(TR,(1,1))

//PSTEP2 EXEC PGM=PROG,ACCT=&DEPT

//DD! DD DSN=&&VALID,


//DD' DD SYSOUT=A


Con+ept"


8/21/2019 JCLb Unit 6

78/80

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

)he --C "tatement %or the in#o+ation i" "honon the right. )he --C "tatement doe" the

%o!!oing

• (!!i%ie" the de%a!t #a!e" "pe+i%ied %or-$)

• O#erride" the de%a!t #a!e "pe+i%ied %or$7OH and a""ign" the #a!e)-S)$7H in"tead

• ""ign" the #a!e )S)) to --N

-u!!i/'ing e/au!t Va!ues * +:+C &tatement

)he n!!i%i+ation, o#erride and a""ignment o%ne #a!e" +an *e +oded in any order on the--C "tatement "ed to in#o8e the pro+edre.

//#STEP EXEC TRANSACT,DEPT=,

// PROG=TESTPRG,

// WEE=TSTDATA


Con+ept"


8/21/2019 JCLb Unit 6

79/80

© Copyright IBM Corp., 2000, 2004. !! right" re"er#ed. $age ;@ o% &0Introd+tion


• 'nder"tand ho to a""ign de%a!t #a!e" to parameter"

• ++ept de%a!t #a!e" %or parameter"

• (!!i%y de%a!t #a!e" %or parameter"

Topic &ummar'


Smmary


8/21/2019 JCLb Unit 6

80/80

(o that yo ha#e +omp!eted thi" nit, yo "ho!d *e a*!e to

• 'nder"tand the prpo"e and %orm o% the (M-parameter in a pro+edre de%inition

• 7e"o!#e the (M- parameter hen e3e+ting apro+edre *y identi%ying the a+ta! data "et name" and

attri*te" repre"ented *y the (M- parameter

• 'nder"tand the prpo"e and %orm o% "ym*o!i+parameter" in a pro+edre de%inition

• ""ign #a!e" to "ym*o!i+ parameter" at the time o%in#o8ing a pro+edre

Unit &ummar'


jclb unit 6

Documents