Contents | Index | < Browse | Browse >
AREXX is supplied with a number of command utilities located in the REXXC directory. These commands can be run from the Shell and are applicable only when the AREXX resident process is active:
HI - usage: HI
Sets the global halt flag, which causes all active ARexx programs to receive and external halt request. Each program will exit immediately unless its HALT interrupt has been enabled. The halt flag does not remain set, but is cleared automatically after all current programs have received the request.
RX - usage: RX name [arguments]
This command launches an ARexx program. If an explicit path isn't given, then the current directory as well as REXX: are searched for a program called "name". The optional argument string is passed to the program.
RX can be launched from either a tool or a project icon. It accepts tooltype arguments using CONSOLE for a window specification and CMD for a command string. If no CMD string is suppplied, the command will attempt to execute the (project) file as an AREXX program. The rx command will also attempt to start Rexx Mast if it's not active. Example:
Icon type: Project
Default Tool: sys:rexxc/rx
Possible tool types:
Console = con:0/0/620/200/Example/Close
CMD = rexxprogram arg1 arg2
RXLIB - usage: RXLIB library-name offset version
Opens a function library so that it can be called from AREXX and can also be used to list the currently-defined functions. The priority argument gives the search priority and must be in the range -100 to 100 inclusive.
The offset argument is the actual integer offset to the library's entry point and should be documented with each library. The version is the required library version and can usually be omitted since the default is to load any version.
RXSET - usage: RXSET [name[[=] value]]
Adds a (name,value) pair to the Clip List. Name strings are assumed to be mixed case. If RXSET is invoked without arguments, it will list all pairs in the Clip List.
Example: code snippet by Christoph Gutjahr - c.gutjahr@gmx.de
-------
Assuming you have the dos command program "requeststring"...
cmdid='req'pragma('id')
address command 'rxset' cmdid '`requeststring "TITLE" "BODY"`'
inputstring=getclip(cmdid)
call setclip(cmdid,'')
RXC - usage: RXC
Closes the resident process as soon as the last AREXX program finishes.
TCC - usage: TCC
Closes the global tracing console as soon as all active programs are no longer using it.
TCO - usage: TCO
Opens the global tracing console. The tracing output from all active programs is diverted automatically to the new console.
TE - usage: TE
Clears the global tracing flag, which forces the tracing mode to OFF for all active ARexx programs.
TS - usage: TS
Starts interactive tracing by setting the external trace flag, which forces all active ARexx programs into interactive tracing mode.
WaitForPort - Usage: WaitForPort [name of port]
A command utility that specifies a port and then waits 10 seconds for the port to appear. A return code of 0 indicates that the port was found; 5 indicates that the application is not currently running or that the port itself does not exist. Port names are case sensitive.