res$ = RunRexxScript(script$[, nofile])
script$. Additionally, you can also run ARexx code directly by setting the optional
True. In that case,
script$must not be a path to an ARexx script but must contain the ARexx code to execute. The function will return the result from the ARexx script. The return value will always be a string - even if it contains just a number. If ARexx does not return anything, you will receive an empty string.
You have to start RexxMast prior to using this function. It is, however, not necessary to create a Rexx port in order to use this function. This function works also if your script does not have a Rexx port. The script will always be started with "REXX" being the host port. Thus, if you want to address an other port, you have to use the "ADDRESS" command of ARexx first.
If you use this function to start external ARexx scripts, make sure that the first line of your ARexx script is a comment. Otherwise you will receive a "program not found" error. As a matter of syntax, the first line of all ARexx scripts must be a comment.
script$contains a path to an ARexx script and
script$is ARexx code (defaults to
RunRexxScript("dh0:MyScript.rx")The above code runs the script "dh0:MyScript.rx".
r$ = RunRexxScript("SAY 'Hello'\nRETURN 5\n", True)The above code prints "Hello" to the console and returns 5 to Hollywood. The variable
r$thus will contain "5" after the call.