Stephen Linkin Houston Community College 14-Feb-07 © Mike Murach & Associates, HCC, IBM 1 Managing SYSOUT Data Sets

2 Objectives Applied objectives Code job streams using default and explicitly referenced OUTPUT statements. Code OUTPUT and DD statement parameters to perform the following functions for SYSOUT data sets: a.specify an output class and priority b.release the data set for immediate processing c.route the data set to a specific destination d.hold the data set on the output queue e.produce multiple copies of the data set f.set an output limit g.print the data set on special forms

3 Objectives Knowledge objectives Distinguish default and explicitly referenced OUTPUT statements. Distinguish job-level and step-level default OUTPUT statements. Describe how options coded on a DD SYSOUT statement override equivalent defaults in OUTPUT statements. Identify the JES2 or JES3 control statements that duplicate the functions of OUTPUT and DD statements.

4 //name OUTPUT [,CLASS=class ] [,CONTROL= {PROGRAM} ] {SINGLE } {DOUBLE } {TRIPLE } [,COPIES= {nnn } ] {(,(group-value[,group-value...]))} [,DEFAULT= {YES} ] {NO } [,DEST=destination ] [,FCB=fcb-name ] [,FLASH=overlay-name ] [,FORMS=form-name ] [,JESDS= {ALL} ] {JCL} {LOG} {MSG} [,LINECT=nnn ] [,OUTDISP=(normal-disp[,abnormal-disp]) ] [,PRTY=nnn ]1 Syntax For The OUTPUT Statement

© Mike Murach & Associates, HCC, IBM5 Syntax for DEFAULT parameter DEFAULT= {YES} {Y } {NO } {N } SYSOUT=(,) //MM01RN JOB (36512),'R MENENDEZ',NOTIFY=MM01,MSGCLASS=X //OUT1 OUTPUT DEFAULT=YES,CLASS=H //STEP1 EXEC PGM=ARRPT1 //TRANIN DD DSNAME=MMA2.AR.TRANS,DISP=SHR //TRANRPT DD SYSOUT=(,) //STEP2 EXEC PGM=ARRPT2 //OUT2 OUTPUT DEFAULT=YES,CLASS=A,COPIES=3,DEST=R125 //MASTIN DD DSNAME=MMA2.CUSTOMER.MASTER,DISP=SHR //CUSTRPT DD SYSOUT=(,) Using job-level and step-level OUTPUT statements

© Mike Murach & Associates, HCC, IBM6 Syntax For The OUTPUT Parameter Of The DD Statement OUTPUT= {reference } {(,reference[,reference]...)} A job using default and explicit OUTPUT statements //MM01RN JOB (36512),'R MENENDEZ',NOTIFY=MM01 //DEFAULT OUTPUT DEFAULT=YES,CLASS=A,DEST=LOCAL //OUT1 OUTPUT COPIES=4,CLASS=C,DEST=R125 //STEP1 EXEC PGM=AR4320 //OUT2 OUTPUT COPIES=2,CLASS=C,DEST=R150 //INVLIST DD SYSOUT=(,),OUTPUT=*.OUT1 //INVRPT DD SYSOUT=(,),OUTPUT=(*.OUT1,*.STEP1.OUT2) //LOGRPT DD SYSOUT=(,) //

© Mike Murach & Associates, HCC, IBM7 Common DD Parameters For SYSOUT Processing //ddname DD [ SYSOUT=(class[,writer][, {form-name} ]) ] {code-name} [,COPIES=nnn(,(group-value[,group-value])) ] [,DEST=destination ] [,FCB=fcb-name ] [,FLASH=overlay-name ] [,FREE= {END } {CLOSE} [,HOLD= {YES} ] {NO } [,OUTLIM=number ] [,OUTPUT= {reference } ] {(,reference[,reference]...)} [,SEGMENT=page-count ] [,SPIN= {UNALLOC} ] {NO }

© Mike Murach & Associates, HCC, IBM8 CLASS Parameter Options Syntax for the SYSOUT class of the DD statement Syntax for the CLASS parameter of the OUTPUT statement SYSOUT= {class} {*} {(,)} CLASS= {class} {* }

© Mike Murach & Associates, HCC, IBM9 Syntax Of PRTY Parameter For OUTPUT Statement Using Output Classes To Set Printing Priorities PRTY=nnn //MM01RN JOB (36512),'R MENENDEZ',NOTIFY=MM01,MSGCLASS=X //DEFAULT OUTPUT DEFAULT=YES,CLASS=A,PRTY=50 //OUT1 OUTPUT CLASS=C,PRTY=200 //STEP1 EXEC PGM=AR5000 //ARPLOG DD SYSOUT=* //ARPLIST DD SYSOUT=(,) //ARRP10 DD SYSOUT=D //ARRP15 DD SYSOUT=(,) //ARSTMT DD SYSOUT=(,),OUTPUT=*.OUT1 //

© Mike Murach & Associates, HCC, IBM10 Syntax Of SPIN Parameter For DD Statement SPIN= {UNALLOC} {NO } //REPORT DD SYSOUT=A,SPIN=UNALLOC

© Mike Murach & Associates, HCC, IBM11 Syntax Of FREE Parameter For DD Statement FREE= {END } {CLOSE} //REPORT DD SYSOUT=A,SPIN=UNALLOC,FREE=CLOSE

© Mike Murach & Associates, HCC, IBM12 Syntax Of SEGMENT Parameter For DD Statement (JES2 Only) SEGMENT=page-count //REPORT DD SYSOUT=A,SEGMENT=100 After JOB step ends, before Job Stream Finishes //REPORT DD SYSOUT=A,SPIN=UNALLOC As soon as Data Set closes //REPORT DD SYSOUT=A,SPIN=UNALLOC,FREE=CLOSE After 100 pages are Generated //REPORT DD SYSOUT=A,SEGMENT=100

