z/OS

MVS JCL ReferenceVersion 2 Release 3

SA23-1385-30

IBM

NoteBefore using this information and the product it supports, read the information in Notices on page 725.

This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and to all subsequent releases and modificationsuntil otherwise indicated in new editions.

Last updated: May 29, 2018

Copyright IBM Corporation 1988, 2017.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

Figures . . . . . . . . . . . . . . xxi

Tables . . . . . . . . . . . . . . xxiii

About this document . . . . . . . . xxvWho should use this document . . . . . . . xxvWhere to find more information . . . . . . . xxvRelated information . . . . . . . . . . . xxv

Programs . . . . . . . . . . . . . xxvi

How to send your comments to IBM xxviiIf you have a technical problem. . . . . . . xxvii

Summary of changes. . . . . . . . xxixSummary of changes for z/OS Version 2 Release 3(V2R3) . . . . . . . . . . . . . . . xxixSummary of changes for z/OS Version 2 Release 2(V2R2) as updated December, 2015 . . . . . . xxxSummary of changes for z/OS Version 2 Release 2(V2R2) . . . . . . . . . . . . . . . xxxSummary of changes for z/OS Version 2 Release1 (V2R1) as updated December 2013 . . . . . xxxiiz/OS Version 2 Release 1 summary of changes xxxii

Chapter 1. Job control statements . . . 1JCL statements. . . . . . . . . . . . . . 1JECL statements . . . . . . . . . . . . . 2

Chapter 2. Job Control Tasks . . . . . 5Entering Jobs . . . . . . . . . . . . . . 5Processing Jobs . . . . . . . . . . . . . 6Requesting Resources . . . . . . . . . . . 6Task Charts . . . . . . . . . . . . . . . 6

Chapter 3. Format of statements. . . . 13JCL statement fields . . . . . . . . . . . 13

Parameter field . . . . . . . . . . . . 15JES2 control statement fields. . . . . . . . . 16JES3 control statement fields. . . . . . . . . 16Continuing statements . . . . . . . . . . . 16

Continuing JCL statements . . . . . . . . 16Examples of continued statements . . . . . . 17Continuing JES2 control statements . . . . . 18Continuing JES3 control statements . . . . . 18

Chapter 4. Syntax of parameters. . . . 19Notation used to show syntax . . . . . . . . 19Character sets . . . . . . . . . . . . . 21Syntax notes . . . . . . . . . . . . . . 23Backward references . . . . . . . . . . . 23

Examples of backward references . . . . . . 24

Chapter 5. Procedures and symbols . . 27Cataloged and in-stream procedures . . . . . . 27

In-stream procedures . . . . . . . . . . 27Cataloged procedures . . . . . . . . . . 27Using a procedure . . . . . . . . . . . 28Testing a procedure. . . . . . . . . . . 28

Modifying procedures . . . . . . . . . . . 29Modifying EXEC statement parameters . . . . 29Modifying OUTPUT JCL and DD statements . . 30Examples of procedures . . . . . . . . . 33

Nested procedures . . . . . . . . . . . . 35Nesting procedures . . . . . . . . . . . 35Modifying nested procedures . . . . . . . 36Examples of modifying nested procedures . . . 36

Using system symbols and JCL symbols . . . . . 38What are system symbols? . . . . . . . . 38What are JCL symbols? . . . . . . . . . 39Coding symbols in JCL . . . . . . . . . 43Determining equivalent JCL . . . . . . . . 45Examples of defining and coding symbols in JCL 51Using symbols in nested procedures . . . . . 52Examples of coding symbols in nestedprocedures . . . . . . . . . . . . . 53

Using symbols in JES in-stream data . . . . . . 55JCL symbol service (IEFSJSYM) . . . . . . . 56JES symbol service (IAZSYMBL) . . . . . . 56

Using symbols in batch JCL . . . . . . . . . 57

Chapter 6. Job control statements onthe output listing . . . . . . . . . . 59

Chapter 7. Started tasks . . . . . . . 61Determining whether to use a started task . . . . 61Determining the source JCL for the started task . . 61

START command processing when the memberis a procedure . . . . . . . . . . . . 62START command processing when the memberis a job . . . . . . . . . . . . . . . 62Review current started tasks . . . . . . . . 63Convert procedures to jobs (optional). . . . . 63

Determining system services for a started task. . . 65Deciding under which subsystem a started taskshould run . . . . . . . . . . . . . 65Running a started task under a job entrysubsystem . . . . . . . . . . . . . . 65Running a started task under the mastersubsystem . . . . . . . . . . . . . . 66Running a started task that uses catalogs . . . 67Set Up the master JCL . . . . . . . . . . 67

Coding the JCL . . . . . . . . . . . . . 67Naming the JCL member . . . . . . . . . 67Coding the JOB statement for the started task . . 68Using symbols in started task JCL . . . . . . 68

Naming a started task (source JCL is a job) . . . . 72Setting up operator education for your started task 73

Copyright IBM Corp. 1988, 2017 iii

Chapter 8. JCL command statement . . 75Description . . . . . . . . . . . . . . 75

Syntax . . . . . . . . . . . . . . . 75Operation field . . . . . . . . . . . . 75Parameter field . . . . . . . . . . . . 75Comments field . . . . . . . . . . . . 76Location in the JCL . . . . . . . . . . . 76Defaults . . . . . . . . . . . . . . 76Examples of the command statement . . . . . 76

Chapter 9. COMMAND statement . . . 77Description . . . . . . . . . . . . . . 77

Syntax . . . . . . . . . . . . . . . 77Name field . . . . . . . . . . . . . 78Operation field . . . . . . . . . . . . 78Parameter field . . . . . . . . . . . . 78Comments field . . . . . . . . . . . . 78Location in the JCL . . . . . . . . . . . 78Defaults . . . . . . . . . . . . . . 78Examples of the COMMAND statement . . . . 79

Chapter 10. Comment statement. . . . 81Description . . . . . . . . . . . . . . 81

Syntax . . . . . . . . . . . . . . . 81Location in the JCL . . . . . . . . . . . 81Listing of comments statements . . . . . . 81Examples of the comment statement . . . . . 81

Chapter 11. CNTL statement . . . . . 83Description . . . . . . . . . . . . . . 83

Syntax . . . . . . . . . . . . . . . 83Label field . . . . . . . . . . . . . . 83Operation field . . . . . . . . . . . . 83Parameter field . . . . . . . . . . . . 83Comments field . . . . . . . . . . . . 83Location in the JCL . . . . . . . . . . . 84Program control statements . . . . . . . . 84Program control statements in procedures . . . 84Example of the CNTL statement . . . . . . 84

Chapter 12. DD statement . . . . . . 85Description . . . . . . . . . . . . . . 85

Syntax . . . . . . . . . . . . . . . 85Name field . . . . . . . . . . . . . 85Operation field . . . . . . . . . . . . 87Parameter field . . . . . . . . . . . . 87Comments field . . . . . . . . . . . . 99Location in the JCL . . . . . . . . . . . 99Examples of DD statements and ddnames . . . 102

* Parameter . . . . . . . . . . . . . . 103Syntax. . . . . . . . . . . . . . . 103Defaults . . . . . . . . . . . . . . 103Relationship to other parameters . . . . . . 103Relationship to other control statements . . . 105Location in the JCL . . . . . . . . . . 105Unread records . . . . . . . . . . . . 105Examples of the * parameter . . . . . . . 105

ACCODE parameter . . . . . . . . . . . 106Syntax. . . . . . . . . . . . . . . 106Subparameter definition . . . . . . . . . 107

Defaults . . . . . . . . . . . . . . 107Overrides . . . . . . . . . . . . . 107Example of the ACCODE parameter. . . . . 107

AMP parameter . . . . . . . . . . . . 107Syntax. . . . . . . . . . . . . . . 108Subparameter definition . . . . . . . . . 109Relationship to other parameters . . . . . . 114Buffer requirements . . . . . . . . . . 115Examples of the AMP parameter . . . . . . 115

AVGREC parameter . . . . . . . . . . . 116Syntax . . . . . . . . . . . . . . . 116Subparameter definition . . . . . . . . . 116Overrides. . . . . . . . . . . . . . 116Relationship to other parameters . . . . . . 116Examples of the AVGREC parameter . . . . 117

BLKSIZE parameter . . . . . . . . . . . 117Syntax . . . . . . . . . . . . . . . 117Subparameter definition . . . . . . . . . 117Defaults . . . . . . . . . . . . . . 118Overrides. . . . . . . . . . . . . . 118Relationship to other control statements . . . 118Coexistence considerations . . . . . . . . 118Examples of the BLKSIZE parameter . . . . 119

BLKSZLIM parameter . . . . . . . . . . 119Syntax . . . . . . . . . . . . . . . 119Subparameter definition . . . . . . . . . 119Defaults . . . . . . . . . . . . . . 120Relationship to other parameters . . . . . . 120Example of the BLKSZLIM parameter . . . . 120

BURST parameter . . . . . . . . . . . . 120Syntax. . . . . . . . . . . . . . . 121Subparameter definition . . . . . . . . . 121Defaults . . . . . . . . . . . . . . 121Overrides . . . . . . . . . . . . . 121Relationship to other parameters . . . . . . 121Relationship to other control statements . . . 121Example of the BURST parameter . . . . . 121

CCSID parameter . . . . . . . . . . . . 122Syntax. . . . . . . . . . . . . . . 122Subparameter definition . . . . . . . . . 122Default . . . . . . . . . . . . . . 122Relationship to other parameters . . . . . . 122Examples of the CCSID parameter . . . . . 122

CHARS parameter. . . . . . . . . . . . 124Syntax. . . . . . . . . . . . . . . 125Subparameter definition . . . . . . . . . 125Defaults . . . . . . . . . . . . . . 125Overrides . . . . . . . . . . . . . 125Relationship to other parameters . . . . . . 126Relationship to other control statements . . . 126Requesting a high-density dump . . . . . . 126Examples of the CHARS parameter . . . . . 126

CHKPT parameter. . . . . . . . . . . . 126Syntax. . . . . . . . . . . . . . . 127Subparameter definition . . . . . . . . . 127Overrides . . . . . . . . . . . . . 127Relationship to other parameters . . . . . . 127Relationship to the SYSCKEOV DD statement 127Checkpointing concatenated data sets . . . . 127Examples of the CHKPT parameter . . . . . 127

CNTL parameter . . . . . . . . . . . . 128

iv z/OS MVS JCL Reference

Syntax. . . . . . . . . . . . . . . 128Subparameter definition . . . . . . . . . 128Examples of the CNTL parameter . . . . . 128

COPIES parameter . . . . . . . . . . . 129Syntax. . . . . . . . . . . . . . . 129Subparameter definition . . . . . . . . . 129Defaults . . . . . . . . . . . . . . 130Overrides . . . . . . . . . . . . . 130Relationship to Other Parameters. . . . . . 130Relationship to other control statements . . . 131Examples of the COPIES parameter . . . . . 131

DATA parameter . . . . . . . . . . . . 132Syntax. . . . . . . . . . . . . . . 132Defaults . . . . . . . . . . . . . . 132Relationship to other parameters . . . . . . 133Relationship to other control statements . . . 134Location in the JCL . . . . . . . . . . 134Unread records . . . . . . . . . . . . 134Examples of the DATA parameter . . . . . 134

DATACLAS parameter . . . . . . . . . . 135Syntax. . . . . . . . . . . . . . . 136Subparameter definition . . . . . . . . . 136Defaults . . . . . . . . . . . . . . 136Overrides . . . . . . . . . . . . . 137Relationship to other parameters . . . . . . 138Examples of the DATACLAS parameter . . . 138

DCB parameter. . . . . . . . . . . . . 138Syntax. . . . . . . . . . . . . . . 139Subparameter definition . . . . . . . . . 139Completing the data control block . . . . . 141Relationship to other parameters . . . . . . 141Examples of the DCB parameter . . . . . . 142DCB subparameters . . . . . . . . . . 143

