OS/390 IBM
MVS JCL Reference
GC28-1757-09
OS/390 IBM
MVS JCL Reference
GC28-1757-09
Note
Before using this information and the product it supports, be sure to read the general information under Appendix A, “Notices” on page A-1.
Tenth Edition, September 2000
This is a major revision of GC28-1757-08.
This edition applies to Version 2 Release 10 of OS/390 (5647-A01) and to all subsequent releases and modifications until otherwise indicated in new editions.
Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address below.
IBM welcomes your comments. A form for readers' comments may be provided at the back of this publication, or you may address your comments to the following address: International Business Machines Corporation Department 55JA, Mail Station P384 2455 South Road Poughkeepsie, NY 12601-5400 United States of America
FAX (United States & Canada): 1+845+432-9405 FAX (Other Countries): Your International Access Code +1+845+432-9405
IBMLink (United States customers only): IBMUSM10(MHVRCFS) Internet e-mail: mhvrcfs@us.ibm.com World Wide Web: http://www.ibm.com/s390/os390/webqs.html
If you would like a reply, be sure to include your name, address, telephone number, or FAX number.
Make sure to include the following in your comment or note: Title and order number of this book Page number or topic related to your comment
When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.
Copyright International Business Machines Corporation 1988, 2000. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents
About This Book ...... xi Who Should Use This Book ...... xi Related Information ...... xi Programs ...... xi Hardware ...... xii
Summary of Changes ...... xiii
Chapter 1. Job Control Statements ...... 1-1 JCL Statements ...... 1-1 JECL Statements ...... 1-2
Chapter 2. Job Control Tasks ...... 2-1 Entering Jobs ...... 2-1 Processing Jobs ...... 2-2 Requesting Resources ...... 2-2 Task Charts ...... 2-2
Chapter 3. Format of Statements ...... 3-1 JCL Statement Fields ...... 3-1 JES2 Control Statement Fields ...... 3-4 JES3 Control Statement Fields ...... 3-4 Continuing Statements ...... 3-5
Chapter 4. Syntax of Parameters ...... 4-1 Notation Used to Show Syntax ...... 4-1 Character Sets ...... 4-3 Syntax Notes ...... 4-5 Backward References ...... 4-5
Chapter 5. Procedures and Symbols ...... 5-1 Cataloged and In-Stream Procedures ...... 5-1 Modifying Procedures ...... 5-3 Nested Procedures ...... 5-10 Using System Symbols and JCL Symbols ...... 5-13
Chapter 6. Job Control Statements on the Output Listing ...... 6-1
Chapter 7. Started Tasks ...... 7-1 Determining Whether to Use a Started Task ...... 7-1 Determining the Source JCL for the Started Task ...... 7-1 Determining System Services for a Started Task ...... 7-5 Coding the JCL ...... 7-8 Naming a Started Task (Source JCL is a Job) ...... 7-12 Setting Up Operator Education for Your Started Task ...... 7-13
Chapter 8. JCL Command Statement ...... 8-1 Description ...... 8-1
Chapter 9. COMMAND Statement ...... 9-1
Copyright IBM Corp. 1988, 2000 iii
Description ...... 9-1
Chapter 10. Comment Statement ...... 10-1 Description ...... 10-1
Chapter 11. CNTL Statement ...... 11-1 Description ...... 11-1
Chapter 12. DD Statement ...... 12-1 Description ...... 12-1 * Parameter ...... 12-16 ACCODE Parameter ...... 12-19 AMP Parameter ...... 12-21 AVGREC Parameter ...... 12-29 BLKSIZE Parameter ...... 12-30 | BLKSZLIM Parameter ...... 12-32 BURST Parameter ...... 12-33 CCSID Parameter ...... 12-34 CHARS Parameter ...... 12-37 CHKPT Parameter ...... 12-39 CNTL Parameter ...... 12-41 COPIES Parameter ...... 12-42 DATA Parameter ...... 12-45 DATACLAS Parameter ...... 12-48 DCB Parameter ...... 12-51 DDNAME Parameter ...... 12-70 DEST Parameter ...... 12-76 DISP Parameter ...... 12-80 DLM Parameter ...... 12-92 DSID Parameter ...... 12-94 DSNAME Parameter ...... 12-95 DSNTYPE Parameter ...... 12-104 DUMMY Parameter ...... 12-107 DYNAM Parameter ...... 12-110 EXPDT Parameter ...... 12-111 FCB Parameter ...... 12-113 FILEDATA Parameter ...... 12-116 FLASH Parameter ...... 12-117 FREE Parameter ...... 12-119 HOLD Parameter ...... 12-122 KEYLEN Parameter ...... 12-125 KEYOFF Parameter ...... 12-126 LABEL Parameter ...... 12-127 LGSTREAM Parameter ...... 12-134 LIKE Parameter ...... 12-135 LRECL Parameter ...... 12-137 MGMTCLAS Parameter ...... 12-139 MODIFY Parameter ...... 12-141 OUTLIM Parameter ...... 12-142 OUTPUT Parameter ...... 12-144 PATH Parameter ...... 12-148 PATHDISP Parameter ...... 12-151 PATHMODE Parameter ...... 12-153 PATHOPTS Parameter ...... 12-156
iv OS/390 V2R10.0 MVS JCL Reference
PROTECT Parameter ...... 12-160 QNAME Parameter ...... 12-163 RECFM Parameter ...... 12-164 RECORG Parameter ...... 12-167 REFDD Parameter ...... 12-169 RETPD Parameter ...... 12-171 RLS Parameter ...... 12-173 SECMODEL Parameter ...... 12-174 SEGMENT Parameter ...... 12-176 SPACE Parameter ...... 12-177 SPIN Parameter ...... 12-186 STORCLAS Parameter ...... 12-188 SUBSYS Parameter ...... 12-190 SYSOUT Parameter ...... 12-192 TERM Parameter ...... 12-198 UCS Parameter ...... 12-199 UNIT Parameter ...... 12-202 VOLUME Parameter ...... 12-209
Chapter 13. Special DD Statements ...... 13-1 Description ...... 13-1 JOBCAT DD Statement ...... 13-1 JOBLIB DD Statement ...... 13-2 STEPCAT DD Statement ...... 13-6 STEPLIB DD Statement ...... 13-7 SYSABEND, SYSMDUMP, and SYSUDUMP DD Statements ...... 13-11 SYSCHK DD Statement ...... 13-14 SYSCKEOV DD Statement ...... 13-17 SYSIN DD Statement ...... 13-18
Chapter 14. Delimiter Statement ...... 14-1 Description ...... 14-1
Chapter 15. ENDCNTL Statement ...... 15-1 Description ...... 15-1
Chapter 16. EXEC Statement ...... 16-1 Description ...... 16-1 ACCT Parameter ...... 16-5 ADDRSPC Parameter ...... 16-7 CCSID Parameter ...... 16-8 COND Parameter ...... 16-9 DYNAMNBR Parameter ...... 16-17 PARM Parameter ...... 16-18 PERFORM Parameter ...... 16-20 PGM Parameter ...... 16-22 PROC and Procedure Name Parameters ...... 16-23 RD Parameter ...... 16-24 REGION Parameter ...... 16-28 TIME Parameter ...... 16-30
Chapter 17. IF/THEN/ELSE/ENDIF Statement Construct ...... 17-1 Description ...... 17-1
Contents v
Chapter 18. INCLUDE Statement ...... 18-1 Description ...... 18-1
Chapter 19. JCLLIB Statement ...... 19-1 Description ...... 19-1
Chapter 20. JOB Statement ...... 20-1 Description ...... 20-1 Accounting Information Parameter ...... 20-6 ADDRSPC Parameter ...... 20-9 BYTES Parameter ...... 20-10 CARDS Parameter ...... 20-12 CCSID Parameter ...... 20-14 CLASS Parameter ...... 20-16 COND Parameter ...... 20-17 GROUP Parameter ...... 20-19 LINES Parameter ...... 20-20 MSGCLASS Parameter ...... 20-22 MSGLEVEL Parameter ...... 20-24 NOTIFY Parameter ...... 20-26 PAGES Parameter ...... 20-28 PASSWORD Parameter ...... 20-30 PERFORM Parameter ...... 20-31 Programmer’s Name Parameter ...... 20-33 PRTY Parameter ...... 20-35 RD Parameter ...... 20-36 REGION Parameter ...... 20-39 RESTART Parameter ...... 20-41 SECLABEL Parameter ...... 20-44 SCHENV Parameter ...... 20-45 TIME Parameter ...... 20-46 TYPRUN Parameter ...... 20-49 USER Parameter ...... 20-51
Chapter 21. Null Statement ...... 21-1 Description ...... 21-1
Chapter 22. OUTPUT JCL Statement ...... 22-1 Description ...... 22-1 ADDRESS Parameter ...... 22-11 BUILDING Parameter ...... 22-13 BURST Parameter ...... 22-15 CHARS Parameter ...... 22-16 CKPTLINE Parameter ...... 22-18 CKPTPAGE Parameter ...... 22-18 CKPTSEC Parameter ...... 22-19 CLASS Parameter ...... 22-20 COLORMAP Parameter ...... 22-23 COMPACT Parameter ...... 22-23 COMSETUP Parameter ...... 22-24 CONTROL Parameter ...... 22-24 COPIES Parameter ...... 22-25 DATACK Parameter ...... 22-28 DEFAULT Parameter ...... 22-29 vi OS/390 V2R10.0 MVS JCL Reference
DEPT Parameter ...... 22-31 DEST Parameter ...... 22-33 DPAGELBL Parameter ...... 22-36 DUPLEX Parameter ...... 22-38 FCB Parameter ...... 22-38 FLASH Parameter ...... 22-40 FORMDEF Parameter ...... 22-42 FORMLEN Parameter ...... 22-43 FORMS Parameter ...... 22-44 FSSDATA Parameter ...... 22-45 GROUPID Parameter ...... 22-48 INDEX Parameter ...... 22-50 INTRAY Parameter ...... 22-50 JESDS Parameter ...... 22-51 LINDEX Parameter ...... 22-53 LINECT Parameter ...... 22-54 MODIFY Parameter ...... 22-55 NAME Parameter ...... 22-56 NOTIFY Parameter ...... 22-58 OFFSETXB Parameter ...... 22-59 OFFSETXF Parameter ...... 22-60 OFFSETYB Parameter ...... 22-60 OFFSETYF Parameter ...... 22-60 OUTBIN Parameter ...... 22-60 OUTDISP Parameter ...... 22-61 OVERLAYB Parameter ...... 22-64 OVERLAYF Parameter ...... 22-64 OVFL Parameter ...... 22-64 PAGEDEF Parameter ...... 22-65 PIMSG Parameter ...... 22-67 RETAINS | RETAINF Parameter ...... 22-74 RETRYL | RETRYT Parameter ...... 22-76 ROOM Parameter ...... 22-77 SYSAREA Parameter ...... 22-78 THRESHLD Parameter ...... 22-80 TITLE Parameter ...... 22-81 TRC Parameter ...... 22-82 UCS Parameter ...... 22-83 USERDATA Parameter ...... 22-85 USERLIB Parameter ...... 22-89 WRITER Parameter ...... 22-91
Chapter 23. PEND Statement ...... 23-1 Description ...... 23-1
Chapter 24. PROC Statement ...... 24-1 Description ...... 24-1
Chapter 25. SET Statement ...... 25-1 Description ...... 25-1
Chapter 26. XMIT JCL Statement ...... 26-1 Description ...... 26-2 DEST Parameter ...... 26-4
Contents vii
DLM Parameter ...... 26-5 SUBCHARS Parameter ...... 26-6
Chapter 27. JES2 Control Statements ...... 27-1 Description ...... 27-1 JES2 Command Statement ...... 27-2 /*JOBPARM Statement ...... 27-3 /*MESSAGE Statement ...... 27-9 /*NETACCT Statement ...... 27-10 /*NOTIFY Statement ...... 27-11 /*OUTPUT Statement ...... 27-12 /*PRIORITY Statement ...... 27-21 /*ROUTE Statement ...... 27-22 /*SETUP Statement ...... 27-25 /*SIGNOFF Statement ...... 27-26 /*SIGNON Statement ...... 27-27 /*XEQ Statement ...... 27-29 /*XMIT Statement ...... 27-30
Chapter 28. JES3 Control Statements ...... 28-1 Description ...... 28-1 JES3 Command Statement ...... 28-2 //*DATASET Statement ...... 28-4 //*ENDDATASET Statement ...... 28-6 //*ENDPROCESS Statement ...... 28-7 //*FORMAT PR Statement ...... 28-7 //*FORMAT PU Statement ...... 28-17 //*MAIN Statement ...... 28-22 //*NET Statement ...... 28-38 //*NETACCT Statement ...... 28-42 //*OPERATOR Statement ...... 28-44 //**PAUSE Statement ...... 28-44 //*PROCESS Statement ...... 28-45 //*ROUTE XEQ Statement ...... 28-48 /*SIGNOFF Statement ...... 28-50 /*SIGNON Statement ...... 28-51
Appendix A. Notices ...... A-1 Trademarks ...... A-2
Index ...... X-1
viii OS/390 V2R10.0 MVS JCL Reference
Figures
1-1. MVS Job Control Language (JCL) Statements ...... 1-1 1-2. Job Entry Control Language (JECL) Statements ...... 1-2 2-1. Tasks for Entering Jobs ...... 2-3 2-2. Tasks for Processing Jobs ...... 2-5 2-3. Tasks for Requesting Data Set Resources ...... 2-6 2-4. Tasks for Requesting Sysout Data Set Resources ...... 2-8 3-1. JCL Statement Fields ...... 3-2 4-1. Notation Used to Show Syntax ...... 4-1 4-2. Character Sets ...... 4-3 4-3. Special Characters Used in Syntax ...... 4-3 4-4. Special Characters that Do Not Require Enclosing Apostrophes ... 4-4 5-1. Summary of Rules 2 - 6 for Symbols in Nested Procedures ..... 5-29 6-1. Identification of Statements in Job Log ...... 6-2 12-1. Summary of Disposition Processing ...... 12-89 12-2. Special Character Sets for the 1403, 3203 Model 5, and 3211 Printers ...... 12-201 16-1. Execution or Bypassing of Current Step Based on COND Parameter ...... 16-15 16-2. Effect of EVEN and ONLY Subparameters on Step Execution .. 16-15 17-1. Operators on IF/THEN/ELSE/ENDIF Statement Construct ...... 17-3 20-1. Continuation or Termination of the Job Based on the COND Parameter ...... 20-19 22-1. Job- and Step-Level OUTPUT JCL Statements in the JCL .... 22-10 22-2. Special Character Sets for the 1403, 3203 Model 5, and 3211 Printers ...... 22-84 28-1. DSPs for JES3 //*PROCESS Statements ...... 28-46
Copyright IBM Corp. 1988, 2000 ix
x OS/390 V2R10.0 MVS JCL Reference
About This Book
This book describes the job control tasks needed to enter jobs into the OS/390 operating system, control the system's processing of jobs, and request the resources needed to run jobs. The book also contains a chapter that describes "started tasks" and how to set them up. To perform job control or started tasks, programmers code "job control statements." This book describes how to code these statements, which include: Job control language (JCL) statements Job entry control language (JECL) statements, which encompass: Job entry subsystem 2 (JES2) control statements Job entry subsystem 3 (JES3) control statements
This book is designed as a reference book, to be used while coding the statements. It contains some introductory material. Full explanations of the job control tasks are presented in a companion book, OS/390 MVS JCL User's Guide, GC28-1758.
Who Should Use This Book This book is needed by system and application programmers who enter programs into the operating system. Those using this book should understand the concepts of job management and data management.
Related Information To have complete JCL information, you need the following book: OS/390 MVS JCL User's Guide, GC28-1758
Where necessary, this book references information in other books, using shortened versions of the book title. For complete titles and order numbers of the books for all products that are part of OS/390, see OS/390 Information Roadmap, GC28-1727. The following tables list the short titles, titles, and order numbers for books related to non-OS/390 products that this book references.
Programs
Short Title Used in This Book Title Order Number ACF/TCAM Installation Reference Advanced Communications Function for TCAM, SC30-3133 Version 2 Installation Reference PSF/MVS System Programming Guide PSF/MVS System Programming Guide SH35-0091 PSF/MVS Application Programming Guide PSF/MVS Application Programming Guide S544-3084
Copyright IBM Corp. 1988, 2000 xi
Hardware
Short Title Used in This Book Title Order Number 2821 Component Description IBM 2821 Control Unit Component Description GA24-3312 3540 Programmer's Reference OS/VS2 IBM 3540 Programmer's Reference GC24-5111 3800 Programmer's Guide IBM 3800 Printing Subsystem Programmer's Guide GC26-3846 Forms Design Reference Guide for the 3800 Forms Design Reference Guide for the IBM 3800 GA26-1633 Printing Subsystem
xii OS/390 V2R10.0 MVS JCL Reference
Summary of Changes
| Summary of Changes | for GC28-1757-09 | OS/390 Version 2 Release 10
| The book contains information previously presented in GC28-1757-08, which | supports OS/390 Version 2 Release 9.
| New Information
| The BLKSZLIM parameter is added to the DD statement.
| Changed Information
| The BLKSIZE parameter on the DD statement is updated.
| This book includes terminology, maintenance, and editorial changes. Technical | changes or additions to the text and illustrations are indicated by a vertical line to | the left of the change.
Summary of Changes for GC28-1757-08 OS/390 Version 2 Release 9
The book contains information previously presented in GC28-1757-07, which supports OS/390 Version 2 Release 8.
This book includes terminology, maintenance, and editorial changes. Technical changes or additions to the text and illustrations are indicated by a vertical line to the left of the change.
Summary of Changes for GC28-1757-06 OS/390 Version 2 Release 7
The book contains information previously presented in GC28-1757-05 which supports OS/390 Version 2 Release 6.
New Information
The CCSID (coded character set identifier) parameter is added to the JOB, EXEC, and DD statements.
Changed Information
The description of the ACCODE (accessibility code) parameter of the DD statement is updated.
This book includes terminology, maintenance, and editorial changes. Technical changes or additions to the text and illustrations are indicated by a vertical line to the left of the change.
Copyright IBM Corp. 1988, 2000 xiii
Summary of Changes for GC28-1757-05 OS/390 Version 2 Release 6
The book contains information previously presented in GC28-1757-04, which supports OS/390 Version 2 Release 5.
Changed Information The SCHENV parameter on the JOB statement, which allows you to specify the name of a WLM scheduling environment, can now be used for JES3 jobs. As part of the name change of OpenEdition to OS/390 UNIX System Services, occurrences of OS/390 OpenEdition have been changed to OS/390 UNIX System Services or its abbreviated name, OS/390 UNIX. OpenEdition may continue to appear in messages, panel text, and other code with OS/390 UNIX System Services.
This book includes terminology, maintenance, and editorial changes. Technical changes or additions to the text and illustrations are indicated by a vertical line to the left of the change.
Summary of Changes for GC28-1757-04 OS/390 Version 2 Release 5
The book contains information previously presented in GC28-1757-03, which supports OS/390 Version 2 Release 4.
New Information New parameters have been added for the Print Services Facility.
This book includes terminology, maintenance, and editorial changes. Technical changes or additions to the text and illustrations are indicated by a vertical line to the left of the change.
Summary of Changes for GC28-1757-03 OS/390 Version 2 Release 4
The book contains information previously presented in GC28-1757-02, which supports OS/390 Version 1 Release 3.
New Information A new JOB statement parameter, SCHENV, is described. Currently valid only for JES2 jobs, it allows you to specify the name of a WLM scheduling environment.
This book includes terminology, maintenance, and editorial changes. Technical changes or additions to the text and illustrations are indicated by a vertical line to the left of the change.
Summary of Changes for GC28-1757-02 OS/390 Version 1 Release 3 xiv OS/390 V2R10.0 MVS JCL Reference
The book contains information previously presented in GC28-1757-01, which supports OS/390 Version 1 Release 2.
This book includes terminology, maintenance, and editorial changes. Technical changes or additions to the text and illustrations are indicated by a vertical line to the left of the change.
Summary of Changes for GC28-1757-01 OS/390 Release 2
This book contains information previously presented in OS/390 MVS JCL Reference GC28-1757-00, which supports OS/390 Release 1.
The following summarizes the changes to that information.
Changed Information The date field on the DEADLINE= parameter of the JES3 //*MAIN statement is expanded to allow a 4-digit-year (yyyy), which is required to support dates beyond 31 December 1999.
This book includes terminology, maintenance, and editorial changes. Technical changes or additions to the text and illustrations are indicated by a vertical line to the left of the change.
Summary of Changes for GC28-1757-00 OS/390 Release 1
This book contains information previously presented in MVS/ESA JCL Reference GC28-1479, which supports MVS/ESA System Product Version 5.
This book includes terminology, maintenance, and editorial changes. Technical changes or additions to the text and illustrations are indicated by a vertical line to the left of the change.
Summary of Changes xv
xvi OS/390 V2R10.0 MVS JCL Reference Statements
Chapter 1. Job Control Statements
This chapter lists, in Figure 1-1, all but one of the statements in the MVS Job Control Language (JCL), and in Figure 1-2 on page 1-2, all of the Job Entry Control Language (JECL) statements for the JES2 and JES3 subsystems, together with the purpose of each statement. Later chapters describe each statement in detail. (The PRINTDEV JCL statement, for use by the person starting the Print Services Facility, is documented in the manual PSF for OS/390: Customization.)
JCL Statements
Figure 1-1 (Page 1 of 2). MVS Job Control Language (JCL) Statements Statement Name Purpose // command JCL command Enters an MVS system operator command through the input stream. The command statement is used primarily by the operator. Use the COMMAND statement instead of the JCL command statement. // COMMAND command Specifies an MVS or JES command that the system issues when the JCL is converted. Use the COMMAND statement instead of the JCL command statement. //* comment comment Contains comments. The comment statement is used primarily to document a program and its resource requirements. // CNTL control Marks the beginning of one or more program control statements. // DD data definition Identifies and describes a data set. /* delimiter Indicates the end of data placed in the input stream. Note: A user can designate any two characters to be the delimiter. // ENDCNTL end control Marks the end of one or more program control statements. // EXEC execute Marks the beginning of a job step; assigns a name to the step; identifies the program or the cataloged or in-stream procedure to be executed in this step. // IF/THEN/ELSE/ENDIF IF/THEN/ELSE/ENDIF Specifies conditional execution of job steps statement construct within a job. // INCLUDE include Identifies a member of a partitioned data set (PDS) or partitioned data set extended (PDSE) that contains JCL statements to include in the job stream. // JCLLIB JCL library Identifies the libraries that the system will search for: INCLUDE groups Procedures named in EXEC statements. // JOB job Marks the beginning of a job; assigns a name to the job. // null Marks the end of a job.
Copyright IBM Corp. 1988, 2000 1-1 Statements
Figure 1-1 (Page 2 of 2). MVS Job Control Language (JCL) Statements Statement Name Purpose // OUTPUT output JCL Specifies the processing options that the job entry subsystem is to use for printing a sysout data set. // PEND procedure end Marks the end of an in-stream or cataloged procedure. // PROC procedure Marks the beginning of an in-stream procedure and may mark the beginning of a cataloged procedure; assigns default values to parameters defined in the procedure. // SET set Defines and assigns initial values to symbolic parameters used when processing JCL statements. Changes or nullifies the values assigned to symbolic parameters. // XMIT transmit Transmits input stream records from one node to another. Note: The XMIT JCL statement is supported only on JES3 systems.
JECL Statements
Figure 1-2 (Page 1 of 2). Job Entry Control Language (JECL) Statements Statement Purpose Job Entry Subsystem 2 (JES2) Control Statements /*$command Enters JES2 operator commands through the input stream. /*JOBPARM Specifies certain job-related parameters at input time. /*MESSAGE Sends messages to the operator via the operator console. /*NETACCT Specifies an account number for a network job. /*NOTIFY Specifies the destination of notification messages. /*OUTPUT Specifies processing options for sysout data set(s). /*PRIORITY Assigns a job queue selection priority. /*ROUTE Specifies the output destination or the execution node for the job. /*SETUP Requests mounting of volumes needed for the job. /*SIGNOFF Ends a remote job stream processing session. /*SIGNON Begins a remote job stream processing session. /*XEQ Specifies the execution node for a job. /*XMIT Indicates a job or data stream to be transmitted to another JES2 node or eligible non-JES2 node. Job Entry Subsystem 3 (JES3) Control Statements //**command Enters JES3 operator commands, except *DUMP and *RETURN, through the input stream. //*DATASET Begins an input data set in the input stream. //*ENDDATASET Ends the input data set that began with a //*dataset statement. //*ENDPROCESS Ends a series of //*PROCESS statements. //*FORMAT Specifies the processing options for a sysout or JES3-managed print or punch data set. //*MAIN Defines selected processing parameters for a job.
1-2 OS/390 V2R10.0 MVS JCL Reference Statements
Figure 1-2 (Page 2 of 2). Job Entry Control Language (JECL) Statements Statement Purpose //*NET Identifies relationships between predecessor and successor jobs in a dependent job control net. //*NETACCT Specifies an account number for a network job. //*OPERATOR Sends messages to the operator. //*PAUSE Halts the input reader. //*PROCESS Identifies a nonstandard job. //*ROUTE Specifies the execution node for the job. /*SIGNOFF Ends a remote job stream processing session. /*SIGNON Begins a remote job stream processing session.
Chapter 1. Job Control Statements 1-3 Statements
1-4 OS/390 V2R10.0 MVS JCL Reference Tasks
Chapter 2. Job Control Tasks
For your program to execute on the computer and perform the work you designed it to do, your program must be processed by your operating system.
Your operating system consists of an MVS/SP base control program (BCP) with a job entry subsystem (JES2 or JES3) and DFSMS/MVS DFSMSdfp installed with it.
For the operating system to process a program, programmers must perform certain job control tasks. These tasks are performed through the job control statements, which consist of: JCL statements JES2 control statements JES3 control statements
Entering Jobs Job Steps
You enter a program into the operating system as a job step. A job step consists of the job control statements that request and control execution of a program and request the resources needed to run the program. A job step is identified by an EXEC statement. The job step can also contain data needed by the program. The operating system distinguishes job control statements from data by the contents of the records.
Jobs
A job is a collection of related job steps. A job is identified by a JOB statement.
Input Streams
Jobs placed in a series and entered through one input device form an input stream. The operating system reads an input stream into the computer from an input/output (I/O) device or an internal reader. The input device can be a card reader, a magnetic tape device, a terminal, or a direct access device. An internal reader is a buffer that is read from a program into the system as though it were an input stream.
Cataloged and In-Stream Procedures
You often use the same set of job control statements repeatedly with little or no change, for example, to compile, assemble, link-edit, and execute a program. To save time and prevent errors, you can prepare sets of job control statements and place, or catalog, them in a partitioned data set (PDS) or partitioned data set extended (PDSE) known as a procedure library. The data set attributes of a procedure library should match SYS1.PROCLIB (record length of 80 and record format of FB). Such a set of job control statements in the system procedure library, SYS1.PROCLIB (or an installation-defined procedure library), is called a cataloged procedure.
Copyright IBM Corp. 1988, 2000 2-1 Tasks
To test a procedure before placing it in the catalog, place it in an input stream and execute it; a procedure in an input stream is called an in-stream procedure. The maximum number of in-stream procedures you can code in any job is 15.
Steps in a Job
A job can be simple or complex; it can consist of one step or of many steps that call many in-stream and cataloged procedures. A job can consist of up to 255 job steps, including all steps in any procedures that the job calls. Specification of a greater number of steps produces a JCL error.
Processing Jobs The operating system performs many job control tasks automatically. You can influence the way your job is processed by the JCL and JES2 or JES3 parameters you code. For example, the job entry subsystem selects jobs for execution, but you can speed up or delay selection of your job by the parameters you code.
Requesting Resources Data Set Resources
To execute a program, you must request the data sets needed to supply data to the program and to receive output records from the program.
Sysout Data Set Resources
A sysout data set is a system-handled output data set. This data set is placed temporarily on direct access storage. Later, at the convenience of the system, the system prints it, punches it, or sends it to a specified location. Because sysout data sets are processed by the system, the programmer can specify many parameters to control that processing.
Task Charts The following charts list the job control tasks, which are described in the OS/390 MVS JCL User's Guide, in four groups: Entering jobs in Figure 2-1 on page 2-3 Processing jobs in Figure 2-2 on page 2-5 Requesting data set resources in Figure 2-3 on page 2-6 Requesting sysout data set resources in Figure 2-4 on page 2-8
For each task, the charts list the parameters and statements that can be used to perform it. In many cases, the same task can be performed using different parameters on different statements. Where a parameter can appear on both a JOB and EXEC statement, it applies to the entire job when coded on the JOB statement but only to a step when coded on an EXEC statement.
The system is designed to enable users to perform many types of job control in many ways. To allow this flexibility, only two job entry tasks are required: Identification: The job must be identified in the jobname field of a JOB statement.
2-2 OS/390 V2R10.0 MVS JCL Reference Tasks