Transcript No Slide Title

Managing SYSOUT
Data Sets
Stephen Linkin
Houston Community College
14-Feb-07
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
1
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.
b.
c.
d.
e.
f.
g.
specify an output class and priority
release the data set for immediate processing
route the data set to a specific destination
hold the data set on the output queue
produce multiple copies of the data set
set an output limit
print the data set on special forms
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
2
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.
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
3
Syntax For The OUTPUT
Statement
//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
]
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
4
Syntax for DEFAULT parameter
DEFAULT= {YES}
{Y }
{NO }
{N }

Using job-level and step-level OUTPUT statements
//MM01RN JOB (36512),'R MENENDEZ',NOTIFY=MM01,MSGCLASS=X
SYSOUT=(,)
//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=(,)
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
5
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=(,)
//
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
6
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 }
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
7
CLASS Parameter Options

Syntax for the SYSOUT class of the DD statement
SYSOUT= {class}
{*}
{(,)}

Syntax for the CLASS parameter of the OUTPUT
statement
CLASS= {class}
{* }
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
8
Syntax Of PRTY Parameter For
OUTPUT Statement
PRTY=nnn

Using Output Classes To Set Printing Priorities
//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
//
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
9
Syntax Of SPIN Parameter For DD
Statement
SPIN= {UNALLOC}
{NO }
//REPORT DD SYSOUT=A,SPIN=UNALLOC
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
10
Syntax Of FREE Parameter For
DD Statement
FREE= {END }
{CLOSE}
//REPORT DD SYSOUT=A,SPIN=UNALLOC,FREE=CLOSE
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
11
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
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
12
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'
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
13
Possible Printer Destinations
Destination
OUTPUT
DD
JES2
ANYLOCAL
X
X
X
LOCAL
X
X
X
Name
X
X
X
Nnnnn
X
X
Rnnnn, RMnnnn,
RMTnnnn
X
X
X
Routes output to a remote terminal. The
number can be from 1 to 9999.
Userid
X
X
X
Routes output to a user-id at the local
node.
nodename.userid
X
X
Routes output to a node and a user-id
within the node.
(node,userid)
'IP:ipaddr',
'nodename.IP:ipaddr'
X
X
JES3
Description
Routes output to a local device
X
Routes output to a local device
Routes output to a destination identified
by a symbolic name up to 8 characters
long.
Routes output to a node. The number
can be from 1 to 1000.
X
X
Routes output to a node and a user-id
within the node.
X
X
Routes output to a TCP/IP routing
designation.
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
14
Syntax Of OUTDISP Parameter for
OUTPUT Statement (JES2)
OUTDISP=(normal-disp[,abnormal-disp])
//GOOD OUTPUT OUTDISP=(KEEP,PURGE),DEST=R100
//BAD
OUTPUT OUTDISP=(PURGE,HOLD)
//REPORT DD
SYSOUT=A,OUTPUT=(*.GOOD,*.BAD)

Syntax For HOLD= Parameter Of DD Statement
HOLD= {YES}
{Y }
{NO }
{N }
© 2002 - Mike Murach & Associates,
2007
- HCC,
Figure
8-08aIBM
15
Syntax Of COPIES Parameter
From OUTPUT and DD statements
COPIES= {nnn
}
{(nnn,(group-value[,group-value...]))}
{(,(group-value[,group-value...])) }

The COPIES parameter on the DD statement

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
//REPORT2 DD SYSOUT=A,COPIES=(,(2,3,1))

The COPIES parameter on an OUTPUT statement

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
//OUT2 OUTPUT CLASS=A,COPIES=(5,(2,3))
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
16
Special Printer Line Controls

OUTLIM=nnn parameter of the DD statement
 CONTROL=
parameter of the OUTPUT statement
//REPORT
DD SYSOUT=A,OUTLIM=2000
CONTROL= {PROGRAM}
 LINECNT= parameter
for JES2 OUTPUT statement
{SINGLE }
LINECT=nnn
{DOUBLE }
{TRIPLE }
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
17
FORMS Handling

Syntax for forms-handling in the DD statement
SYSOUT=(class,,form-name)
FCB=fcb-name
FLASH= {overlay-name}
{STD
}

Syntax for forms-handling in the OUTPUT
statement
FORMS= {form-name}
{STD
}
FCB=fcb-name
FLASH= {overlay-name}
{STD
}
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
18
Invoice Printing

Three ways to print invoices

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
//OUT1

OUTPUT CLASS=C,FORMS=INV1,FCB=INV1
Printing on a laser printer with a blank sheet of paper
//OUT1
OUTPUT FLASH=INV1
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
19
Standard JES OUTPUT

Syntax for the JESDS parameter of an OUTPUT
statement
JESDS= {ALL}
{LOG}
{JCL}
{MSG}

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)
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
20
JES Output Control

Basic Syntax of JES2 /*OUTPUT Statement


/*OUTPUT code [,parameter][,parameter]...
Basic syntax of JES3 //*FORMAT PR Statement

//*FORMAT PR,DDNAME=[ddname-specification][,parameter][,parameter]...
© 2002 - Mike Murach & Associates,
2007
- HCC,
Figure
8-14aIBM
21
End Presentation
© 2002 - Mike Murach & Associates,
2007 - HCC, IBM
22