DDNAME parameter . . . . . . . . . . . 153Syntax. . . . . . . . . . . . . . . 154Subparameter definition . . . . . . . . . 154Overrides . . . . . . . . . . . . . 154Relationship to other parameters . . . . . . 154Location in the JCL . . . . . . . . . . 154Referenced DD statement . . . . . . . . 155Backward references . . . . . . . . . . 156Examples of the DDNAME parameter . . . . 157

DEST parameter . . . . . . . . . . . . 158Syntax. . . . . . . . . . . . . . . 159Subparameter definition for JES2 systems . . . 159Subparameter definition for JES3 systems . . . 160Defaults . . . . . . . . . . . . . . 161Overrides . . . . . . . . . . . . . 162Relationship to other parameters . . . . . . 162Relationship to other control statements . . . 162Example of the DEST parameter . . . . . . 162

DISP parameter . . . . . . . . . . . . 162Syntax. . . . . . . . . . . . . . . 164Subparameter definition . . . . . . . . . 164Defaults . . . . . . . . . . . . . . 169Relationship to other parameters . . . . . . 170Disposition of QSAM data sets . . . . . . 170Disposition of generation data sets . . . . . 170Disposition of temporary data sets . . . . . 170Disposition of partitioned data sets (PDSs andPDSEs) . . . . . . . . . . . . . . 170

Adding a volume to a cataloged data set . . . 171DISP=MOD for a multivolume data set. . . . 171Summary of disposition processing . . . . . 173Examples of the DISP parameter . . . . . . 174

DLM parameter . . . . . . . . . . . . 175Syntax. . . . . . . . . . . . . . . 176Subparameter definition . . . . . . . . . 176Default . . . . . . . . . . . . . . 176Relationship to other parameters . . . . . . 176Invalid delimiters . . . . . . . . . . . 177Example of the DLM parameter . . . . . . 177

DSID Parameter . . . . . . . . . . . . 177Syntax. . . . . . . . . . . . . . . 178Subparameter definition . . . . . . . . . 178Relationship to other parameters . . . . . . 178Example of the DSID parameter . . . . . . 178

DSKEYLBL parameter . . . . . . . . . . 178Overrides . . . . . . . . . . . . . 179Subparameter definition . . . . . . . . . 179Syntax. . . . . . . . . . . . . . . 179Example of the DSKEYLBL parameter . . . . 179

DSNAME parameter . . . . . . . . . . . 179Syntax. . . . . . . . . . . . . . . 180Subparameter definition . . . . . . . . . 181Relationship to other parameters . . . . . . 186Examples of the DSNAME parameter . . . . 187

DSNTYPE parameter . . . . . . . . . . . 188Syntax. . . . . . . . . . . . . . . 189Subparameter definition . . . . . . . . . 189Defaults . . . . . . . . . . . . . . 190Overrides . . . . . . . . . . . . . 190Relationship to other parameters . . . . . . 191Examples of the DSNTYPE parameter . . . . 191

DUMMY parameter . . . . . . . . . . . 192Syntax. . . . . . . . . . . . . . . 193Parameters on DD DUMMY statements . . . 193Relationship to other parameters . . . . . . 193Relationship to other control statements . . . 193Relationship to access methods . . . . . . 194Examples of the DUMMY parameter . . . . 194

DYNAM parameter . . . . . . . . . . . 195Syntax. . . . . . . . . . . . . . . 195Relationship to other parameters . . . . . . 195Relationship to other control statements . . . 195Example of the DYNAM parameter . . . . . 195

EATTR parameter . . . . . . . . . . . . 196Syntax. . . . . . . . . . . . . . . 196Subparameter definition . . . . . . . . . 196Examples of the EATTR parameter . . . . . 196

EXPDT parameter . . . . . . . . . . . . 197Syntax. . . . . . . . . . . . . . . 197Subparameter definition . . . . . . . . . 197Overrides . . . . . . . . . . . . . 198Relationship to other parameters . . . . . . 198Deleting a data set before its expiration date 198Examples of the EXPDT parameter . . . . . 199

FCB parameter . . . . . . . . . . . . . 199Syntax. . . . . . . . . . . . . . . 200Subparameter definition . . . . . . . . . 200Defaults . . . . . . . . . . . . . . 200Overrides . . . . . . . . . . . . . 200

Contents v

||||||||||

Relationship to other parameters . . . . . . 200Relationship to other control statements . . . 201Defining an FCB image for a work station. . . 201Requesting a high-density dump . . . . . . 201Examples of the FCB parameter . . . . . . 201

FILEDATA parameter. . . . . . . . . . . 202Syntax. . . . . . . . . . . . . . . 202Subparameter definition . . . . . . . . . 202Defaults . . . . . . . . . . . . . . 203Overrides . . . . . . . . . . . . . 203Relationship to other parameters . . . . . . 203Example of the FILEDATA parameter . . . . 203

FLASH parameter . . . . . . . . . . . . 203Syntax. . . . . . . . . . . . . . . 204Subparameter definition . . . . . . . . . 204Defaults . . . . . . . . . . . . . . 204Overrides . . . . . . . . . . . . . 204Relationship to other parameters . . . . . . 204Relationship to other control statements . . . 205Verification of forms overlay frame . . . . . 205Printing without flashing . . . . . . . . 205Example of the FLASH parameter . . . . . 205

FREE parameter . . . . . . . . . . . . 205Syntax. . . . . . . . . . . . . . . 206Subparameter definition . . . . . . . . . 206Defaults . . . . . . . . . . . . . . 206Overrides . . . . . . . . . . . . . 206Relationship to other parameters . . . . . . 206Relationship to other control statements . . . 207Relationship to the CLOSE macro instruction 207Examples of the FREE parameter . . . . . . 207

FREEVOL parameter . . . . . . . . . . . 208Syntax. . . . . . . . . . . . . . . 208Subparameter definition . . . . . . . . . 208Defaults . . . . . . . . . . . . . . 209Overrides . . . . . . . . . . . . . 209Relationship to other parameters . . . . . . 209Relationship to other control statements . . . 209

GDGORDER parameter . . . . . . . . . . 209Syntax. . . . . . . . . . . . . . . 209Subparameter definition . . . . . . . . . 209Defaults . . . . . . . . . . . . . . 209Example of the GDGORDER parameter . . . 210

HOLD parameter . . . . . . . . . . . . 210Syntax . . . . . . . . . . . . . . . 211Subparameter definition . . . . . . . . . 211Defaults . . . . . . . . . . . . . . 211Overrides . . . . . . . . . . . . . 212Relationship to other parameters . . . . . . 212Relationship to other control statements . . . 212Examples of the HOLD parameter . . . . . 212

KEYLABL1 parameter . . . . . . . . . . 213Syntax. . . . . . . . . . . . . . . 213Subparameter definition . . . . . . . . . 213Defaults . . . . . . . . . . . . . . 213Overrides . . . . . . . . . . . . . 214Relationship to other parameters . . . . . . 214Examples of the KEYLABL1 parameter . . . . 214

KEYLABL2 parameter . . . . . . . . . . 214Syntax. . . . . . . . . . . . . . . 215Subparameter definition . . . . . . . . . 215

Defaults . . . . . . . . . . . . . . 215Overrides . . . . . . . . . . . . . 215Relationship to other parameters . . . . . . 215Examples of the KEYLABL2 parameter . . . . 215

KEYENCD1 parameter . . . . . . . . . . 216Syntax. . . . . . . . . . . . . . . 216Subparameter definition . . . . . . . . . 216Overrides . . . . . . . . . . . . . 217Relationship to other parameters . . . . . . 217Example of the KEYENCD1 parameter . . . . 217

KEYENCD2 parameter . . . . . . . . . . 217Syntax. . . . . . . . . . . . . . . 217Subparameter definition . . . . . . . . . 217Overrides . . . . . . . . . . . . . 218Relationship to other parameters . . . . . . 218Example of the KEYENCD2 parameter . . . . 218

KEYLEN parameter . . . . . . . . . . . 218Syntax. . . . . . . . . . . . . . . 218Subparameter definition . . . . . . . . . 218Overrides . . . . . . . . . . . . . 219Relationship to other parameters . . . . . . 219Examples of the KEYLEN parameter . . . . 219

KEYOFF parameter . . . . . . . . . . . 219Syntax. . . . . . . . . . . . . . . 220Subparameter definition . . . . . . . . . 220Overrides . . . . . . . . . . . . . 220Relationship to other parameters . . . . . . 220Example of the KEYOFF parameter . . . . . 220

LABEL parameter . . . . . . . . . . . . 221Syntax. . . . . . . . . . . . . . . 221Subparameter definition . . . . . . . . . 222Defaults . . . . . . . . . . . . . . 225Relationship to other parameters . . . . . . 225Relationship to other control statements . . . 226Data conversion . . . . . . . . . . . 226Examples of the LABEL parameter . . . . . 226

LGSTREAM parameter . . . . . . . . . . 227Syntax. . . . . . . . . . . . . . . 228Subparameter definition . . . . . . . . . 228Defaults . . . . . . . . . . . . . . 228Overrides . . . . . . . . . . . . . 228Relationship to other parameters . . . . . . 228Example of the LGSTREAM parameter . . . . 229

LIKE parameter . . . . . . . . . . . . 229Syntax. . . . . . . . . . . . . . . 230Subparameter definition . . . . . . . . . 230Overrides . . . . . . . . . . . . . 230Relationship to other parameters . . . . . . 231Examples of the LIKE parameter . . . . . . 231

LRECL parameter . . . . . . . . . . . . 231Syntax. . . . . . . . . . . . . . . 232Subparameter definition . . . . . . . . . 232Overrides . . . . . . . . . . . . . 232Relationship to other parameters . . . . . . 232Examples of the LRECL parameter . . . . . 233

MAXGENS parameter . . . . . . . . . . 233Syntax. . . . . . . . . . . . . . . 233Subparameter definition . . . . . . . . . 233Relationship to other parameters . . . . . . 233Examples of the MAXGENS parameter . . . . 233

MGMTCLAS parameter . . . . . . . . . . 234

vi z/OS MVS JCL Reference

Syntax. . . . . . . . . . . . . . . 234Subparameter definition . . . . . . . . . 234Defaults . . . . . . . . . . . . . . 235Overrides . . . . . . . . . . . . . 235Relationship to other parameters . . . . . . 235Example of the MGMTCLAS parameter . . . 235

MODIFY parameter . . . . . . . . . . . 235Syntax. . . . . . . . . . . . . . . 236Subparameter definition . . . . . . . . . 236Defaults . . . . . . . . . . . . . . 236Overrides . . . . . . . . . . . . . 236Relationship to other parameters . . . . . . 237Relationship to other control statements . . . 237Example of the MODIFY parameter . . . . . 237

OUTLIM parameter . . . . . . . . . . . 237Syntax. . . . . . . . . . . . . . . 237Subparameter definition . . . . . . . . . 238Default . . . . . . . . . . . . . . 238Relationship to other parameters . . . . . . 238Relationship to other control statements . . . 238Example of the OUTLIM parameter . . . . . 238

OUTPUT parameter . . . . . . . . . . . 238Syntax. . . . . . . . . . . . . . . 239Subparameter definition . . . . . . . . . 239Defaults . . . . . . . . . . . . . . 239Overrides . . . . . . . . . . . . . 240Relationship to other parameters . . . . . . 240Location in the JCL . . . . . . . . . . 241No match for OUTPUT name . . . . . . . 241Processing options in multiple references . . . 241Examples of the OUTPUT parameter . . . . 241

PATH parameter . . . . . . . . . . . . 242Syntax. . . . . . . . . . . . . . . 242Subparameter definition . . . . . . . . . 243Defaults . . . . . . . . . . . . . . 244Relationship to other parameters . . . . . . 244Relationship to other statements . . . . . . 245Dummy z/OS UNIX files . . . . . . . . 245Example of the PATH parameter . . . . . . 245