© Mike Murach & Associates, HCC, IBM13 Syntax Of DEST Parameter For OUTPUT and DD statements DEST=destination A SYSOUT data set routed to remote printer R100 //REPORT DD SYSOUT=A,DEST=R100 An OUTPUT statement routing output to a node FRESNO and a printer with an IP address of main-2 //DEFAULT OUTPUT DEFAULT=YES,DEST='FRESNO.IP:main-2'

© Mike Murach & Associates, HCC, IBM14 Possible Printer Destinations DestinationOUTPUTDDJES2JES3Description ANYLOCALXXX Routes output to a local device LOCALXXXX NameXXX Routes output to a destination identified by a symbolic name up to 8 characters long. NnnnnXX Routes output to a node. The number can be from 1 to Rnnnn, RMnnnn, RMTnnnn XXX Routes output to a remote terminal. The number can be from 1 to UseridXXX Routes output to a user-id at the local node. nodename.useridXX Routes output to a node and a user-id within the node. (node,userid)XXX 'IP:ipaddr', 'nodename.IP:ipaddr' XXX Routes output to a TCP/IP routing designation.

© Mike Murach & Associates, HCC, IBM15 //GOOD OUTPUT OUTDISP=(KEEP,PURGE),DEST=R100 //BAD OUTPUT OUTDISP=(PURGE,HOLD) //REPORT DD SYSOUT=A,OUTPUT=(*.GOOD,*.BAD) OUTDISP=(normal-disp[,abnormal-disp]) Figure 8-08a Syntax Of OUTDISP Parameter for OUTPUT Statement (JES2) Syntax For HOLD= Parameter Of DD Statement HOLD= {YES} {Y } {NO } {N }

© Mike Murach & Associates, HCC, IBM16 Syntax Of COPIES Parameter From OUTPUT and DD statements The COPIES parameter on the DD statement The COPIES parameter on the DD statement 2 collated copies are printed on any type of printer 2 collated copies are printed on any type of printer //REPORT1 DD SYSOUT=A,COPIES=2 6 uncollated copies are printed in 3 sets on Laser printer 6 uncollated copies are printed in 3 sets on Laser printer //REPORT2 DD SYSOUT=A,COPIES=(,(2,3,1)) The COPIES parameter on an OUTPUT statement The COPIES parameter on an OUTPUT statement 2 collated copies on any type of printer 2 collated copies on any type of printer //OUT1 OUTPUT CLASS=A,COPIES=2 On an impact printer:5 collated copies are printed on a laser printer, 5 uncollated copies are printed in 2 sets On an impact printer:5 collated copies are printed on a laser printer, 5 uncollated copies are printed in 2 sets //OUT2 OUTPUT CLASS=A,COPIES=(5,(2,3)) COPIES= {nnn } {(nnn,(group-value[,group-value...]))} {(,(group-value[,group-value...])) } COPIES= {nnn } {(nnn,(group-value[,group-value...]))} {(,(group-value[,group-value...])) }

© Mike Murach & Associates, HCC, IBM17 Special Printer Line Controls OUTLIM=nnn parameter of the DD statement CONTROL= parameter of the OUTPUT statement LINECNT= parameter for JES2 OUTPUT statement //REPORT DD SYSOUT=A,OUTLIM=2000 CONTROL= {PROGRAM} {SINGLE } {DOUBLE } {TRIPLE } LINECT=nnn

© Mike Murach & Associates, HCC, IBM18 FORMS Handling Syntax for forms-handling in the DD statement Syntax for forms-handling in the OUTPUT statement SYSOUT=(class,,form-name) FCB=fcb-name FLASH= {overlay-name} {STD } FORMS= {form-name} {STD } FCB=fcb-name FLASH= {overlay-name} {STD }

© Mike Murach & Associates, HCC, IBM19 Invoice Printing Three ways to print invoices Three ways to print invoices Specify the name of a pre-printed form in a DD statement Specify the name of a pre-printed form in a DD statement //INVOICE DD SYSOUT=(C,,INV1),FCB=INV1 Specify the name of a pre-printed form in an OUTPUT statement Specify the name of a pre-printed form in an OUTPUT statement //OUT1 OUTPUT CLASS=C,FORMS=INV1,FCB=INV1 Printing on a laser printer with a blank sheet of paper Printing on a laser printer with a blank sheet of paper //OUT1 OUTPUT FLASH=INV1

© Mike Murach & Associates, HCC, IBM20 Standard JES OUTPUT Syntax for the JESDS parameter of an OUTPUT statement OUTPUT statement controlling JES data sets //OUT1 OUTPUT // CLASS=A,JESDS=ALL,COPIES=3,DEST=R100 JOB statement controlling JES data sets //MM01RN JOB (36512),'R MENENDEZ', // MSGCLASS=A,MSGLEVEL=(1,1) JESDS= {ALL} {LOG} {JCL} {MSG} JESDS= {ALL} {LOG} {JCL} {MSG}

© Mike Murach & Associates, HCC, IBM21 Figure 8-14a JES Output Control Basic Syntax of JES2 /*OUTPUT Statement Basic Syntax of JES2 /*OUTPUT Statement /*OUTPUT code [,parameter][,parameter]... /*OUTPUT code [,parameter][,parameter]... Basic syntax of JES3 //*FORMAT PR Statement Basic syntax of JES3 //*FORMAT PR Statement //*FORMAT PR,DDNAME=[ddname-specification][,parameter][,parameter]... //*FORMAT PR,DDNAME=[ddname-specification][,parameter][,parameter]...

© Mike Murach & Associates, HCC, IBM22 End Presentation