Variable Names

A variable name, the part that represents the value, is always on the left of the assignment statement and the value itself is on the right. In the following example, the variable name is variable1 .
variable1 = 5
SAY variable1
As a result of the preceding assignment statement, the language processor assigns variable1 the value 5 , and the SAY produces:
5
Variable names can consist of:
A–Z
uppercase alphabetic
a–z
lowercase alphabetic
0–9
numbers
? ! . _
special characters
X'41'–X'FE'
double-byte character set (DBCS) characters. (OPTIONS ETMODE must be the first instruction in your program for these characters to be valid in a variable name.)
Restrictions on the variable name are:
  • The first character cannot be 0 through 9 or a period (.)
  • The variable name cannot exceed 250 bytes. For names containing DBCS characters, count each DBCS character as 2 bytes, and count the shift-out (SO) and shift-in (SI) as 1 byte each.
  • SO (X'0E') and SI (X'0F') must delimit DBCS characters within a DBCS name. Also note that:
    • SO and SI cannot be contiguous.
    • Nesting of SO / SI is not permitted.
    • A DBCS name cannot contain a DBCS blank (X'4040').
  • The variable name should not be RC, SIGL, or RESULT, which are REXX special variables. More about special variables appears later in this book.
Examples of acceptable variable names are:
ANSWER ?98B A Word3 number the_ultimate_value

Also, if OPTIONS ETMODE is the first instruction in your program, the following are valid DBCS variable names, where < represents shift-out, > represents shift-in, X , Y , and Z represent DBCS characters, and lowercase letters and numbers represent themselves.

<.X.Y.Z> number_<.X.Y.Z> <.X.Y>1234<.Z>

Variable values

The value of the variable, which is the value the variable name represents, might be categorized as follows:
  • A constant , which is a number that is expressed as:
    • An integer (12)
    • A decimal (12.5)
    • A floating point number (1.25E2)
    • A signed number (-12)
    • A string constant (' 12')
  • A string , which is one or more words that may or may not be within quotation marks, such as:
    This value can be a string.
    'This value is a literal string.'
  • The value from another variable , such as:
    variable1 = variable2

    In the preceding example, variable1 changes to the value of variable2 , but variable2 remains the same.

  • An expression , which is something that needs to be calculated, such as:
    variable2 = 12 + 12 - .6 /* variable2 becomes 23.4 */
Before a variable is assigned a value, its value is the value of its own name translated to uppercase. For example, if the variable new has not been assigned a value, then
SAY new
produces
NEW

Exercises: identifying valid variable names

Which of the following are valid REXX variable names?
  1. 8eight
  2. £25.00
  3. MixedCase
  4. nine_to_five
  5. result
ANSWERS
  1. Incorrect, because the first character is a number.
  2. Incorrect, because the first character is a "£ ".
  3. Valid
  4. Valid
  5. Valid, but it is a special variable name that you should use only to receive results from a subroutine.


varn.html | Timestamp icon Last updated: Monday, 5 June 2017