PATHDISP parameter . . . . . . . . . . 245Syntax. . . . . . . . . . . . . . . 246Subparameter definition . . . . . . . . . 246Defaults . . . . . . . . . . . . . . 246Relationship to other parameters . . . . . . 247Example of the PATHDISP parameter . . . . 247

PATHMODE parameter . . . . . . . . . . 247Syntax. . . . . . . . . . . . . . . 248Subparameter definition . . . . . . . . . 248Defaults . . . . . . . . . . . . . . 250Relationship to other parameters . . . . . . 250Example of the PATHMODE parameter . . . 251

PATHOPTS parameter . . . . . . . . . . 251Syntax. . . . . . . . . . . . . . . 251Subparameter definition . . . . . . . . . 252Defaults . . . . . . . . . . . . . . 253Relationship to other parameters . . . . . . 253File status . . . . . . . . . . . . . 254Example of the PATHOPTS parameter . . . . 254

PROTECT parameter . . . . . . . . . . . 254Syntax. . . . . . . . . . . . . . . 255Subparameter definition . . . . . . . . . 255

Overrides . . . . . . . . . . . . . 255Relationship to other parameters . . . . . . 255Requirements for protecting a tape data set . . 256Requirements for protecting a tape volume . . 256Requirements for protecting a direct access dataset . . . . . . . . . . . . . . . . 256Examples of the PROTECT parameter . . . . 256

RECFM parameter. . . . . . . . . . . . 257Coding RECFM for BDAM access method. . . 257Coding RECFM for BPAM access method . . . 258Coding RECFM for BSAM, EXCP, and QSAMaccess methods . . . . . . . . . . . . 258Overrides . . . . . . . . . . . . . 259Relationship to other parameters . . . . . . 260Examples of the RECFM parameter . . . . . 260

RECORG parameter . . . . . . . . . . . 260Syntax. . . . . . . . . . . . . . . 260Subparameter definition . . . . . . . . . 260Defaults . . . . . . . . . . . . . . 261Overrides . . . . . . . . . . . . . 261Relationship to other parameters . . . . . . 261Example of the RECORG parameter . . . . . 261

REFDD parameter . . . . . . . . . . . . 261Syntax. . . . . . . . . . . . . . . 262Subparameter definition . . . . . . . . . 262Overrides . . . . . . . . . . . . . 263Relationship to other parameters . . . . . . 263Examples of the REFDD parameter . . . . . 263

RETPD parameter . . . . . . . . . . . . 264Syntax. . . . . . . . . . . . . . . 264Subparameter definition . . . . . . . . . 264Overrides . . . . . . . . . . . . . 265Relationship to other parameters . . . . . . 265Deleting a data set before its retention periodpasses . . . . . . . . . . . . . . . 265Examples of the RETPD parameter . . . . . 265

RLS parameter . . . . . . . . . . . . . 266Syntax. . . . . . . . . . . . . . . 266Subparameter definition . . . . . . . . . 266Overrides . . . . . . . . . . . . . 267Relationship to other parameters . . . . . . 267Examples of the RLS parameter . . . . . . 267

ROACCESS parameter . . . . . . . . . . 268Syntax. . . . . . . . . . . . . . . 268Subparameter definition . . . . . . . . . 268Defaults . . . . . . . . . . . . . . 269Relationship to other control statements . . . 269Example of the ROACCESS parameter . . . . 269

SECMODEL parameter . . . . . . . . . . 269Syntax. . . . . . . . . . . . . . . 270Subparameter definition . . . . . . . . . 270Overrides . . . . . . . . . . . . . 270Relationship to other parameters . . . . . . 270Examples of the SECMODEL parameter . . . 270

SEGMENT parameter . . . . . . . . . . 270Syntax. . . . . . . . . . . . . . . 271Subparameter definition . . . . . . . . . 271Overrides . . . . . . . . . . . . . 271Relationship to other parameters . . . . . . 271Example of the segment parameter . . . . . 271

SPACE parameter . . . . . . . . . . . . 272

Contents vii

||||||||||||

Syntax. . . . . . . . . . . . . . . 273Subparameter definition . . . . . . . . . 273Overrides . . . . . . . . . . . . . 278Relationship to other parameters . . . . . . 279SPACE for new data sets with SMS . . . . . 279Examples of the SPACE parameter . . . . . 279

SPIN parameter . . . . . . . . . . . . 280Syntax. . . . . . . . . . . . . . . 280Subparameter definition . . . . . . . . . 280Defaults . . . . . . . . . . . . . . 281Overrides . . . . . . . . . . . . . 282Relationship to other parameters . . . . . . 282Examples of the SPIN parameter . . . . . . 282

STORCLAS parameter . . . . . . . . . . 283Syntax. . . . . . . . . . . . . . . 283Subparameter definition . . . . . . . . . 284Defaults . . . . . . . . . . . . . . 284Overrides . . . . . . . . . . . . . 284Relationship to other parameters . . . . . . 284Examples of the STORCLAS parameter. . . . 284

SUBSYS parameter . . . . . . . . . . . 285Syntax. . . . . . . . . . . . . . . 285Subparameter definition . . . . . . . . . 286Relationship to other parameters . . . . . . 286Subsystem support for JCL parameters . . . . 287Examples of the SUBSYS parameter . . . . . 287

SYMBOLS parameter . . . . . . . . . . . 288Syntax. . . . . . . . . . . . . . . 288Relationship to other parameters . . . . . . 289Example of the SYMBOLS parameter . . . . 289

SYMLIST parameter . . . . . . . . . . . 289Syntax. . . . . . . . . . . . . . . 289Relationship to other parameters . . . . . . 290Example of the SYMLIST parameter . . . . . 290

SYSOUT parameter . . . . . . . . . . . 290Syntax. . . . . . . . . . . . . . . 291Subparameter definition . . . . . . . . . 292Defaults . . . . . . . . . . . . . . 293Overrides . . . . . . . . . . . . . 293Relationship to other parameters . . . . . . 294Relationship to other control statements . . . 294Starting an external writer when requested . . 294Held classes in a JES2 system . . . . . . . 295Held classes in a JES3 system . . . . . . . 295Significance of output classes . . . . . . . 295Examples of the SYSOUT parameter. . . . . 295

TERM parameter . . . . . . . . . . . . 296Syntax. . . . . . . . . . . . . . . 296Subparameter definition . . . . . . . . . 296Relationship to other parameters . . . . . . 297Location in the JCL . . . . . . . . . . 297Examples of the TERM parameter . . . . . 297

UCS parameter . . . . . . . . . . . . . 298Syntax. . . . . . . . . . . . . . . 298Subparameter definition . . . . . . . . . 298Defaults . . . . . . . . . . . . . . 299Overrides . . . . . . . . . . . . . 299Relationship to other parameters . . . . . . 300Using special character sets. . . . . . . . 300Examples of the UCS parameter . . . . . . 300

UNIT parameter . . . . . . . . . . . . 300

Syntax. . . . . . . . . . . . . . . 301Subparameter definition . . . . . . . . . 301Overrides . . . . . . . . . . . . . 305Relationship to other parameters . . . . . . 305Relationship to other control statements . . . 306Location in the JCL . . . . . . . . . . 306Examples of the UNIT parameter. . . . . . 306

VOLUME parameter . . . . . . . . . . . 308Syntax. . . . . . . . . . . . . . . 309Subparameter definition . . . . . . . . . 310Generation data group (GDG) considerations 316Overrides . . . . . . . . . . . . . 317Relationship to other parameters . . . . . . 317VOLUME parameter in a JES3 system . . . . 317VOLUME parameter for optical readers . . . 317VOLUME parameter for nonspecific volumerequests . . . . . . . . . . . . . . 317VOLUME parameter for specific multi-volumetape requests . . . . . . . . . . . . 318Examples of the VOLUME parameter . . . . 318

Chapter 13. Special DD statements 321Description . . . . . . . . . . . . . . 321

Syntax. . . . . . . . . . . . . . . 321Special ddnames . . . . . . . . . . . 321

JOBLIB DD statement . . . . . . . . . . 321Syntax. . . . . . . . . . . . . . . 321Parameters on JOBLIB DD statements . . . . 321Relationship to other control statements . . . 323Location in the JCL . . . . . . . . . . 323Relationship of a JOBLIB to a STEPLIB . . . . 323Examples of the JOBLIB DD statement . . . . 323

STEPLIB DD statement . . . . . . . . . . 324Syntax. . . . . . . . . . . . . . . 325Parameters on STEPLIB DD statements. . . . 325Relationship to other control statements . . . 326Location in the JCL . . . . . . . . . . 326Relationship of a STEPLIB to a JOBLIB . . . . 326Examples of the STEPLIB DD statement . . . 326

SYSABEND, SYSMDUMP, and SYSUDUMP DDstatements . . . . . . . . . . . . . . 327

Syntax. . . . . . . . . . . . . . . 328Location in the JCL . . . . . . . . . . 328Storing a dump. . . . . . . . . . . . 328Printing a dump . . . . . . . . . . . 329Overriding dump DD statements . . . . . . 329Duplicate dump requests . . . . . . . . 330Examples of the SYSABEND, SYSMDUMP, andSYSUDUMP DD statements . . . . . . . 330

SYSCHK DD statement . . . . . . . . . . 331Syntax. . . . . . . . . . . . . . . 331Parameters on SYSCHK DD statements. . . . 331Relationship to other control statements . . . 332Location in the JCL . . . . . . . . . . 333Examples of the SYSCHK DD statement . . . 333

SYSCKEOV DD statement . . . . . . . . . 333Syntax. . . . . . . . . . . . . . . 333Parameters on SYSCKEOV DD statements. . . 333Location in the JCL . . . . . . . . . . 334Example of the SYSCKEOV DD statement . . . 334

SYSIN DD statement . . . . . . . . . . . 334

viii z/OS MVS JCL Reference

||

Syntax. . . . . . . . . . . . . . . 334Parameters on SYSIN DD statements . . . . 334Location in the JCL . . . . . . . . . . 334Examples of SYSIN DD statements . . . . . 334

Chapter 14. Delimiter statement . . . 337Description . . . . . . . . . . . . . . 337

Syntax. . . . . . . . . . . . . . . 337Comments field . . . . . . . . . . . 337Relationship to the DLM parameter . . . . . 337Location in the JCL . . . . . . . . . . 338Examples of the delimiter statement . . . . . 338

Chapter 15. ENDCNTL statement . . . 339Description . . . . . . . . . . . . . . 339

Syntax. . . . . . . . . . . . . . . 339Label field . . . . . . . . . . . . . 339Operation field . . . . . . . . . . . . 339Comments field . . . . . . . . . . . 339Location in the JCL . . . . . . . . . . 339Example of the ENDCNTL statement . . . . 339

Chapter 16. EXEC statement . . . . . 341Description . . . . . . . . . . . . . . 341

Syntax. . . . . . . . . . . . . . . 341Name field . . . . . . . . . . . . . 341Operation field . . . . . . . . . . . . 342Parameter field . . . . . . . . . . . . 342Comments field . . . . . . . . . . . 345Location in the JCL . . . . . . . . . . 345Examples of EXEC statements . . . . . . . 345

ACCT parameter . . . . . . . . . . . . 346Syntax. . . . . . . . . . . . . . . 346Subparameter definition . . . . . . . . . 347On an EXEC statement that calls a procedure 347Examples of the ACCT parameter . . . . . 347

ADDRSPC parameter. . . . . . . . . . . 348Syntax. . . . . . . . . . . . . . . 348Subparameter definition . . . . . . . . . 348Defaults . . . . . . . . . . . . . . 348Overrides . . . . . . . . . . . . . 348Relationship to the EXEC REGION parameter 349On an EXEC statement that calls a procedure 349Examples of the ADDRSPC parameter . . . . 349

CCSID parameter . . . . . . . . . . . . 349Syntax. . . . . . . . . . . . . . . 350Subparameter definition . . . . . . . . . 350Default . . . . . . . . . . . . . . 350Relationship to other parameters . . . . . . 350Examples of the CCSID parameter . . . . . 350

