2. Stephen Linkin Houston Community College 5-Feb-07 © 2002 - Mike Murach & Associates, 2006 - HCC, IBM 1 Using JCL Facilities To Allocate Other DASD Data Sets Chapter # 6

3. 2 Objectives Applied objectives Code the JCL necessary to: a.allocate a single-step temporary data set b.allocate a passed temporary data set Code JCL to allocate a dummy data set. Code JCL to allocate concatenated data sets. Code JCL to allocate multiple DASD volumes to a single data set. Code the SPACE parameter to: a.release unused space b.convert a block allocation to cylinders c.request a contiguous space allocation Use the referback facility to obtain DSNAME, VOLUME, or DCB information from a previous DD statement. Code an IEFBR14 job step to allocate and deallocate data sets.

4. 3 Objectives Knowledge objectives Explain how to code the name for a temporary data set. List one advantage of using VIO temporary data sets. Describe what a dummy data set is. Describe what concatenated files are. Describe what a multi-volume data set is. Describe the effect of a referback in a DD statement. Describe why you would code a job that executes the IEFBR14 program.

5. 4 A Temporary Work File Allocating A Single-step Temporary Data Set Example 1 //WORK1 DD UNIT=SYSDA,SPACE=(CYL,(10,5)) Example 2 //WORK2 DD UNIT=SYSDA,DISP=(NEW,DELETE), // SPACE=(3200,(500,500)), // DCB=LRECL=120 Rules For Coding Temporary Data Set Names 1 To 8 Alphanumeric Or National Characters, Starting With An Alphabetic Or National Character. Preceded By Two Ampersands (&&). Compound Names Are Not Allowed. Valid Temporary Data Set Names Invalid Temporary Data Set Names &&CUSTOMER&&TEMPRM&&A&&DD$1 &&CUSTOMERSOver 8 &TRANSSRTMissing & &&MM01.ARSHas Period &&1ABCStart Wrong

6. © 2002 - Mike Murach & Associates, 2006 - HCC, IBM5 Two Step JOB Using Temporary Data Sets //MM01RN JOB (36512),'R MENENDEZ',MSGCLASS=X,MSGLEVEL=(1,1), // CLASS=A,NOTIFY=&SYSUID //SORT EXEC PGM=SORT //SYSOUT DD SYSOUT=* //SORTIN DD DSNAME=MMA2.AR.CUSTOMER.MASTER,DISP=SHR //SORTWK01 DD UNIT=SYSDA,SPACE=(TRK,(1,1)) //SORTWK02 DD UNIT=SYSDA,SPACE=(TRK,(1,1)) //SORTWK03 DD UNIT=SYSDA,SPACE=(TRK,(1,1)) //SORTOUT DD DSNAME=&&SORTCUST,DISP=(NEW,PASS), // UNIT=SYSDA,SPACE=(TRK,(1,1)) //SYSIN DD * SORT FIELDS=(2,13,A,20,1,A),FORMAT=CH /* //REPORT EXEC PGM=CUSTLST //SYSOUT DD SYSOUT=* //CUSTMAST DD DSNAME=&&SORTCUST,DISP=(OLD,DELETE) //ATB DD SYSOUT=* //SYSUDUMP DD SYSOUT=* SORT FIELDS=(2,13,A,20,1,A),FORMAT=CH /* //REPORT EXEC PGM=CUSTLST //SYSOUT DD SYSOUT=* //CUSTMAST DD DSNAME=&&SORTCUST,DISP=(OLD,DELETE) //ATB DD SYSOUT=* //SYSUDUMP DD SYSOUT=*

7. © 2002 - Mike Murach & Associates, 2006 - HCC, IBM6 VIO Data Sets Virtual Input/Output Required Parameters UNIT=SYSDA/VIO, Examples of VIO Temporary Data Sets Example 1 //TEMP1 DD UNIT=VIO Example 2 //DD1 DD UNIT=SYSDA,SPACE=(1000,(10,50)), // DCB=(RECFM=FB,LRECL=40) Example 3 //SORTOUT DD DSNAME=&&PRODCD, // DISP=(NEW,PASS), // UNIT=SYSDA,SPACE=(1000,(20,70))

8. 7 A Dummy Data Set Doesn’t Exist. Two Ways To Specify A Dummy Data Set Code The Dummy Parameter DUMMY Is Positional Only And Must Be First. Specify DSNAME=nullfile. Syntax for dummy data sets //ddname DD DUMMY [,parameter]... or //ddname DD DSNAME=NULLFILE [,parameter]... Dummy Data Sets Allocating a dummy data set Example 1 //SYSIN DD DUMMY Example 2 //CUSTMAST DD DUMMY,AMP=AMORG Example 3 //TRANFILE DD DUMMY,DSNAME=AR.TRANS.FILE,DISP=(NEW,KEEP), // UNIT=SYSDA,VOL=SER=MPS800, // SPACE=(CYL,(5,1)), // DCB=(DSORG=PS,RECFM=FB,LRECL=80) Example 4 //TRANFILE DD DSNAME=NULLFILE,DISP=(NEW,KEEP), // UNIT=SYSDA,VOL=SER=MPS800, // SPACE=(CYL,(5,1)), // DCB=(DSORG=PS,RECFM=FB,LRECL=80)

