Welcome 4

Document Conventions 4

Sources of Additional Information 5

Introducing ARexx - Chapter 1 6

Who is ARexx For? 6

ARexx on the Amiga 6

ARexx Features 7

Getting Started - Chapter 2 8

Starting ARexx 8

To Start ARexx Automatically 8

To Start ARexx Manually 8

About ARexx Programs 9

Running ARexx Programs 9

Program Examples 10

Amiga.rexx 10

Age.rexx 11

Calc.rexx 11

Even.rexx 12

Square.rexx 12

Results.rexx 13

Grades.rexx 13

Elements of ARexx - Chapter 3 15

Tokens 15

Comments 15

Symbols 15

Strings 17

Operators 18

Arithmetic Operators 18

Concatenation Operators 19

Comparison Operators 19

Logical (Boolean) Operators 20

Special Characters 21

(Clauses 21

Null Clauses 22

Label Clauses 22

Assignment Clauses 22

Instruction Clauses 22

Command Clauses 22

Expressions 23

The Command Interface 24

The Host Address 24

Creating a Macro 25

Return Codes 26

Command Shells 27

The Execution Environment 27

The External Environment 27

The Internal Environment 27

Resource Tracking 28

Instructions - Chapter 4 29

Syntax 29

Alphabetical Reference 29

Functions - Chapter 5 44

Invoking a Function 44

Types of Functions 44

Internal Functions 44

Built-In Functions 45

External Function Libraries 45

The Library List 45

External Function Hosts 46

The Search Order 46

The Chip List 47

Built-in Functions - Reference 48

Syntax 48

Alphabetical Reference 48

Example Program 70

REXXSupport.Library Functions 73

Debugging - Chapter 6 78

Tracing 78

Tracing Output 79

Command Inhibition 80

Interactive Tracing 80

Error Processing 81

The External Tracing Flag 81

Interrupts 81

Parsing - Chapter 7 84

Templates 84

Markers 84

Targets 84

Template Objects 85

The Scanning Process 86

Parsing Examples 86

Parsing by Tokenization 86

Parsing by Pattern 87

Parsing by Positional Markers 87

Multiple Templates 88

Chapter 8 - The Workbench ARexx interface 89

ACTIVATEWINDOW command 89

CHANGEWINDOW command 90

DELETE command 91

FAULT command 92

GETATTR command 93

HELP command 99

ICON command 100

INFO command 102

KEYBOARD command 102

LOCKGUI command 104

MENU command 104

MOVEWINDOW command 108

NEWDRAWER command 109

RENAME command 110

RX command 111

SIZEWINDOW command 111

UNLOCKGUI command 112

UNZOOMWINDOW command 113

VIEW command 114

WINDOW command 115

WINDOWTOBACK command 116

WINDOWTOFRONT command 117

ZOOMWINDOW command 118

Error Messages -Appendix A 119

Command Utilities - Appendix B 125

Glossary 127