COND parameter . . . . . . . . . . . . 350Syntax. . . . . . . . . . . . . . . 351Subparameter definition . . . . . . . . . 352Overrides . . . . . . . . . . . . . 353Location in the JCL . . . . . . . . . . 353On an EXEC statement that calls a procedure 353Considerations when using the CONDparameter . . . . . . . . . . . . . 354Summary of COND parameters . . . . . . 355Examples of the COND parameter . . . . . 356

DYNAMNBR parameter. . . . . . . . . . 358Syntax. . . . . . . . . . . . . . . 358Subparameter definition . . . . . . . . . 358Defaults . . . . . . . . . . . . . . 359On an EXEC statement that calls a procedure 359Example of the DYNAMNBR parameter . . . 359

MEMLIMIT parameter . . . . . . . . . . 359Syntax. . . . . . . . . . . . . . . 359Subparameter definition . . . . . . . . . 359Defaults . . . . . . . . . . . . . . 360Overrides . . . . . . . . . . . . . 360Relationship to the REGION parameter. . . . 360Considerations when using the MEMLIMITparameter . . . . . . . . . . . . . 360Example of the MEMLIMIT parameter . . . . 360

PARM parameter . . . . . . . . . . . . 360Syntax. . . . . . . . . . . . . . . 361Subparameter definition . . . . . . . . . 361On an EXEC statement that calls a procedure 361Examples of the PARM parameter . . . . . 362

PARMDD parameter . . . . . . . . . . . 362Syntax. . . . . . . . . . . . . . . 363Relationship to other control statements . . . 363Data set requirements . . . . . . . . . 363Record length requirements . . . . . . . 363Parameter string requirements. . . . . . . 363Examples of the PARMDD parameter . . . . 364

PERFORM parameter. . . . . . . . . . . 365Syntax. . . . . . . . . . . . . . . 365Subparameter definition . . . . . . . . . 365Defaults . . . . . . . . . . . . . . 365Overrides . . . . . . . . . . . . . 366On an EXEC statement that calls a procedure 366Example of the PERFORM parameter . . . . 366

PGM parameter . . . . . . . . . . . . 366Syntax. . . . . . . . . . . . . . . 366Subparameter definition . . . . . . . . . 367Examples of the PGM parameter . . . . . . 367

PROC and procedure name parameters. . . . . 368Syntax. . . . . . . . . . . . . . . 368Subparameter definition . . . . . . . . . 368Effect of PROC parameter on other parametersand following statements . . . . . . . . 369Examples of the PROC parameter . . . . . 369

RD parameter . . . . . . . . . . . . . 369Syntax. . . . . . . . . . . . . . . 370Subparameter definition . . . . . . . . . 370Defaults . . . . . . . . . . . . . . 371Overrides . . . . . . . . . . . . . 371Relationship to other control statements . . . 371On an EXEC statement that calls a procedure 371Examples of the RD parameter . . . . . . 372

REGION parameter . . . . . . . . . . . 372Syntax. . . . . . . . . . . . . . . 373Subparameter definition . . . . . . . . . 373Defaults . . . . . . . . . . . . . . 373Overrides . . . . . . . . . . . . . 374Relationship to the EXEC ADDRSPC parameter 374On an EXEC statement that calls a procedure 374Relationship to the MEMLIMIT parameter. . . 374Relationship to the REGIONX parameter . . . 374

Contents ix

Considerations when using the REGIONparameter . . . . . . . . . . . . . 374Examples of the REGION parameter . . . . 375

REGIONX parameter . . . . . . . . . . . 375Syntax. . . . . . . . . . . . . . . 375Subparameter definition . . . . . . . . . 375Defaults . . . . . . . . . . . . . . 376Overrides . . . . . . . . . . . . . 376Relationship to the EXEC ADDRSPC parameter 377On an EXEC statement that calls a procedure 377Relationship to the MEMLIMIT parameter. . . 377Examples of the REGIONX parameter . . . . 377

RLSTMOUT parameter . . . . . . . . . . 377Syntax. . . . . . . . . . . . . . . 378Defaults . . . . . . . . . . . . . . 378Examples of the RLSTMOUT parameter . . . 378

TIME parameter . . . . . . . . . . . . 378Syntax. . . . . . . . . . . . . . . 379Subparameter definition . . . . . . . . . 379Defaults . . . . . . . . . . . . . . 379Overrides . . . . . . . . . . . . . 379On an EXEC statement that calls a procedure 380Examples of the TIME parameter . . . . . . 380

TVSMSG parameter . . . . . . . . . . . 382Syntax. . . . . . . . . . . . . . . 382Subparameter definition . . . . . . . . . 382Defaults . . . . . . . . . . . . . . 382Overrides . . . . . . . . . . . . . 382Examples of the TVSMSG parameter . . . . 382

Chapter 17. EXPORT statement. . . . 383Description . . . . . . . . . . . . . . 383

Syntax. . . . . . . . . . . . . . . 383Label field . . . . . . . . . . . . . 383Operation field . . . . . . . . . . . . 383Parameter field . . . . . . . . . . . . 383Comments field . . . . . . . . . . . 384Location in the JCL . . . . . . . . . . 384

SYMLIST parameter . . . . . . . . . . . 384Syntax. . . . . . . . . . . . . . . 385Subparameter definition . . . . . . . . . 385Examples . . . . . . . . . . . . . . 385

Chapter 18. IF/THEN/ELSE/ENDIFstatement construct . . . . . . . . 389Description . . . . . . . . . . . . . . 389

Syntax. . . . . . . . . . . . . . . 389Name field . . . . . . . . . . . . . 389Operation field . . . . . . . . . . . . 390Relational-expression field . . . . . . . . 390Comments field . . . . . . . . . . . 395Location in the JCL . . . . . . . . . . 395Relationship to other parameters . . . . . . 395THEN and ELSE clauses . . . . . . . . 396Considerations when using theIF/THEN/ELSE/ENDIF construct . . . . . 396Examples of IF/THEN/ELSE/ENDIF statementconstructs . . . . . . . . . . . . . 398

Chapter 19. INCLUDE statement . . . 403Description . . . . . . . . . . . . . . 403

Syntax. . . . . . . . . . . . . . . 403Name field . . . . . . . . . . . . . 403Operation field . . . . . . . . . . . . 403Parameter field . . . . . . . . . . . . 403Comments field . . . . . . . . . . . 404Location in the JCL . . . . . . . . . . 404Considerations for using INCLUDE groups . . 404Examples of the INCLUDE statement: . . . . 405

Chapter 20. JCLLIB statement . . . . 407Description . . . . . . . . . . . . . . 407

Syntax. . . . . . . . . . . . . . . 407Name field . . . . . . . . . . . . . 407Operation field . . . . . . . . . . . . 408Parameter field . . . . . . . . . . . . 408Comments field . . . . . . . . . . . 409Location in the JCL . . . . . . . . . . 409Considerations for using the JCLLIB statement 410Examples of the JCLLIB statement . . . . . 410

Chapter 21. JOB statement . . . . . 413Description . . . . . . . . . . . . . . 413

Syntax. . . . . . . . . . . . . . . 413Name field . . . . . . . . . . . . . 413Operation field . . . . . . . . . . . . 414Parameter field . . . . . . . . . . . . 414Comments field . . . . . . . . . . . 418Location in the JCL . . . . . . . . . . 418Examples of JOB statements . . . . . . . 418

Accounting information parameter . . . . . . 419Syntax. . . . . . . . . . . . . . . 419Subparameter definition . . . . . . . . . 420Relationship to other control statements . . . 420JES2 accounting information format . . . . . 420Syntax. . . . . . . . . . . . . . . 420Examples of the accounting informationparameter . . . . . . . . . . . . . 421

ADDRSPC parameter. . . . . . . . . . . 422Syntax. . . . . . . . . . . . . . . 422Subparameter definition . . . . . . . . . 422Defaults . . . . . . . . . . . . . . 422Overrides . . . . . . . . . . . . . 422Relationship to the JOB REGION parameter . . 422Examples of the ADDRSPC parameter . . . . 423

BYTES parameter . . . . . . . . . . . . 423Syntax. . . . . . . . . . . . . . . 423Subparameter definition . . . . . . . . . 423Defaults . . . . . . . . . . . . . . 424Overrides . . . . . . . . . . . . . 424Relationship to other parameters . . . . . . 424Relationship to other control statements . . . 424Examples of the BYTES parameter . . . . . 424

CARDS parameter. . . . . . . . . . . . 425Syntax. . . . . . . . . . . . . . . 425Subparameter definition . . . . . . . . . 425Defaults . . . . . . . . . . . . . . 426Overrides . . . . . . . . . . . . . 426Relationship to other parameters . . . . . . 426

x z/OS MVS JCL Reference

||||||||||||

Relationship to other control statements . . . 426Examples of the CARDS parameter . . . . . 426

CCSID parameter . . . . . . . . . . . . 427Syntax. . . . . . . . . . . . . . . 427Subparameter definition . . . . . . . . . 427Default . . . . . . . . . . . . . . 427Overrides . . . . . . . . . . . . . 427Relationship to other parameters . . . . . . 427Examples of the CCSID parameter . . . . . 428

CLASS parameter . . . . . . . . . . . . 428Syntax. . . . . . . . . . . . . . . 428Subparameter definition . . . . . . . . . 429Defaults . . . . . . . . . . . . . . 429Overrides . . . . . . . . . . . . . 429Relationship to other control statements . . . 429Example of the CLASS parameter . . . . . 429

COND parameter . . . . . . . . . . . . 429Syntax. . . . . . . . . . . . . . . 430Subparameter definition . . . . . . . . . 430Overrides . . . . . . . . . . . . . 430Summary of COND parameters . . . . . . 431Examples of the COND parameter . . . . . 431

DSENQSHR parameter . . . . . . . . . . 431Syntax. . . . . . . . . . . . . . . 432Subparameter definition . . . . . . . . . 432Defaults . . . . . . . . . . . . . . 432Overrides . . . . . . . . . . . . . 432Relationship to other control statements . . . 432Examples of the DSENQSHR parameter . . . 432

EMAIL parameter . . . . . . . . . . . . 433Syntax. . . . . . . . . . . . . . . 433Subparameter definition . . . . . . . . . 433Defaults . . . . . . . . . . . . . . 434Relationship to other parameters . . . . . . 434Examples of the EMAIL parameter . . . . . 434

GDGBIAS parameter . . . . . . . . . . . 434Syntax. . . . . . . . . . . . . . . 434Subparameter definition . . . . . . . . . 434Defaults . . . . . . . . . . . . . . 434Examples of the GDGBIAS parameter . . . . 435

GROUP parameter . . . . . . . . . . . 435Syntax. . . . . . . . . . . . . . . 435Subparameter definition . . . . . . . . . 436Defaults . . . . . . . . . . . . . . 436Example of the GROUP parameter . . . . . 436

JESLOG parameter . . . . . . . . . . . 436Syntax. . . . . . . . . . . . . . . 436Subparameter definition . . . . . . . . . 436Defaults . . . . . . . . . . . . . . 437Examples of the JESLOG parameter . . . . . 437

JOBRC parameter . . . . . . . . . . . . 438Syntax. . . . . . . . . . . . . . . 438Subparameter definition . . . . . . . . . 438Defaults . . . . . . . . . . . . . . 438Overrides . . . . . . . . . . . . . 438Relationship to other control statements . . . 438Examples of the JOBRC parameter . . . . . 438

LINES parameter . . . . . . . . . . . . 439Syntax. . . . . . . . . . . . . . . 439Subparameter definition . . . . . . . . . 439Defaults . . . . . . . . . . . . . . 439

Overrides . . . . . . . . . . . . . 440Relationship to other parameters . . . . . . 440Relationship to other control statements . . . 440Examples of the LINES parameter . . . . . 440

MEMLIMIT parameter . . . . . . . . . . 440Syntax. . . . . . . . . . . . . . . 441Subparameter definition . . . . . . . . . 441Defaults . . . . . . . . . . . . . . 441Overrides . . . . . . . . . . . . . 441Relationship to the REGION parameter. . . . 441Considerations when using the MEMLIMITparameter . . . . . . . . . . . . . 441Examples of the MEMLIMIT parameter . . . 441

