Abstract for IBM Compiler and Library for REXX on zSeries User's Guide and Reference

How to Read the Syntax Notation

How This Book Is Organized

• How to Send Your Comments

What's New in Release 4

• IBM Compiler for REXX on zSeries
• IBM Library for REXX on zSeries

Programming Reference Information

• Overview
• The Level of REXX Supported by the Compiler
• Using the Compiler in Program Development
• Forms and Uses of Output
• Porting and Running Compiled REXX Programs
• Calling and Linking REXX Programs
• Running above 16 Megabytes in Virtual Storage
• SAA Compliance
• Choosing the National Language
• Alternate Library Overview
• Stream I/O for TSO/E REXX Function Package
• Alias Definitions and Member Names under z/OS
• Invoking the Compiler
• Invoking the Compiler under z/OS
• Invoking the Compiler with the REXXC (FANC) EXEC
• Derived Default Data Set Names
• An Example
• Invoking the Compiler with ISPF Panels
• Invoking the Compiler with JCL Statements
• Invoking the Compiler with Cataloged Procedures
• Invoking the Compiler with the 'REXXCOMP' Command
• Standard Data Sets Provided for the Compiler
• Invoking the Compiler under z/VM
• Invoking the Compiler with REXXD
• An Example
• Setting the Compiler Options
• Invoking the Compiler with the REXXC EXEC
• Batch Jobs
• Compiler Options and Control Directives
• Compiler Options
• ALTERNATE
• BASE
• CEXEC
• COMPILE
• CONDENSE
• DDNAMES
• DLINK
• DUMP
• FLAG
• FORMAT
• IEXEC
• LIBLEVEL
• LINECOUNT
• MARGINS
• OBJECT
• OLDDATE
• OPTIMIZE
• PRINT
• SAA
• SLINE
• SOURCE
• TERMINAL
• TESTHALT
• TRACE
• XREF
• Control Directives
• %COPYRIGHT
• %INCLUDE
• %PAGE
• %STUB
• %SYSDATE
• %SYSTIME
• %TESTHALT
• Runtime Considerations
• Organizing Compiled and Interpretable EXECs under z/OS
• Organizing Compiled and Interpretable EXECs under z/VM
• Organizing Compiled and Interpretable EXECs under VSE/ESA
• Use of the Alternate Library (z/OS, z/VM)
• Other Runtime Considerations
• Understanding the Compiler Listing
• Compilation Summary
• Source Listing
• Messages
• Cross-Reference Listing
• Compilation Statistics
• Examples with Column Numbers
• Example of a Complete Compiler Listing
• Using Object Modules and TEXT Files
• Initial Considerations
• Object Modules (z/OS)
• Invoking a REXX Program as a Command or a Program
• Improving Packaging and Performance
• Building Function Packages
• Writing Parts of Applications in REXX
• REXXL (z/OS)
• TEXT Files (z/VM)
• Object Modules (VSE/ESA)
• REXXPLNK Cataloged Procedure (VSE/ESA)
• REXXLINK Cataloged Procedure (VSE/ESA)
• REXXL Cataloged Procedure (VSE/ESA)
• Linking External Routines to a REXX Program
• Resolving External References--An Example
• Under z/OS
• Under z/VM
• Under VSE/ESA
• Converting CEXEC Output between Operating Systems
• Compiling on One System and Running on Another System
• Converting from z/OS to MVS OpenEdition
• Converting from z/OS to z/VM
• Converting from z/OS to VSE/ESA
• Converting from z/VM to z/OS
• Converting from z/VM to VSE/ESA
• Copying CEXEC Output
• REXXF (FANCMF) under z/OS
• REXXF under z/VM
• REXXV (FANV) under z/OS
• REXXV under z/VM
• Language Differences between the Compiler and the Interpreters
• Differences from the Interpreters on VM/ESA Release 2.1, TSO/E Version 2 Release 4, and REXX/VSE
• Compiler Control Directives
• Halt Condition
• NOVALUE Condition
• OPTIONS Instruction
• PARSE SOURCE Instruction
• PARSE VERSION Instruction
• RANDOM Built-In Function
• SOURCELINE Built-In Function
• Start of Clause
• SYSVAR Function
• TRACE Instruction and TRACE Built-In Function
• TS (Trace Start) and TE (Trace End) Commands
• Differences to Earlier Releases of the Interpreters
• SIGNAL Instruction
• Integer Divide (%) and Remainder (//) Operations
• Exponentiation (**) Operation
• Location of PROCEDURE Instructions
• Binary Strings
• Templates Used by PARSE, ARG, and PULL
• PROCEDURE EXPOSE and DROP
• DO LOOPs
• DBCS Symbols
• VALUE Built-In Function
• Argument Counting
• Options of Built-In Functions
• Built-In Functions
• Options of Instructions
• Strict Comparison Operators
• LINESIZE Built-In Function in Full-Screen CMS
• Enhancement to the EXECCOMM Interface
• Limits and Restrictions
• Implementation Limits
• Technical Restrictions
• z/OS Restrictions
• z/VM restrictions
• VSE/ESA restrictions
• C restriction
• Performance and Programming Considerations
• Performance Considerations
• Optimization, Optimization Stoppers, and Error Checking
• Keeping Track of Variables
• Performing Operations at Compilation Time
• Eliminating Several Evaluations
• Improving Access to Compound Variables
• Optimization Stoppers
• Optimization Limitations
• Arithmetic
• Literal Strings
• Variables
• Compound Variables
• Labels within Loops
• Procedures
• TESTHALT Option
• Frequently Invoked External Routines
• Programming Considerations
• Verifying the Availability of the Library
• VALUE Built-In Function
• Stream I/O
• Determining whether a Program is Interpreted or Compiled
• Creating REXX Programs for Use with the Alternate Library (z/OS, z/VM)
• Limits on Numbers

Customizing the Compiler and Library

• Customizing the IBM Compiler and Library for REXX on z/OS
• Modifying the Cataloged Procedures Supplied by IBM
• Customizing the REXXC EXEC
• Customizing the REXXL EXEC
• Message Repository
• Customizing the IBM Compiler and Library for REXX on z/VM
• Customizing the Compiler Invocation Shells
• Modifying the Function of the Compiler Invocation Shells
• The REXXCOMP Command
• Setting Up Installation Defaults for the Compiler Options
• Customizing the Compiler Invocation Dialog
• Customizing the Library
• Defining the Library as a Physical Segment
• Saving the Physical Segment
• Defining the Library as a Logical Segment
• Selecting the Version of the Library
• Using the EAGCUST EXEC
• Customizing the Message Repository to Avoid a Read/Write A-Disk
• Files Needed to Run Compiled REXX Programs
• Customizing the Library under VSE/ESA

Stream I/O for TSO/E REXX

• How to Read the Syntax Diagrams
• Installing the Function Package
• Preparation
• Assembly, Link-Edit, and Verification
• Installations with Multiple Function Packages
• Usage Considerations
• Understanding the Stream I/O Concept
• The Basic Elements of Stream I/O
• The TSO/E REXX Stream I/O Implementation
• The Stream I/O Functions
• Naming Streams
• Transient and Persistent Streams
• Opening and Closing Streams
• Implicit versus Explicit Opening of Streams
• Opening Streams for Read or Write Operations
• Opening Nonexistent Streams
• Closing Streams
• Stream Formats
• Position Pointer Details
• End-of-Stream Treatment
• Error Treatments
• Stream I/O Processing Errors
• Messages
• Multiple Read Operations
• Stream I/O Functions
• CHARIN (Character Input)
• CHAROUT (Character Output)
• CHARS (Characters Remaining)
• LINEIN (Line Input)
• LINEOUT (Line Output)
• LINES (Lines Remaining)
• STREAM (Operations)

Messages

• Message Format and Return Codes
• Message Format
• Return Codes
• Compilation Messages
• Runtime Messages
• Stream I/O Messages

Appendixes

• Appendix A. Interface for Object Modules (z/OS)
• ISPF Restrictions on Load Modules
• Earlier Releases of ISPF
• ISPF Version 4 Release 1
• ISPF for z/OS Version 1 Release 5.5
• Link-Editing of Object Modules
• DLINK Example
• Stubs
• Stub Names
• Processing Sequence for Stubs
• Parameter List for Invoking IRXEXEC
• In-Storage Control Block
• Parameter Lists
• Registers for Stubs
• CPPL Parameter List
• EFPL Parameter List
• CPPLEFPL
• MVS Parameter List
• CALLCMD Parameter List
• Search Order
• Testing Stubs
• PARSE SOURCE
• Appendix B. Interface for TEXT Files (z/VM)
• The Call from the Assembler Program
• Call Type
• Registers
• Extended PLISTs
• What the REXX Program Gets
• Invocation with a Tokenized PLIST Only
• Invocation with an Extended PLIST or a 6-Word Extended PLIST
• Example of an Assembler Interface to a TEXT File
• Appendix C. Interface for Object Modules (VSE/ESA)
• Stubs
• Processing Sequence for Stubs
• Parameter List for Invoking ARXEXEC
• In-Storage Control Block
• Parameter Lists
• Registers for VSE/ESA Stubs
• VSE Parameter List
• EFPL Parameter List
• PARSE SOURCE
• Appendix D. The z/OS Cataloged Procedures Supplied by IBM
• REXXC (FANCMC)
• REXXCG (FANCMCG)
• REXXCL (FANCMCL)
• REXXCLG (FANCMCLG)
• REXXOEC (FANCMOEC)
• REXXL (EAGL)
• MVS2OE (Only Hardcopy Sample)
• Appendix E. The VSE/ESA Cataloged Procedures Supplied by IBM
• REXXPLNK
• REXXLINK
• REXXL
• Appendix F. Interlanguage Job Samples
• Calling REXX from Assembler
• EAGGJASM for Calling IRXJCL
• EAGGXASM for Calling IRXEXEC
• Calling REXX from C
• EAGGJC for Calling IRXJCL
• EAGGXC for Calling IRXEXEC
• Calling REXX from Cobol
• EAGGJCOB for Calling IRXJCL
• EAGGXCOB for Calling IRXEXEC
• Calling REXX from PL/I
• EAGGJPLI for Calling IRXJCL
• EAGGXPLI for Calling IRXEXEC

Programming Interface Information

Glossary of Terms and Abbreviations

Related Publications

• IBM Compiler and Library for REXX on zSeries Publications
• Other IBM Publications
• ISPF Publications
• Learning REXX
• REXX Reference
• TSO/E and MVS/ESA Publications
• OpenEdition Publication
• VM/SP Publications
• VM/XA SP Publications
• VM/ESA Publications
• VSE/ESA Publication
• C Publication
• CMS Publications
• z/VM Publications
• z/OS Publications
• OS/390 Publications

Index