9. © 2002 - Mike Murach & Associates, 2006 - HCC, IBM8 Concatenation Concatenating data sets Example 1 //TRANS DD DSNAME=MMA1.TRANS.WEEK1,DISP=SHR // DD DSNAME=MMA1.TRANS.WEEK2,DISP=SHR // DD DSNAME=MMA1.TRANS.WEEK3,DISP=SHR Example 2 //SYSLIB DD DSNAME=MMA1.COBOL.OBJLIB,DISP=SHR // DD DSNAME=SYS1.COBLIB,DISP=SHR Example 3 //SYSUT1 DD DSNAME=MM01.TEXT,DISP=OLD, // UNIT=TAPE,VOL=SER=M00023 // DD DSNAME=MM01.ACCTG.DATA(ARMAST), // DISP=SHR // DD * (input data records) /*

10. 9 Multiple Volume Allocations DD statement parameters used in multi-volume data set allocation,UNIT=(device,unit-count),VOL=SER=(serial-number,serial-number...) Allocating a multi-volume data set Example 1 //CUSTMAST DD DSNAME=MMA1.CUSTOMER.MASTER, // DISP=(NEW,KEEP), // UNIT=SYSDA,VOL=SER=(MVS300,MVS301,MVS302), // SPACE=(CYL,(400,200)) Example 2 //CUSTMAST DD DSNAME=MMA1.CUSTOMER.MASTER, // DISP=(NEW,CATLG), // UNIT=(SYSDA,3),SPACE=(CYL,(400,200))

11. © 2002 - Mike Murach & Associates, 2006 - HCC, IBM10 Figure 6-07a SPACE Parameters The parameter for space assignment SPACE=(unit,(primary[,secondary][,dir])[,RLSE][, {CONTIG} ][,ROUND]) {MXIG} {ALX} The parameter for specific track requests SPACE=(ABSTR,(primary,address [ {,dir} ]) [ {,index}]

12. © 2002 - Mike Murach & Associates, 2006 - HCC, IBM11 More SPACE Parameters DD statements using the RLSE subparameter Example 1 //EMPMAST DD DSNAME=MMA1.EMPLOYEE.MASTER, // DISP=(,CATLG,DELETE), // UNIT=SYSDA,SPACE=(TRK,(400,100),RLSE) Example 2 / //INVMAST DD DSNAME=MMA1.INVENTORY.MASTER, // DISP=(,CATLG,DELETE), // UNIT=SYSDA,VOL=SER=(MVS300,MVS301,MVS302), // SPACE=(CYL,(100,20),RLSE) A DD statement using the ROUND subparameter /INSMAST DD DSNAME=MMA1.INSURANCE.MASTER, // DISP=(,CATLG,DELETE), // UNIT=SYSDA,SPACE=(3200,(5000,1000),,,ROUND)

13. © 2002 - Mike Murach & Associates, 2006 - HCC, IBM12 SPACE Sub-Parameters Coding CONTIG, MXIG, and ALX subparameters Example 1 //EMPMAST DD DSNAME=MMA1.EMPLOYEE.MASTER, // DISP=(,CATLG,DELETE), // UNIT=SYSDA,SPACE=(CYL,(100,20),,CONTIG) Example 2 //EMPMAST DD DSNAME=MMA1.EMPLOYEE.MASTER, // DISP=(,CATLG,DELETE), // UNIT=SYSDA,VOL=SER=MVS300, // SPACE=(CYL,(100,20),RLSE,MXIG) Example 3 //EMPMAST DD DSNAME=MMA1.EMPLOYEE.MASTER, // DISP=(,CATLG,DELETE), // UNIT=SYSDA,VOL=SER=MVS300, // SPACE=(CYL,(100,20),RLSE,ALX)

14. © 2002 - Mike Murach & Associates, 2006 - HCC, IBM13 Referbacks The general syntax for a referback The general syntax for a referbackparameter=*.[stepname.]ddname Parameters that can use the referback facility Parameters that can use the referback facility DD CNTL DD CNTL DD DCB DD DCB DD DSNAME DD DSNAME DD REFDD (SMS only) DD REFDD (SMS only) DD VOL=REF DD VOL=REF EXEC PGM EXEC PGM

15. © 2002 - Mike Murach & Associates, 2006 - HCC, IBM14 A Job That Uses Referbacks //MM01AR JOB (36512),LYNCH,MSGCLASS=X,MSGLEVEL=(1,1), // CLASS=A,NOTIFY=&SYSUID //STEP1 EXEC PGM=TRANS //TRANFILE DD DSNAME=AR.TRANS.FILE,DISP=(NEW,KEEP), // UNIT=SYSDA,VOL=SER=MPS800, // SPACE=(CYL,(5,1)), // DCB=(DSORG=PS,RECFM=FB,LRECL=80) //TRANERR DD DSNAME=AR.TRANS.ERR,DISP=(NEW,KEEP), // UNIT=SYSDA,VOL=SER=MPS801, // SPACE=(CYL,(2,1)), // DCB=*.TRANFILE //STEP2 EXEC PGM=TRANSEP //TRANIN DD DSNAME=*.STEP1.TRANFILE,DISP=SHR //TRANOUT DD DSNAME=AR.TRANS.A.FILE,DISP=(NEW,KEEP), // UNIT=SYSDA,VOL=REF=*.STEP1.TRANFILE, // SPACE=(CYL,(5,1)), // DCB=*.STEP1.TRANFILE. //STEP5 EXEC PGM=*.STEP3.LOADMOD.

16. © 2002 - Mike Murach & Associates, 2006 - HCC, IBM15 End Presentation