MSGCLASS parameter . . . . . . . . . . 442Syntax. . . . . . . . . . . . . . . 442Subparameter definition . . . . . . . . . 442Defaults . . . . . . . . . . . . . . 442Significance of output classes . . . . . . . 442Examples of the MSGCLASS parameter . . . 443

MSGLEVEL parameter . . . . . . . . . . 443Syntax. . . . . . . . . . . . . . . 444Subparameter definition . . . . . . . . . 444Defaults . . . . . . . . . . . . . . 444Examples of the MSGLEVEL parameter . . . 445

NOTIFY parameter . . . . . . . . . . . 445Syntax. . . . . . . . . . . . . . . 445Subparameter definition for JES2 systems . . . 445Subparameter definition for JES3 systems . . . 446Receiving notification of job completion . . . 446Examples of the NOTIFY parameter . . . . . 446

PAGES parameter . . . . . . . . . . . . 447Syntax. . . . . . . . . . . . . . . 447Subparameter definition . . . . . . . . . 447Defaults . . . . . . . . . . . . . . 447Overrides . . . . . . . . . . . . . 448Relationship to other parameters . . . . . . 448Relationship to other control statements . . . 448Examples of the PAGES parameter . . . . . 448

PASSWORD parameter . . . . . . . . . . 448Syntax. . . . . . . . . . . . . . . 449Subparameter definition . . . . . . . . . 449Relationship to other parameters . . . . . . 450Examples of the PASSWORD parameter . . . 451

PERFORM parameter. . . . . . . . . . . 451Syntax. . . . . . . . . . . . . . . 451Subparameter definition . . . . . . . . . 451Defaults . . . . . . . . . . . . . . 452Overrides . . . . . . . . . . . . . 452Examples of the PERFORM parameter . . . . 452

Programmers name parameter . . . . . . . 453Syntax. . . . . . . . . . . . . . . 453Parameter definition . . . . . . . . . . 453Examples of the programmers name parameter 453

PRTY parameter . . . . . . . . . . . . 454Syntax. . . . . . . . . . . . . . . 455Subparameter definition . . . . . . . . . 455Defaults . . . . . . . . . . . . . . 455Example of the PRTY parameter . . . . . . 455

RD parameter . . . . . . . . . . . . . 455Syntax. . . . . . . . . . . . . . . 456Subparameter definition . . . . . . . . . 456

Contents xi

||||||||||||||||||||||

Defaults . . . . . . . . . . . . . . 457Overrides . . . . . . . . . . . . . 457Relationship to other control statements . . . 458Examples of the RD parameter . . . . . . 458

REGION parameter . . . . . . . . . . . 458Syntax. . . . . . . . . . . . . . . 459Subparameter definition . . . . . . . . . 459Defaults . . . . . . . . . . . . . . 460Overrides . . . . . . . . . . . . . 460Relationship to the JOB ADDRSPC parameter 460Relationship to the MEMLIMIT parameter. . . 460Relationship to the REGIONX parameter . . . 460Considerations when using the REGIONparameter . . . . . . . . . . . . . 460Examples of the REGION parameter . . . . 460

REGIONX parameter . . . . . . . . . . . 461Syntax. . . . . . . . . . . . . . . 461Subparameter definition . . . . . . . . . 461Defaults . . . . . . . . . . . . . . 461Overrides . . . . . . . . . . . . . 462Relationship to the JOB ADDRSPC parameter 462On a JOB statement that calls a procedure . . . 462Relationship to the MEMLIMIT parameter. . . 463Examples of the REGIONX parameter . . . . 463

RESTART parameter . . . . . . . . . . . 463Syntax. . . . . . . . . . . . . . . 463Subparameter definition . . . . . . . . . 464Relationship to other control statements . . . 464Cautions when coding the RESTART parameter 464Generation data sets in restarted jobs . . . . 465Examples of the RESTART parameter . . . . 465

SECLABEL parameter . . . . . . . . . . 466Syntax. . . . . . . . . . . . . . . 466Subparameter definition . . . . . . . . . 466Defaults . . . . . . . . . . . . . . 466Relationship to other parameters . . . . . . 466Example of the SECLABEL parameter . . . . 466

SCHENV parameter . . . . . . . . . . . 467Syntax. . . . . . . . . . . . . . . 467Subparameter definition . . . . . . . . . 467Defaults . . . . . . . . . . . . . . 467Relationship to other control statements . . . 468Example of the SCHENV parameter . . . . . 468

SYSAFF parameter . . . . . . . . . . . 468Syntax. . . . . . . . . . . . . . . 468Subparameter definition . . . . . . . . . 469Defaults . . . . . . . . . . . . . . 469Relationship to other control statements . . . 469Examples of the SYSAFF parameter . . . . . 469

SYSTEM parameter . . . . . . . . . . . 470Syntax. . . . . . . . . . . . . . . 470Subparameter definition . . . . . . . . . 470Relationship to other control statements . . . 471Examples of the SYSTEM parameter. . . . . 471

TIME parameter . . . . . . . . . . . . 471Syntax. . . . . . . . . . . . . . . 472Subparameter definition . . . . . . . . . 472Defaults . . . . . . . . . . . . . . 472Overrides . . . . . . . . . . . . . 473Examples of the TIME parameter . . . . . . 473

Examples of the TIME parameter on JOB andEXEC statements . . . . . . . . . . . 473

TYPRUN parameter . . . . . . . . . . . 474Syntax. . . . . . . . . . . . . . . 475Subparameter definition . . . . . . . . . 475Relationship to other control statements . . . 476Example of the TYPRUN parameter . . . . . 476

UJOBCORR parameter . . . . . . . . . . 476Syntax. . . . . . . . . . . . . . . 477Subparameter definition . . . . . . . . . 477Examples of the UJOBCORR parameter . . . 477

USER parameter . . . . . . . . . . . . 477Syntax. . . . . . . . . . . . . . . 478Subparameter definition . . . . . . . . . 478Defaults . . . . . . . . . . . . . . 478Relationship to other parameters . . . . . . 478Example of the USER parameter . . . . . . 478

Chapter 22. NOTIFY statement . . . . 481Description . . . . . . . . . . . . . . 481

Syntax. . . . . . . . . . . . . . . 481Label field . . . . . . . . . . . . . . 481Operation field . . . . . . . . . . . . . 481Parameter field . . . . . . . . . . . . . 481Defaults . . . . . . . . . . . . . . . 482Overrides . . . . . . . . . . . . . . 482Location in the JCL . . . . . . . . . . . 482Relationship to other control statements . . . . 482Example of the NOTIFY statement: . . . . . . 482EMAIL parameter . . . . . . . . . . . . 482

Syntax. . . . . . . . . . . . . . . 483Defaults . . . . . . . . . . . . . . 483

USER parameter . . . . . . . . . . . . 483Syntax. . . . . . . . . . . . . . . 483Defaults . . . . . . . . . . . . . . 483

TYPE parameter . . . . . . . . . . . . 483Syntax. . . . . . . . . . . . . . . 483Subparameter definition . . . . . . . . . 484Defaults . . . . . . . . . . . . . . 484

WHEN parameter . . . . . . . . . . . . 484Syntax. . . . . . . . . . . . . . . 484Defaults . . . . . . . . . . . . . . 485Example of the WHEN parameter . . . . . 485

Chapter 23. Null Statement . . . . . 487Description . . . . . . . . . . . . . . 487

Syntax. . . . . . . . . . . . . . . 487Location in the JCL . . . . . . . . . . 487Example of the null statement . . . . . . . 487

Chapter 24. OUTPUT JCL statement 489Description . . . . . . . . . . . . . . 489

Syntax. . . . . . . . . . . . . . . 489Name field . . . . . . . . . . . . . 489Operation field . . . . . . . . . . . . 489Parameter field . . . . . . . . . . . . 490Comments field . . . . . . . . . . . 498Location in the JCL . . . . . . . . . . 498Overrides . . . . . . . . . . . . . 499Relationship to sysout DD statement . . . . 500

xii z/OS MVS JCL Reference

||||||||||||||||||||||||||||||||||||||||||||||||||

