| 1 |
This file explains the features of Regina that are disabled when Regina |
| 2 |
is run in "restricted" mode. |
| 3 |
|
| 4 |
Restricted mode is used in situations where you need to guarantee that |
| 5 |
the author of a Rexx program is unable to affect the user's environment. |
| 6 |
Situations where a restricted mode is applicable include, using Regina as |
| 7 |
a database procedural language, or as language plugin for a Web browser. |
| 8 |
|
| 9 |
Features of Regina that are disabled in restricted mode are: |
| 10 |
- LINEOUT, CHAROUT BIFs |
| 11 |
- POPEN BIF |
| 12 |
- "OPEN WRITE", "OPEN BOTH" subcommands of STREAM BIF |
| 13 |
- The "built-in" environments eg. SYSTEM, CMD or PATH of ADDRESS command |
| 14 |
- Setting the value of a variable in the external environment with |
| 15 |
VALUE BIF. |
| 16 |
- Calling external functions |
| 17 |
- RXFUNCADD BIF |
| 18 |
|
| 19 |
To run Regina in restricted mode, you can start the Regina interpreter |
| 20 |
from the command line with the '-r' switch, or when using the Rexx SAA API, |
| 21 |
"ORing", RESTRICTED_REXX to the CallType parameter of RexxStart() function. |
| 22 |
|