IBM SC34-5764-01 - Manual (Page 5)

Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
What this book is about . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Who this book is for
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
What you need to know to understand this book . . . . . . . . . . . . . . . . . . . . . xix
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Part 1. User's Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
What is REXX?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Features of REXX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Ease of use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Free format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Convenient built-in functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Debugging capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Interpreted language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Extensive parsing capabilities
. . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Components of REXX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Chapter 2. Writing and Running a REXX Program . . . . . . . . . . . . . . . . . . . . 5
What you need to run a REXX Program? . . . . . . . . . . . . . . . . . . . . . . . . 5
What is a REXX Program?
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Syntax of REXX Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
The Format of REXX Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . 6
The Letter Case of REXX Instructions . . . . . . . . . . . . . . . . . . . . . . . . 6
Types of REXX Clauses
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Programs Using Double-Byte Character Set Names . . . . . . . . . . . . . . . . . . . . 10
Typing in a Program
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Running a Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Interpreting Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
How to Prevent Translation to Uppercase . . . . . . . . . . . . . . . . . . . . . . . 13
Characters within a program . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Characters Input to a program . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Exercises - Running and Modifying the Example Programs . . . . . . . . . . . . . . . . 14
Passing Information to a program . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Getting Information from the Program Stack or Terminal Input Device . . . . . . . . . . . . 14
Specifying Values When Calling a program . . . . . . . . . . . . . . . . . . . . . . 15
Preventing Translation of Input to Uppercase . . . . . . . . . . . . . . . . . . . . . 16
Passing Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Chapter 3. Using Variables and Expressions . . . . . . . . . . . . . . . . . . . . . 19
Program Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Using Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Variable Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Variable Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Using Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Arithmetic Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Comparison Operators
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Logical (Boolean) Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Concatenation Operators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Priority of Operators
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Tracing Expressions with the TRACE Instruction . . . . . . . . . . . . . . . . . . . . . 29
Tracing Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
© Copyright IBM Corp. 1992, 2009 iii