Means of special character in JCL



JES, JES2, JCL utilities, IDCAMS, Compile & Run JCLs, PROCs etc...

Means of special character in JCL

Postby Mehdi shri » Sat Jun 30, 2012 7:45 pm

Hi freiends
I have a jcl like this:

//ACTDBRC JOB MSGLEVEL=1
//STARTING EXEC ACTDBRC,IMSID=IMSA
XX PROC RGN=64M,DPTY='(14,15)',SOUT=A,
XX IMSID=ACT,SYS=IMSV11,SYS2=ACT
XXIEFPROC EXEC PGM=DFSMVRC0,REGION=&RGN,
XX DPRTY=&DPTY,PARM='DRC,&IMSID'
XXSTEPLIB DD DSN=&SYS..SDFSRESL,DISP=SHR
XXPROCLIB DD DSN=&SYS..PROCLIB,DISP=SHR
XXJCLOUT DD SYSOUT=(A,INTRDR)
XXJCLPDS DD DSN=&SYS..PROCLIB,DISP=SHR
XXSYSUDUMP DD SYSOUT=&SOUT
XXSYSABEND DD SYSOUT=&SOUT
XXRECON1 DD DSN=&SYS..&SYS2..RECON1,DISP=SHR
XXRECON2 DD DSN=&SYS..&SYS2..RECON2,DISP=SHR
XXRECON3 DD DSN=&SYS..&SYS2..RECON3,DISP=SHR

It is a JESJCL ddname of JES2 step of a DBRC starting JCL you can see below:
//ACTDBRC JOB MSGLEVEL=1
//STARTING EXEC ACTDBRC,IMSID=IMSA

My question: What is the means of "&" and "." characters in lines containg "&SYS..SDFSRESL" and "=&SYS..&SYS2..RECON1" phrase .
I know it is a dataset address but I want to understand how and WHICH datasets this phrases points to.
Mehdi shri
 
Posts: 138
Joined: Sun Jan 16, 2011 6:30 pm
Has thanked: 57 times
Been thanked: 0 time

Re: Means of special character in JCL

Postby Robert Sample » Sat Jun 30, 2012 8:02 pm

You need to find the JCL Reference manual (try http://www.ibm.com if you have no other place to look -- your site probably has the manual either in hardcopy or online somewhere -- and read up on ampersands and periods.

Furthermore, the expanded JCL listing includes the fully resolved data set name, as long as your MSGLEVEL parameter on your JOB statement is set appropriately.
Robert Sample
Global moderator
 
Posts: 3719
Joined: Sat Dec 19, 2009 8:32 pm
Location: Dubuque, Iowa, USA
Has thanked: 1 time
Been thanked: 279 times

Re: Means of special character in JCL

Postby Akatsukami » Sat Jun 30, 2012 8:02 pm

The use of "&" in this fashion indicates a symbolic parameter. Such a parameter can be given a value in a number of ways, which will then be substituted for it when the JCL is interpreted.

The lines beginning with "XX" are an expansion of the JCL procedure (often referred to simply as a "proc"). Note that the first two lines are
XX PROC RGN=64M,DPTY='(14,15)',SOUT=A,
XX IMSID=ACT,SYS=IMSV11,SYS2=ACT

Other than the keyword PROC these are all symbolic parameters having values assigned to them.

Later in the JCL is the line
XXRECON1 DD DSN=&SYS..&SYS2..RECON1,DISP=SHR

This will have the values given for SYS and SYS2 substituted at interpretation time, giving
//RECON1 DD DSN=IMSV11.ACT.RECON1,DISP=SHR

The dot or period acts as a delimiter to the parameter, so that &SYS2 can be distinguished from &SYS2RECON. As the period is also used in data set names, two consecutive periods are coded, one of which is consumed by the interpreter DSP.

Read more about symbolic parameters here.
"You have sat too long for any good you have been doing lately ... Depart, I say; and let us have done with you. In the name of God, go!" -- what I say to a junior programmer at least once a day

These users thanked the author Akatsukami for the post:
Mehdi shri (Sun Jul 01, 2012 12:57 pm)
User avatar
Akatsukami
Global moderator
 
Posts: 1058
Joined: Sat Oct 16, 2010 2:31 am
Location: Bloomington, IL
Has thanked: 6 times
Been thanked: 51 times

Re: Means of special character in JCL

Postby steve-myers » Sun Jul 01, 2012 3:04 am

The term "interpreter DSP" near the end of Akatsukami's long post is meaningless to most of the readers and lurkers here. It is a JES3 term. JES2 has the same thing, but it is called by a different name. In the MVS world, the "interpreter" is the piece of MVS that analyzes JCL.

These users thanked the author steve-myers for the post:
Mehdi shri (Sun Jul 01, 2012 12:57 pm)
steve-myers
Global moderator
 
Posts: 2105
Joined: Thu Jun 03, 2010 6:21 pm
Has thanked: 4 times
Been thanked: 243 times

Re: Means of special character in JCL

Postby Monitor » Sun Jul 01, 2012 1:30 pm

Why not have a look at:
http://www-03.ibm.com/systems/z/educati ... l#BootCamp
http://publib.boulder.ibm.com/infocente ... /index.jsp

Here you an find some free training materials for z/OS and of course JCL and procedures, as an addition to the manual(s) mentioned.

These users thanked the author Monitor for the post:
Mehdi shri (Sun Jul 01, 2012 8:16 pm)
Monitor
 
Posts: 98
Joined: Wed Jan 18, 2012 8:59 pm
Has thanked: 0 time
Been thanked: 7 times


Return to JCL

 


  • Related topics
    Replies
    Views
    Last post