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 721.

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: July 17, 2017

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 . . . . . . . . . . . 115Syntax . . . . . . . . . . . . . . . 116Subparameter definition . . . . . . . . . 116Overrides. . . . . . . . . . . . . . 116Relationship to other parameters . . . . . . 116Examples of the AVGREC parameter . . . . 116

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

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

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

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

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

CHKPT parameter. . . . . . . . . . . . 126Syntax. . . . . . . . . . . . . . . 126Subparameter definition . . . . . . . . . 126Overrides . . . . . . . . .