z/OS Version 2 Release 3 TSO/E CLISTs IBM SA32-0978-30 Note Before using this information and the product it supports, read the information in “Notices” on page 171. This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and to all subsequent releases and modifications until otherwise indicated in new editions. Last updated: 2019-02-16 © Copyright International Business Machines Corporation 1988, 2017. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents List of Figures....................................................................................................... ix List of Tables........................................................................................................ xi About this document...........................................................................................xiii Who should use this document.................................................................................................................xiii How this document is organized............................................................................................................... xiii Where to find more information................................................................................................................ xiv How to send your comments to IBM......................................................................xv If you have a technical problem.................................................................................................................xv Summary of changes...........................................................................................xvi Summary of changes for z/OS Version 2 Release 3 (V2R3)..................................................................... xvi Summary of changes for z/OS Version 2 Release 2 (V2R2)..................................................................... xvi z/OS Version 2 Release 1 summary of changes....................................................................................... xvi Chapter 1. Introduction......................................................................................... 1 Features of the CLIST Language..................................................................................................................1 Categories of CLISTs.................................................................................................................................... 1 CLISTs that perform routine tasks......................................................................................................... 1 CLISTs that are structured applications................................................................................................ 2 CLISTs that manage applications written in other languages...............................................................2 Chapter 2. Creating, editing, and executing CLISTs................................................. 3 CLIST data sets and libraries.......................................................................................................................3 Creating and editing CLIST data sets.......................................................................................................... 3 CLIST data set attributes........................................................................................................................4 Considerations for copying CLIST data sets.......................................................................................... 4 Executing CLISTs..........................................................................................................................................4 Passing parameters to CLISTs................................................................................................................5 Allocating CLIST libraries for implicit execution......................................................................................... 6 Specifying alternative CLIST libraries with the ALTLIB command........................................................6 Examples of the ALTLIB command........................................................................................................ 7 Chapter 3. Writing CLISTs - Syntax and conventions............................................... 9 Overview of CLIST statements.................................................................................................................... 9 Syntax rules..................................................................................................................................................9 Delimiters............................................................................................................................................. 10 Continuation symbols...........................................................................................................................10 Capitalization........................................................................................................................................10 Formatting............................................................................................................................................ 10 Length................................................................................................................................................... 10 Labels....................................................................................................................................................10 Comments............................................................................................................................................ 10 Characters supported in CLISTs.......................................................................................................... 11 TSO/E commands and JCL statements.....................................................................................................12 TSO/E commands.................................................................................................................................12 JCL statements.....................................................................................................................................12 Operators and expressions........................................................................................................................12 Order of evaluations............................................................................................................................. 13 Valid numeric ranges............................................................................................................................14 The double-byte character set (DBCS)..................................................................................................... 14 iii DBCS delimiters....................................................................................................................................14 DBCS restrictions................................................................................................................................. 15 Chapter 4. Using symbolic variables.....................................................................17 What is a symbolic variable?..................................................................................................................... 17 Valid names of variables...................................................................................................................... 17 Valid values of variables.......................................................................................................................18 Defining symbolic variables and assigning values to them...................................................................... 18 Using the SET statement......................................................................................................................18 Using the READ statement...................................................................................................................19 Using the PROC statement...................................................................................................................19 Examples.............................................................................................................................................. 21 More advanced uses of variables.............................................................................................................. 22 Combining symbolic variables............................................................................................................. 22 Using a variable to preserve leading spaces in a CLIST...................................................................... 22 Increasing the amount of storage available for variables...................................................................23 Nesting symbolic variables.................................................................................................................. 23 Chapter 5. Using keyword names......................................................................... 25 Using keyword names as variables or labels within a CLIST....................................................................25 Chapter 6. Using control variables........................................................................27 Overview of using control variables.........................................................................................................