Relationship to the JES2 /*OUTPUT statement 500Relationship to the JES3 //*FORMAT statement 500

ADDRESS parameter . . . . . . . . . . . 500Syntax. . . . . . . . . . . . . . . 501Subparameter definition . . . . . . . . . 501Defaults . . . . . . . . . . . . . . 501Overrides . . . . . . . . . . . . . 501Examples of the ADDRESS parameter . . . . 501

AFPPARMS parameter . . . . . . . . . . 502Syntax. . . . . . . . . . . . . . . 502Parameter definition . . . . . . . . . . 502Defaults . . . . . . . . . . . . . . 502Overrides . . . . . . . . . . . . . 502Relationship to other control statements . . . 502Example of the AFPPARM keyword . . . . . 502

AFPSTATS parameter. . . . . . . . . . . 503Syntax. . . . . . . . . . . . . . . 503Parameter definition . . . . . . . . . . 503Defaults . . . . . . . . . . . . . . 503Overrides . . . . . . . . . . . . . 503Relationship to other control statements . . . 504Example of the AFPSTATS keyword . . . . . 504

BUILDING parameter . . . . . . . . . . 504Syntax. . . . . . . . . . . . . . . 504Subparameter definition . . . . . . . . . 504Defaults . . . . . . . . . . . . . . 504Overrides . . . . . . . . . . . . . 505Example of the BUILDING parameter . . . . 505

BURST parameter . . . . . . . . . . . . 505Syntax. . . . . . . . . . . . . . . 505Subparameter definition . . . . . . . . . 505Defaults . . . . . . . . . . . . . . 505Overrides . . . . . . . . . . . . . 506Example of the BURST parameter . . . . . 506

CHARS parameter. . . . . . . . . . . . 506Syntax. . . . . . . . . . . . . . . 506Subparameter definition . . . . . . . . . 506Defaults . . . . . . . . . . . . . . 507Overrides . . . . . . . . . . . . . 507Requesting a high-density dump . . . . . . 507Example of the CHARS parameter . . . . . 507

CKPTLINE parameter . . . . . . . . . . 508Syntax. . . . . . . . . . . . . . . 508Subparameter definition . . . . . . . . . 508Defaults . . . . . . . . . . . . . . 508Example of the CKPTLINE parameter . . . . 508

CKPTPAGE parameter . . . . . . . . . . 508Syntax. . . . . . . . . . . . . . . 509Subparameter definition . . . . . . . . . 509Defaults . . . . . . . . . . . . . . 509Relationship to other parameters . . . . . . 509Example of the CKPTPAGE parameter . . . . 509

CKPTSEC parameter . . . . . . . . . . . 509Syntax. . . . . . . . . . . . . . . 509Subparameter definition . . . . . . . . . 509Defaults . . . . . . . . . . . . . . 510Relationship to other parameters . . . . . . 510Example of the CKPTSEC parameter . . . . 510

CLASS parameter . . . . . . . . . . . . 510Syntax. . . . . . . . . . . . . . . 510Subparameter definition . . . . . . . . . 510

Overrides . . . . . . . . . . . . . 510Held Classes in a JES2 system . . . . . . . 511Held Classes in a JES3 system . . . . . . . 511Significance of output classes . . . . . . . 511Examples of the CLASS parameter . . . . . 512

COLORMAP parameter . . . . . . . . . . 512Syntax. . . . . . . . . . . . . . . 512Subparameter definition . . . . . . . . . 512Example of the COLORMAP parameter . . . 512

COMPACT parameter . . . . . . . . . . 512Syntax. . . . . . . . . . . . . . . 513Subparameter definition . . . . . . . . . 513Defaults . . . . . . . . . . . . . . 513Overrides . . . . . . . . . . . . . 513Example of the COMPACT parameter . . . . 513

COMSETUP parameter . . . . . . . . . . 513Syntax. . . . . . . . . . . . . . . 513Subparameter definition . . . . . . . . . 514Example of the COMSETUP parameter . . . . 514

CONTROL parameter . . . . . . . . . . 514Syntax. . . . . . . . . . . . . . . 514Subparameter definition . . . . . . . . . 514Defaults . . . . . . . . . . . . . . 514Example of the CONTROL parameter . . . . 515

COPIES parameter . . . . . . . . . . . 515Syntax. . . . . . . . . . . . . . . 515Subparameter definition . . . . . . . . . 515Defaults . . . . . . . . . . . . . . 516Overrides . . . . . . . . . . . . . 516Relationship to other parameters . . . . . . 516Relationship to other control statements . . . 516Examples of the COPIES parameter . . . . . 516

COPYCNT parameter . . . . . . . . . . 517Syntax. . . . . . . . . . . . . . . 517Subparameter definition . . . . . . . . . 517Defaults . . . . . . . . . . . . . . 517Overrides . . . . . . . . . . . . . 517Relationship to other parameters . . . . . . 517Relationship to other control statements . . . 517Examples of the COPYCNT parameter . . . . 518

DATACK parameter . . . . . . . . . . . 518Syntax. . . . . . . . . . . . . . . 518Subparameter definition . . . . . . . . . 518Defaults . . . . . . . . . . . . . . 519Relationship to other parameters . . . . . . 519Example of the DATACK parameter . . . . . 519

DDNAME parameter . . . . . . . . . . . 519Syntax. . . . . . . . . . . . . . . 519Subparameter definition . . . . . . . . . 519Example of the DDNAME parameter . . . . 520

DEFAULT parameter . . . . . . . . . . . 520Syntax. . . . . . . . . . . . . . . 520Subparameter definition . . . . . . . . . 520Defaults . . . . . . . . . . . . . . 520Location in the JCL . . . . . . . . . . 521References to default OUTPUT JCL statements 521Example of the DEFAULT parameter . . . . 521

DEPT parameter . . . . . . . . . . . . 522Syntax. . . . . . . . . . . . . . . 522Subparameter definition . . . . . . . . . 522Defaults . . . . . . . . . . . . . . 523

Contents xiii

Overrides . . . . . . . . . . . . . 523Example of the DEPT parameter . . . . . . 523

DEST parameter . . . . . . . . . . . . 523Syntax. . . . . . . . . . . . . . . 524Subparameter definition for JES2 systems . . . 524Subparameter definition for JES3 systems . . . 525Defaults . . . . . . . . . . . . . . 526Overrides . . . . . . . . . . . . . 526Relationship to other parameters . . . . . . 526Examples of the DEST parameter . . . . . . 526

DPAGELBL parameter . . . . . . . . . . 527Syntax. . . . . . . . . . . . . . . 527Subparameter definition . . . . . . . . . 528Defaults . . . . . . . . . . . . . . 528Relationship to other parameters . . . . . . 528Example of the DPAGELBL parameter . . . . 528

DUPLEX parameter . . . . . . . . . . . 528Syntax. . . . . . . . . . . . . . . 528Subparameter definition . . . . . . . . . 528Relationship to other keywords on thisstatement. . . . . . . . . . . . . . 529Example of the DUPLEX parameter . . . . . 529

FCB parameter . . . . . . . . . . . . . 529Syntax. . . . . . . . . . . . . . . 530Subparameter definition . . . . . . . . . 530Defaults . . . . . . . . . . . . . . 530Overrides . . . . . . . . . . . . . 530Relationship to other parameters . . . . . . 530Requesting a high-density dump . . . . . . 530Example of the FCB parameter . . . . . . 531

FLASH parameter . . . . . . . . . . . . 531Syntax. . . . . . . . . . . . . . . 531Subparameter definition . . . . . . . . . 531Defaults . . . . . . . . . . . . . . 532Overrides . . . . . . . . . . . . . 532Relationship to other parameters . . . . . . 532Verification of forms overlay frame . . . . . 532Printing without flashing . . . . . . . . 532Example of the FLASH parameter . . . . . 532

FORMDEF parameter . . . . . . . . . . 533Syntax. . . . . . . . . . . . . . . 533Subparameter definition . . . . . . . . . 533Overrides . . . . . . . . . . . . . 533Example of the FORMDEF parameter . . . . 533

FORMLEN parameter . . . . . . . . . . 534Syntax. . . . . . . . . . . . . . . 534Subparameter definition . . . . . . . . . 534Relationship to other control statements . . . 534Examples of the FORMLEN parameter . . . . 534

FORMS parameter. . . . . . . . . . . . 535Syntax. . . . . . . . . . . . . . . 535Subparameter definition . . . . . . . . . 535Defaults . . . . . . . . . . . . . . 535Overrides . . . . . . . . . . . . . 535Example of the FORMS parameter . . . . . 535

FSSDATA parameter . . . . . . . . . . . 535Syntax. . . . . . . . . . . . . . . 536Subparameter definition . . . . . . . . . 536Defaults . . . . . . . . . . . . . . 536Overrides . . . . . . . . . . . . . 537

Relationship to other keywords on thisstatement. . . . . . . . . . . . . . 537Relationship to other system functions . . . . 537Examples of the FSSDATA parameter . . . . 537

GROUPID parameter . . . . . . . . . . . 538Syntax. . . . . . . . . . . . . . . 538Subparameter definition . . . . . . . . . 538Relationship to other control statements . . . 538Examples of the GROUPID parameter . . . . 538

INDEX parameter . . . . . . . . . . . . 539Syntax. . . . . . . . . . . . . . . 540Subparameter definition . . . . . . . . . 540Defaults . . . . . . . . . . . . . . 540Relationship to other parameters . . . . . . 540Example of the INDEX parameter . . . . . 540

INTRAY parameter . . . . . . . . . . . 540Syntax. . . . . . . . . . . . . . . 540Subparameter definition . . . . . . . . . 540Relationship to other keywords on thisstatement. . . . . . . . . . . . . . 540Example of the INTRAY parameter . . . . . 541

JESDS parameter . . . . . . . . . . . . 541Syntax. . . . . . . . . . . . . . . 541Subparameter definition . . . . . . . . . 541Overrides . . . . . . . . . . . . . 542Location in the JCL . . . . . . . . . . 542Destination for the system data sets . . . . . 542JES2 processing with JESDS . . . . . . . 542JES3 processing with JESDS . . . . . . . 542Example of the JESDS parameter . . . . . . 542

LINDEX parameter . . . . . . . . . . . 543Syntax. . . . . . . . . . . . . . . 543Subparameter definition . . . . . . . . . 543Defaults . . . . . . . . . . . . . . 543Relationship to other parameters . . . . . . 543Example of the LINDEX parameter . . . . . 543

LINECT parameter . . . . . . . . . . . 544Syntax. . . . . . . . . . . . . . . 544Subparameter definition . . . . . . . . . 544Defaults . . . . . . . . . . . . . . 544Example of the LINECT parameter . . . . . 544

MAILBCC parameter . . . . . . . . . . . 544Syntax. . . . . . . . . . . . . . . 544Subparameter definition . . . . . . . . . 545Defaults . . . . . . . . . . . . . . 545Overrides . . . . . . . . . . . . . 545Relationship to other system functions . . . . 545Examples of the MAILBCC parameter . . . . 545

MAILCC parameter . . . . . . . . . . . 545Syntax. . . . . . . . . . . . . . . 545Subparameter definition . . . . . . . . . 546Defaults . . . . . . . . . . . . . . 546Overrides . . . . . . . . . . . . . 546Relationship to other system functions . . . . 546Examples of the MAILCC parameter . . . . 546

MAILFILE parameter. . . . . . . . . . . 546Syntax. . . . . . . . . . . . . . . 546Subparameter definition . . . . . . . . . 547Defaults . . . . . . . . . . . . . . 547Overrides . . . . . . . . . . . . . 547Relationship to other system functions . . . . 547

xiv z/OS MVS JCL Reference

Example of the MAILFILE parameter . . . . 547MAILFROM parameter . . . . . . . . . . 547

Syntax. . . . . . . . . . . . . . . 547Subparameter definition . . . . . . . . . 547Defaults . . . . . . . . . . . . . . 547Overrides . . . . . . . . . . . . . 548Relationship to other system functions . . . . 548Example of the MAILFROM parameter. . . . 548

MAILTO parameter . . . . . . . . . . . 548Syntax. . . . . . . . . . . . . . . 548Subparameter definition . . . . . . . . . 548Defaults . . . . . . . . . . . . . . 548Overrides . . . . . . . . . . . . . 548Relationship to other system functions . . . . 548Example of the MAILTO parameter . . . . . 548

MERGE parameter . . . . . . . . . . . 549Syntax. . . . . . . . . . . . . . . 549Subparameter definition . . . . . . . . . 549Defaults . . . . . . . . . . . . . . 549Example of the MERGE parameter . . . . . 549

MODIFY parameter . . . . . . . . . . . 549Syntax. . . . . . . . . . . . . . . 550Subparameter definition . . . . . . . . . 550Defaults . . . . . . . . . . . . . . 550Overrides . . . . . . . . . . . . . 551Relationship to other parameters . . . . . . 551Example of the MODIFY parameter . . . . . 551

NAME parameter . . . . . . . . . . . . 551Syntax. . . . . . . . . . . . . . . 551Subparameter definition . . . . . . . . . 551Defaults . . . . . . . . . . . . . . 551Overrides . . . . . . . . . . . . . 552Example of the NAME parameter . . . . . 552

NOTIFY parameter . . . . . . . . . . . 552Syntax. . . . . . . . . . . . . . . 552Subparameter definitions . . . . . . . . 553Defaults . . . . . . . . . . . . . . 553Examples of the NOTIFY parameter . . . . . 553

OFFSETXB parameter . . . . . . . . . . 553Syntax. . . . . . . . . . . . . . . 553Subparameter definition . . . . . . . . . 553Relationship to other keywords on thisstatement. . . . . . . . . . . . . . 554Example of the OFFSETXB parameter . . . . 554

OFFSETXF parameter . . . . . . . . . . 554OFFSETYB parameter . . . . . . . . . . 554OFFSETYF parameter . . . . . . . . . . 554OUTBIN parameter . . . . . . . . . . . 554

Syntax. . . . . . . . . . . . . . . 554Subparameter definition . . . . . . . . . 554Defaults . . . . . . . . . . . . . . 555Overrides . . . . . . . . . . . . . 555Relationship to other system functions . . . . 555Example of the OUTBIN parameter . . . . . 555

OUTDISP parameter . . . . . . . . . . . 555Syntax. . . . . . . . . . . . . . . 555Subparameter definitions . . . . . . . . 556Defaults . . . . . . . . . . . . . . 556Overrides . . . . . . . . . . . . . 556Relationship to other control statements . . . 556Examples of the OUTDISP parameter . . . . 557

OVERLAYB parameter . . . . . . . . . . 557Syntax. . . . . . . . . . . . . . . 557Subparameter definition . . . . . . . . . 558Relationship to other keywords on thisstatement. . . . . . . . . . . . . . 558Example of the OVERLAYB parameter . . . . 558

OVERLAYF parameter . . . . . . . . . . 558OVFL parameter . . . . . . . . . . . . 558

Syntax. . . . . . . . . . . . . . . 558Subparameter definition . . . . . . . . . 558Defaults . . . . . . . . . . . . . . 558Example of the OVFL parameter . . . . . . 559

PAGEDEF parameter . . . . . . . . . . . 559Syntax. . . . . . . . . . . . . . . 559Subparameter definition . . . . . . . . . 560Overrides . . . . . . . . . . . . . 560Example of the PAGEDEF parameter . . . . 560

PIMSG parameter . . . . . . . . . . . . 560Syntax. . . . . . . . . . . . . . . 561Subparameter definition . . . . . . . . . 561Defaults . . . . . . . . . . . . . . 561Examples of the PIMSG parameter . . . . . 561

PORTNO parameter . . . . . . . . . . . 562Syntax. . . . . . . . . . . . . . . 562Subparameter definition . . . . . . . . . 562Relationship to other system functions . . . . 562Example of the PORTNO parameter . . . . . 562

PRMODE parameter . . . . . . . . . . . 562Syntax. . . . . . . . . . . . . . . 562Subparameter definition . . . . . . . . . 562Defaults . . . . . . . . . . . . . . 563Printing a line-mode data set using PSF . . . 563Example of the PRMODE parameter . . . . 563

PRTATTRS parameter . . . . . . . . . . 563Syntax. . . . . . . . . . . . . . . 563Parameter definition . . . . . . . . . . 564Defaults . . . . . . . . . . . . . . 564Overrides . . . . . . . . . . . . . 564Relationship to other keywords on thisstatement. . . . . . . . . . . . . . 564Relationship to other control statements . . . 564Example of the PRTATTRS parameter . . . . 564

PRTERROR parameter . . . . . . . . . . 564Syntax. . . . . . . . . . . . . . . 564Subparameter definition . . . . . . . . . 564Relationship to other control statements . . . 565Examples of the PRTERROR parameter. . . . 565

PRTOPTNS parameter . . . . . . . . . . 565Syntax. . . . . . . . . . . . . . . 565Subparameter definition . . . . . . . . . 566Relationship to other system functions . . . . 566Example of the PRTOPTNS parameter . . . . 566

PRTQUEUE parameter . . . . . . . . . . 566Syntax. . . . . . . . . . . . . . . 566Subparameter definition . . . . . . . . . 566Relationship to other system functions . . . . 566Example of the PRTQUEUE parameter . . . . 566

PRTY parameter . . . . . . . . . . . . 566Syntax. . . . . . . . . . . . . . . 567Subparameter definition . . . . . . . . . 567Defaults . . . . . . . . . . . . . . 567

Contents xv

Overrides . . . . . . . . . . . . . 567Example of the PRTY parameter . . . . . . 567

REPLYTO parameter . . . . . . . . . . . 567Syntax. . . . . . . . . . . . . . . 567Subparameter definition . . . . . . . . . 567Defaults . . . . . . . . . . . . . . 568Overrides . . . . . . . . . . . . . 568Relationship to other system functions . . . . 568Example of the REPLYTO parameter . . . . 568

RESFMT parameter . . . . . . . . . . . 568Syntax. . . . . . . . . . . . . . . 568Subparameter definition . . . . . . . . . 568Relationship to other control statements . . . 568Example of the RESFMT parameter . . . . . 568

RETAINS and RETAINF parameters . . . . . . 568Syntax. . . . . . . . . . . . . . . 569Subparameter definition . . . . . . . . . 569Relationship to other control statements . . . 569Relationship to other system functions . . . . 569Examples of the RETAIN keywords . . . . . 569

RETRYL and RETRYT parameters. . . . . . . 570Syntax. . . . . . . . . . . . . . . 570Subparameter definition . . . . . . . . . 570Relationship to other control statements . . . 570Relationship to other system functions . . . . 570Examples of the RETRY keywords . . . . . 571

ROOM parameter . . . . . . . . . . . . 571Syntax. . . . . . . . . . . . . . . 571Subparameter definition . . . . . . . . . 571Defaults . . . . . . . . . . . . . . 571Overrides . . . . . . . . . . . . . 572Example of the ROOM parameter . . . . . 572

SYSAREA parameter . . . . . . . . . . . 572Syntax. . . . . . . . . . . . . . . 572Subparameter definition . . . . . . . . . 572Defaults . . . . . . . . . . . . . . 573Relationship to other parameters . . . . . . 573Example of the SYSAREA parameter . . . . 573

THRESHLD parameter . . . . . . . . . . 573Syntax. . . . . . . . . . . . . . . 573Subparameter definition . . . . . . . . . 573Defaults . . . . . . . . . . . . . . 573Example of the THRESHLD parameter . . . . 574

TITLE parameter . . . . . . . . . . . . 574Syntax. . . . . . . . . . . . . . . 574Subparameter definition . . . . . . . . . 574Example of the TITLE parameter . . . . . . 574

TRC parameter . . . . . . . . . . . . . 575Syntax. . . . . . . . . . . . . . . 575Subparameter definition . . . . . . . . . 575Defaults . . . . . . . . . . . . . . 575Relationship to other parameters . . . . . . 575Example of the TRC parameter . . . . . . 575

UCS parameter . . . . . . . . . . . . . 576Syntax. . . . . . . . . . . . . . . 576Subparameter definition . . . . . . . . . 576Defaults . . . . . . . . . . . . . . 576Overrides . . . . . . . . . . . . . 577Using special characters sets . . . . . . . 577Example of the UCS parameter . . . . . . 578

USERDATA parameter . . . . . . . . . . 578

Syntax. . . . . . . . . . . . . . . 578Subparameter definition . . . . . . . . . 578Defaults . . . . . . . . . . . . . . 578Overrides . . . . . . . . . . . . . 578Relationship to other keywords on thisstatement. . . . . . . . . . . . . . 579Relationship to other control statements . . . 579Relationship to other system functions . . . . 579Examples of the USERDATA parameter . . . 579

USERLIB parameter . . . . . . . . . . . 581Syntax. . . . . . . . . . . . . . . 581Subparameter definitions . . . . . . . . 581Defaults . . . . . . . . . . . . . . 582Overrides . . . . . . . . . . . . . 582Requirements for USERLIB libraries . . . . . 582Examples of the USERLIB parameter . . . . 582

USERPATH parameter . . . . . . . . . . 582Syntax. . . . . . . . . . . . . . . 583Subparameter definitions . . . . . . . . 583Defaults . . . . . . . . . . . . . . 583Overrides . . . . . . . . . . . . . 583Relationship to other system functions . . . . 583Examples of the USERPATH parameter. . . . 583

WRITER parameter . . . . . . . . . . . 584Syntax. . . . . . . . . . . . . . . 584Subparameter definition . . . . . . . . . 584Defaults . . . . . . . . . . . . . . 584Overrides . . . . . . . . . . . . . 584Relationship to other parameters . . . . . . 584Starting an external writer . . . . . . . . 584Examples of the WRITER parameter. . . . . 584

Chapter 25. PEND statement . . . . . 587Description . . . . . . . . . . . . . . 587

Syntax. . . . . . . . . . . . . . . 587Name field . . . . . . . . . . . . . 587Operation field . . . . . . . . . . . . 587Comments field . . . . . . . . . . . 587Location in the JCL . . . . . . . . . . 587Examples of the PEND statement. . . . . . 587

Chapter 26. PROC statement . . . . . 589Description . . . . . . . . . . . . . . 589

Syntax. . . . . . . . . . . . . . . 589Name field . . . . . . . . . . . . . 589Operation field . . . . . . . . . . . . 590Parameter field . . . . . . . . . . . . 590Comments field . . . . . . . . . . . 590Overrides . . . . . . . . . . . . . 590Location in the JCL . . . . . . . . . . 590Examples of the PROC statement. . . . . . 590

Chapter 27. SCHEDULE statement 591Description . . . . . . . . . . . . . . 591

Syntax. . . . . . . . . . . . . . . 591Name field . . . . . . . . . . . . . 591Operation field . . . . . . . . . . . . 591Parameter field . . . . . . . . . . . . 591Comments field . . . . . . . . . . . 592Location in the JCL . . . . . . . . . . 592

xvi z/OS MVS JCL Reference

AFTER Parameter . . . . . . . . . . . . 593Syntax. . . . . . . . . . . . . . . 593Subparameter definition . . . . . . . . . 594Relationship to other parameters . . . . . . 594

BEFORE Parameter . . . . . . . . . . . 594Syntax. . . . . . . . . . . . . . . 594Subparameter definition . . . . . . . . . 595Relationship to other parameters . . . . . . 595

DELAY Parameter . . . . . . . . . . . . 595Syntax. . . . . . . . . . . . . . . 595Subparameter definition . . . . . . . . . 595Relationship to other parameters . . . . . . 595

HOLDUNTL Parameter . . . . . . . . . . 595Syntax. . . . . . . . . . . . . . . 596Subparameter definition . . . . . . . . . 596Relationship to other parameters . . . . . . 596

JOBGROUP Parameter . . . . . . . . . . 596Syntax. . . . . . . . . . . . . . . 597Subparameter definition . . . . . . . . . 597Defaults . . . . . . . . . . . . . . 597Relationship to other parameters . . . . . . 597Examples of the JOBGROUP parameter . . . 597

STARTBY Parameter . . . . . . . . . . . 597Syntax. . . . . . . . . . . . . . . 598Subparameter definition . . . . . . . . . 598Relationship to other parameters . . . . . . 598

WITH Parameter . . . . . . . . . . . . 598Syntax. . . . . . . . . . . . . . . 599Subparameter definition . . . . . . . . . 599Relationship to other jobs . . . . . . . . 599Example of the WITH parameter . . . . . . 599

Examples of SCHEDULE statement . . . . . . 599Dynamic job sequencing (SCHEDULEBEFORE=/AFTER=/DELAY=YES) . . . . . . 600

Chapter 28. SET statement . . . . . 603Description . . . . . . . . . . . . . . 603

Syntax. . . . . . . . . . . . . . . 603Name field . . . . . . . . . . . . . 604Operation field . . . . . . . . . . . . 604Parameter field . . . . . . . . . . . . 604Comments field . . . . . . . . . . . 604Overrides . . . . . . . . . . . . . 605Location in the JCL . . . . . . . . . . 605Relationship to other control statements . . . 605Considerations for using the SET statement . . 606Examples of the SET statement . . . . . . 606

Chapter 29. XMIT JCL statement . . . 609Description . . . . . . . . . . . . . . 610

Syntax. . . . . . . . . . . . . . . 610Name field . . . . . . . . . . . . . 610Operation field . . . . . . . . . . . . 610Parameter field . . . . . . . . . . . . 610Comments field . . . . . . . . . . . 610Location in the JCL . . . . . . . . . . 610Error on XMIT JCL statement . . . . . . . 611Examples of the XMIT JCL statement . . . . 611

DEST parameter . . . . . . . . . . . . 612Syntax. . . . . . . . . . . . . . . 612

Subparameter definition . . . . . . . . . 612Examples of the DEST parameter . . . . . . 612

DLM parameter . . . . . . . . . . . . 613Syntax. . . . . . . . . . . . . . . 613Subparameter definition . . . . . . . . . 613Default . . . . . . . . . . . . . . 613Invalid delimiters . . . . . . . . . . . 613Examples of the DLM parameter . . . . . . 613

SUBCHARS parameter . . . . . . . . . . 614Syntax. . . . . . . . . . . . . . . 614Subparameter definition . . . . . . . . . 615Default . . . . . . . . . . . . . . 615Invalid substitute . . . . . . . . . . . 615Examples of the SUBCHARS parameter . . . 615

Chapter 30. JES2 Execution ControlStatements . . . . . . . . . . . . 617Examples of a JOBGROUP and associated jobs . . 617JOBGROUP logging job . . . . . . . . . . 618Other attributes of a JOBGROUP logging job . . . 618JES2 exit processing for JOBGROUP JCL . . . . 619Associating jobs with a job group . . . . . . 619Processing for jobs in a job group . . . . . . 619Configuring and activating job groups . . . . . 620JOBGROUP statement . . . . . . . . . . 620

Description . . . . . . . . . . . . . 621GJOB statement . . . . . . . . . . . . 624

Description . . . . . . . . . . . . . 625JOBSET statement . . . . . . . . . . . . 626

Description . . . . . . . . . . . . . 626SJOB statement . . . . . . . . . . . . . 627

Description . . . . . . . . . . . . . 627ENDSET statement . . . . . . . . . . . 628

Description . . . . . . . . . . . . . 628BEFORE statement . . . . . . . . . . . 629

Description . . . . . . . . . . . . . 629AFTER statement . . . . . . . . . . . . 631

Description . . . . . . . . . . . . . 632CONCURRENT statement . . . . . . . . . 634

Description . . . . . . . . . . . . . 634ENDGROUP statement . . . . . . . . . . 635

Description . . . . . . . . . . . . . 636

Chapter 31. JES2 control statements 637Description . . . . . . . . . . . . . . 637

Considerations for started tasks . . . . . . 637Considerations for an APPC schedulingenvironment. . . . . . . . . . . . . 637Location in the JCL . . . . . . . . . . 637Internal reader . . . . . . . . . . . . 637

JES2 command statement . . . . . . . . . 637Syntax. . . . . . . . . . . . . . . 638Parameter definition . . . . . . . . . . 638Location in the JCL . . . . . . . . . . 639Examples of the command statement . . . . 639

/*JOBPARM statement . . . . . . . . . . 639Syntax. . . . . . . . . . . . . . . 640Parameter definition . . . . . . . . . . 640Overrides . . . . . . . . . . . . . 644Location in the JCL . . . . . . . . . . 644

Contents xvii

||||||||||||||||||||||||

||||

|||

||

||

Execution node . . . . . . . . . . . . 644Examples of the /*JOBPARM statement . . . 645

/*MESSAGE statement . . . . . . . . . . 645Syntax. . . . . . . . . . . . . . . 645Relationship to the /*ROUTE XEQ statement 645Location in the JCL . . . . . . . . . . 645Example of the /*MESSAGE statement . . . . 646

/*NETACCT statement . . . . . . . . . . 646Syntax. . . . . . . . . . . . . . . 646Parameter definition . . . . . . . . . . 646Defaults . . . . . . . . . . . . . . 646Overrides . . . . . . . . . . . . . 646Location in the JCL . . . . . . . . . . 646Example of the /*NETACCT statement . . . . 646

/*NOTIFY statement . . . . . . . . . . . 647Syntax. . . . . . . . . . . . . . . 647Parameter definition . . . . . . . . . . 647Overrides . . . . . . . . . . . . . 647Location in the JCL . . . . . . . . . . 648Examples of the NOTIFY statement . . . . . 648

/*OUTPUT statement . . . . . . . . . . 648Syntax. . . . . . . . . . . . . . . 649Parameter definition . . . . . . . . . . 650Overrides . . . . . . . . . . . . . 656Relationship to other control statements . . . 656Location in the JCL . . . . . . . . . . 656Example of the /*OUTPUT statement . . . . 656

/*PRIORITY statement . . . . . . . . . . 657Syntax. . . . . . . . . . . . . . . 657Parameter definition . . . . . . . . . . 657Overrides . . . . . . . . . . . . . 657Relationship to other control statements . . . 657Location in the JCL . . . . . . . . . . 657Example of the PRIORITY statement . . . . 658

/*ROUTE statement . . . . . . . . . . . 658Syntax. . . . . . . . . . . . . . . 658Parameter definition . . . . . . . . . . 658Location in the JCL . . . . . . . . . . 660Processing of /*ROUTE statements . . . . . 660Multiple /*ROUTE statements. . . . . . . 660Examples of the ROUTE statement . . . . . 660

/*SETUP statement . . . . . . . . . . . 661Syntax. . . . . . . . . . . . . . . 661Parameter definition . . . . . . . . . . 661Location in the JCL . . . . . . . . . . 662Example of the /*SETUP statement . . . . . 662

/*SIGNOFF statement . . . . . . . . . . 662Syntax. . . . . . . . . . . . . . . 662Location in the JCL . . . . . . . . . . 662Example of the /*SIGNOFF statement . . . . 662

/*SIGNON statement. . . . . . . . . . . 663Syntax. . . . . . . . . . . . . . . 663Parameter definition . . . . . . . . . . 663Location in the JCL . . . . . . . . . . 664Examples of the /*SIGNON statement . . . . 664

/*XEQ statement . . . . . . . . . . . . 665Syntax. . . . . . . . . . . . . . . 665Parameter definition . . . . . . . . . . 665Location in the JCL . . . . . . . . . . 666Multiple /*XEQ statements . . . . . . . . 666Example of the XEQ statement . . . . . . 666

/*XMIT statement . . . . . . . . . . . . 666Syntax. . . . . . . . . . . . . . . 667Parameter definition . . . . . . . . . . 667Defaults . . . . . . . . . . . . . . 668Location in the JCL . . . . . . . . . . 668Examples of the XMIT statement . . . . . . 668

Chapter 32. JES3 control statements 669Description . . . . . . . . . . . . . . 669

Considerations for an APPC schedulingenvironment. . . . . . . . . . . . . 669Considerations for started tasks . . . . . . 669Location in the JCL . . . . . . . . . . 669Internal reader . . . . . . . . . . . . 669Examples of JES3 control statements. . . . . 669JES3 control statement tracking . . . . . . 670

JES3 command statement . . . . . . . . . 670Syntax. . . . . . . . . . . . . . . 671Parameter definition . . . . . . . . . . 671Location in the JCL . . . . . . . . . . 672Examples of the command statement . . . . 672

//*DATASET statement . . . . . . . . . . 672Syntax. . . . . . . . . . . . . . . 673Parameter definition . . . . . . . . . . 673Location in the JCL . . . . . . . . . . 674Example of the //*DATASET statement . . . 674

//*ENDDATASET statement . . . . . . . . 674Syntax. . . . . . . . . . . . . . . 674Location in the JCL . . . . . . . . . . 674Example of the //*ENDDATASET statement 674

//*ENDPROCESS statement . . . . . . . . 675Syntax. . . . . . . . . . . . . . . 675Location in the JCL . . . . . . . . . . 675Example of the //*ENDPROCESS statement 675

//*FORMAT PR statement . . . . . . . . . 675Syntax. . . . . . . . . . . . . . . 676Parameter definition . . . . . . . . . . 677Relationship to sysout DD and OUTPUT JCLstatements . . . . . . . . . . . . . 684Relationship to //*PROCESS statement . . . 684Location in the JCL . . . . . . . . . . 684Examples of the //*FORMAT PR statement . . 684

//*FORMAT PU statement . . . . . . . . . 685Syntax. . . . . . . . . . . . . . . 686Parameter definition . . . . . . . . . . 686Relationship to sysout DD and OUTPUT JCLstatements . . . . . . . . . . . . . 689Relationship to //*PROCESS statement . . . 689Location in the JCL . . . . . . . . . . 689Examples of the //*FORMAT PU statement . . 690

//*MAIN statement . . . . . . . . . . . 690Syntax. . . . . . . . . . . . . . . 691Parameter definition . . . . . . . . . . 692Location in the JCL . . . . . . . . . . 704Examples of the //*MAIN statement . . . . 704

//*NET statement . . . . . . . . . . . . 705JES2 support of //*NET. . . . . . . . . 705Syntax. . . . . . . . . . . . . . . 706Parameter definition . . . . . . . . . . 706Location in the JCL . . . . . . . . . . 709Examples of the //*NET statement . . . . . 709

xviii z/OS MVS JCL Reference

||

//*NETACCT statement. . . . . . . . . . 710Syntax. . . . . . . . . . . . . . . 710Parameter definition . . . . . . . . . . 710Defaults . . . . . . . . . . . . . . 711Location in the JCL . . . . . . . . . . 711Example of the //*NETACCT statement . . . 711

//*OPERATOR statement . . . . . . . . . 711Syntax . . . . . . . . . . . . . . . 711Location in the JCL . . . . . . . . . . 711Example of the //*OPERATOR statement . . . 711

//**PAUSE statement . . . . . . . . . . 711Syntax. . . . . . . . . . . . . . . 712Location in the JCL . . . . . . . . . . 712Example of the //**PAUSE statement . . . . 712

//*PROCESS statement . . . . . . . . . . 712Syntax. . . . . . . . . . . . . . . 712Parameter definition . . . . . . . . . . 713Location in the JCL . . . . . . . . . . 714Examples of the //*PROCESS statement . . . 714

//*ROUTE XEQ statement . . . . . . . . . 715Syntax. . . . . . . . . . . . . . . 715Parameter definition . . . . . . . . . . 715Location in the JCL . . . . . . . . . . 715JOB Statement after //*ROUTE XEQ . . . . 716Example of the //*ROUTE XEQ statement . . 716

/*SIGNOFF statement . . . . . . . . . . 717

Syntax. . . . . . . . . . . . . . . 717Location in the JCL . . . . . . . . . . 717Example of the /*SIGNOFF statement . . . . 717

/*SIGNON statement. . . . . . . . . . . 717Syntax. . . . . . . . . . . . . . . 718Parameter definition . . . . . . . . . . 718Location in the JCL . . . . . . . . . . 719Example of the /*SIGNON statement . . . . 719

JES2 processing of JES3 control statements. . . . 719

Appendix. Accessibility . . . . . . . 721Accessibility features . . . . . . . . . . . 721Consult assistive technologies . . . . . . . . 721Keyboard navigation of the user interface . . . . 721Dotted decimal syntax diagrams . . . . . . . 721

Notices . . . . . . . . . . . . . . 725Terms and conditions for product documentation 727IBM Online Privacy Statement. . . . . . . . 728Policy for unsupported hardware. . . . . . . 728Minimum supported hardware . . . . . . . 728Trademarks . . . . . . . . . . . . . . 729

Index . . . . . . . . . . . . . . . 731

Contents xix

xx z/OS MVS JCL Reference

Figures

1. Operators on IF/THEN/ELSE/ENDIFStatement Construct . . . . . . . . . 391

2. Example //*ROUTE XEQ statement . . . . 717

Copyright IBM Corp. 1988, 2017 xxi

xxii z/OS MVS JCL Reference

Tables

1. MVS Job Control Language (JCL) Statements 12. JES2 Job Entry Control Language (JECL)

Statements . . . . . . . . . . . . . 23. JES3 Job Entry Control Language (JECL)

Statements . . . . . . . . . . . . . 34. Tasks for Entering Jobs . . . . . . . . . 65. Tasks for Processing Jobs . . . . . . . . 86. Tasks for Requesting Data Set Resources . . . 87. Tasks for Requesting Sysout Data Set

Resources . . . . . . . . . . . . . 108. JCL Statement Fields . . . . . . . . . 149. Notation used to show syntax . . . . . . 19

10. Character Sets. . . . . . . . . . . . 2111. Special Characters Used in Syntax . . . . . 2112. Special Characters that Do Not Require

Enclosing Apostrophes . . . . . . . . . 2213. Summary of Rules 2 through 6 for Symbols in

Nested Procedures . . . . . . . . . . 5314. Identification of Statements in Job Log . . . 5915. Positional parameters . . . . . . . . . 8716. Keyword parameters . . . . . . . . . 8817. Summary of Disposition Processing . . . . 173

18. Special Character Sets for the 1403, 3203Model 5, and 3211 Printers . . . . . . . 299

19. Positional parameters . . . . . . . . . 34220. Keyword parameters . . . . . . . . . 34321. Bypassing or Execution of Current Step Based

on COND Parameter . . . . . . . . . 35522. Effect of EVEN and ONLY Subparameters on

Step Execution . . . . . . . . . . . 35623. SYMLIST keyword parameter on the EXPORT

statement . . . . . . . . . . . . . 38424. JOB statement keyword parameters . . . . 41525. Continuation or Termination of the Job Based

on the COND Parameter . . . . . . . . 43126. JOBCLASS attribute for DSENQSHR 43227. Keyword parameters . . . . . . . . . 48228. Keyword parameters . . . . . . . . . 49029. Job- and Step-Level OUTPUT JCL Statements

in the JCL. . . . . . . . . . . . . 49930. Special Character Sets for the 1403, 3203

Model 5, and 3211 Printers . . . . . . . 57631. Keyword parameters . . . . . . . . . 59232. DSPs for JES3 //*PROCESS Statements 713

Copyright IBM Corp. 1988, 2017 xxiii

||

xxiv z/OS MVS JCL Reference

About this document

This document describes the job control tasks needed to enter jobs into the z/OS

operating system, control the system's processing of jobs, and request the resourcesneeded to run jobs. The document also contains a chapter that describes "star