IBM Compiler and Library for REXX on IBM Z Version 1 Release 4 User’s Guide and Reference IBM SH19-8160-06 Note Before using this information and the product it supports, be sure to read the general information under Appendix G, “Notices,” on page 267. Seventh Edition, August 2013 This edition applies to version 1 release 4 of IBM Compiler for REXX on IBM Z (product number 5695-013) and the IBM Library for REXX on IBM Z (product number 5695-014), and to all subsequent releases and modifications until otherwise indicated in new editions. This edition replaces SH19-8160-04. © Copyright International Business Machines Corporation 1991, 2013. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About This Book..................................................................................................xix How to Read the Syntax Notation............................................................................................................. xix How This Book Is Organized..................................................................................................................... xix How to Send Your Comments.................................................................................................................... xx What's New in Release 4..................................................................................... xxi IBM Compiler for REXX on IBM Z..............................................................................................................xxi IBM Library for REXX on IBM Z................................................................................................................ xxii Part 1. Programming Reference Information...........................................................1 Chapter 1. Overview.....................................................................................................................................3 Background information about compilers............................................................................................. 3 The Level of REXX Supported by the Compiler......................................................................................3 Using the Compiler in Program Development........................................................................................3 Background information about error checking................................................................................ 4 Forms and Uses of Output......................................................................................................................4 Porting and Running Compiled REXX Programs.................................................................................... 5 Calling and Linking REXX Programs....................................................................................................... 5 Running above 16 Megabytes in Virtual Storage...................................................................................6 SAA Compliance..................................................................................................................................... 6 Choosing the National Language............................................................................................................6 Alternate Library Overview.....................................................................................................................6 Stream I/O for TSO/E REXX Function Package......................................................................................7 Alias Definitions and Member Names under z/OS.................................................................................7 Chapter 2. Invoking the Compiler................................................................................................................9 Invoking the Compiler under z/OS.........................................................................................................9 Invoking the Compiler with the REXXC (FANC) EXEC...................................................................... 9 Invoking the Compiler with ISPF Panels........................................................................................11 Invoking the Compiler with JCL Statements..................................................................................12 Invoking the Compiler with Cataloged Procedures....................................................................... 13 Invoking the Compiler with the 'REXXCOMP' Command...............................................................13 Standard Data Sets Provided for the Compiler.............................................................................. 13 Invoking the Compiler under z/VM...................................................................................................... 14 Invoking the Compiler with REXXD................................................................................................ 14 Invoking the Compiler with the REXXC EXEC................................................................................ 16 Batch Jobs.......................................................................................................................................17 Chapter 3. Compiler Options and Control Directives................................................................................19 Compiler Options..................................................................................................................................19 ALTERNATE..................................................................................................................................... 19 BASE................................................................................................................................................19 CEXEC..............................................................................................................................................20 COMPILE......................................................................................................................................... 21 CONDENSE......................................................................................................................................21 DDNAMES........................................................................................................................................22 DLINK.............................................................................................................................................. 23 DUMP...............................................................................................................................................24 FLAG................................................................................................................................................ 25 FORMAT...........................................................................................................................................25 iii IEXEC...............................................................................................................................................26 LIBLEVEL.........................................................................................................................................27 LINECOUNT.....................................................................................................................................28 MARGINS........................................................................................................................................ 29 OBJECT........................................................................................................................................... 29 OLDDATE......................................................................................................................................... 31 OPTIMIZE........................................................................................................................................32 PRINT.............................................................................................................................................. 32 SAA..................................................................................................................................................33 SLINE...............................................................................................................................................33 SOURCE...........................................................................................................................................33 TERMINAL.......................................................................................................................................34 TESTHALT........................................................................................................................................34 TRACE..............................................................................................................................................35 XREF................................................................................................................................................ 35 Control Directives.................................................................................................................................36 %COPYRIGHT................................................................................................................................