If no environment is given as argument then the default Rexx environment is star-
ted.

The default can be specified with the HREXX_PACKAGE environment variable (for
details see chapter

ENABLE can be abbreviated as ‘ENA’.

START

This is the same as ENABLE. START can be abbreviated as ‘STA’.

DISABLE

Disables the currently active Rexx environment. This option is only available if Her-
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 used for executables (when set to on ‘ON’) or if it should be
limited to the defined PATHS / REXXPATHS (when set to ‘OFF’).

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.

For examples of the different behaviour of the EXEC command depending on the
RESOLVER settings please see the next section.

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 when a script
has finished.

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’.

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’.

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.

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.