cules is built with support for both Regina and ooRexx and cannot be used in a
single Rexx environment.

DISABLE can be abbreviated as ‘DIS’.

STOP

This is the same as DISABLE. STOP can be abbreviated as ‘STO’.

REGINA

Given as argument to the ‘START’ or ‘ENABLE’ options, REGINA specifies that the
Regina Rexx environment has to be started.

OOREXX

Given as argument to the ‘START’ or ‘ENABLE’ option, OOREXX specifies that the
Open Object Rexx (ooRexx) environment has to be started.

PATHS

This is the keyword for specifying the search path(s) for the Rexx scripts. PATHS
can be abbreviated as ‘PATH’.

REXXPATHS

This is the same as PATHS. REXXPATHS can be abbreviated as ‘REXXP’.

path

A path (or a list of paths, separated by a delimiter) in which Rexx executables will
be searched. If the path is not specified when activating the Rexx environment then
the default used is the current path taken from the environment variable ‘PATH’.

SYSPATH

Keyword for specifying, if the search for the Rexx executables should be extended
to the system paths (when set to on ‘ON’) or if it should be limited to the defined
PATHS / REXXPATHS (when set to ‘OFF’).

SYSPATH is set to “ON” if not overwritten through the REXX system parameter in
the configuration file or changed later on with the REXX console command.

EXTENSIONS

This is the keyword for specifying the filename extension(s) to be used to search
the Rexx executables. EXTENSIONS can be abbreviated as ‘EXT’.

If a given script name is in the format filename.extension then it is used as is with-
out any further processing.

SUFFIXES

This is the same as EXTENSIONS. SUFFIXES can be abbreviated as ‘SUF’.

suffix

A filename extension (or a list of filename extensions, separated by a delimiter) that
identifies a Rexx executable. A filename extension must be specified in the format
“. ext”.

If there are no extensions specified the defaults used are ‘.REXX’, ‘.rexx’, ‘.REX’,
‘ .rex’ , ‘.CMD’, ‘.cmd’, ‘.RX’ and ‘.rx’.

delimiter

This is the delimiter used for separating multiple paths or multiple extensions. For
Linux and Mac OS-X systems this is the colon (“:”), for Windows systems it is the
semicolon (“;”).

RESOLVER

Keyword to define who will resolve the script name.

When set to “ON” then the Hercules Rexx interface will resolve the script name and
issue appropriate messages in case the process fails. When set to ‘OFF’ then the
script name will be passed as is to the Rexx interpreter.

RESOLVER is set to ‘ON’ if not overwritten through the REXX system parameter in
the configuration file or changed later on with the REXX console command.

MSGLEVEL

This is the keyword for specifying the message level to be used. MSGLEVEL can

be abbreviated as ‘MSGL’.

0

Disables the display of the HHC17503I and HHC17504I messages. This is the de-
fault, if not explicitely set through the MSGLEVEL parameter.

1

Enables the display of the HHC17503I and HHC17504I messages when a script
has finished:

HHC17503I REXX(package name) Exec/Script 'script name' RetRC(0)
HHC17504I REXX(package name) Exec/Script 'script name' RetValue'0'

MSGPREFIX

This is the keyword used to set the prefix for standard messages (issued through
‘say’). MSGPREFIX can be abbreviated as ‘MSGP’. There is no message prefix
set, unless exlicitely specified with the MSGPREFIX parameter.

msgprefix

Specifies the Rexx standard message prefix to be used. msgprefix can be any
string up to 9 characters. Embedded blanks are not allowed.

ERRPREFIX

This is the keyword used to set the prefix for error messages. ERRPREFIX can be
abbreviated as ‘ERRP’. There is no error prefix set, unless exlicitely specified with
the ERRPREFIX parameter.

errorprefix

Specifies the Rexx error message prefix to be used. errorprefix can be any string
up to 9 characters. Embedded blanks are not allowed.

MODE

This is the keyword used to specify the argument passing style to a Rexx script. If
not explicitely specified, MODE is set to command style (‘COMMAND’).

COMMAND

Specifies command style for passing arguments to a Rexx script. ‘COMMAND’ may
be abbreviated as ‘COM’.

SUBROUTINE

Specifies subroutine style for passing arguments to a Rexx script. ‘SUBROUTINE’
may be abbreviated as ‘SUB’.

ON

Activates the specified option.

OFF

Deactivates the specified option.

RESET

Given as an argument to one of the options of the Rexx command this will reset the
corresponding value to the default settings.

5.64.4 Examples

Example 1:

Enable ooRexx, set the filename extensions to be used to “.REXX” and “.REX” and set subroutine style
for passing arguments to the Rexx script.

REXX ENABLE OOREXX

REXX EXTENSIONS .REXX;.REX

REXX MODE SUBROUTINE