WHEN SYSTEM = 'ESA/390' THEN DO

ADDRESS HERCULES 'ARCHLVL ESA/390'

ADDRESS HERCULES 'MAINSIZE 2048'

ADDRESS HERCULES 'ENGINES 2*CP'

ADDRESS HERCULES 'XPNDSIZE 2048'

END

WHEN SYSTEM = 'z/ARCH' THEN DO

ADDRESS HERCULES 'ARCHLVL z/ARCH'

ADDRESS HERCULES 'MAINSIZE 4096'

ADDRESS HERCULES 'ENGINES 4*CP,2*AP'

ADDRESS HERCULES 'XPNDSIZE 0'

END

OTHERWISE DO

SAY 'Invalid architecture mode specified'

RETURN 16

END

The above extract from a configuration file shows the different settings of system parameters depending
on the value of a variable.

14.3 Command Environment

Hercules commands can be issued from Rexx through the Hercules command environment. The Her-
cules command environment is the default environment, therefore it is not necessary to specify it, when
using Hercules commands within a Rexx script.

Example 1:

Executing the Hercules ‘ARCHLVL’ command from a Rexx script specifying the Hercules command en-
vironment.

ADDRESS HERCULES 'ARCHLVL S/370'

Example 2:

Executing the Hercules ‘ARCHLVL’ command from a Rexx script without specifying the Hercules
command environment.

'ARCHLVL S/370'

14.4 The Rexx Builtin Function “value()”

Hercules symbols and environment variables can be retrieved with “value()” or “getenv()”. The builtin
function “getenv()” is obsolete and has been replaced by “value()” and should no longer be used.

14.4.1 Function

The Rexx builtin function “value()” is used to retrieve the value of existing variables. On optional para-
meter can be used to searchwithin a specific variable pool. To retrieve the values of Hercules symbols the
“SYSTEM” pool must be specified, to retrieve the values of Hercules (and other) environment variables
the “ENVIRONMENT” pool must be specified. See the Regina Rexx documentation for more details on
“value()”.

14.4.2 Syntax

Descriptive

Diagram

Êʬ¬¬ ¬¬¬ (
¬¬¬ symbol ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

ʬ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬ )
¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

, ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬ ,
¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬

pool

14.4.3 Parameter

symbol

This names an existing variable. If symbol does not name an existing variable, the
default value is returned, and the NOVALUE condition is not raised.

If symbol is not a valid symbol name and the function is used to access an normal
Rexx variable, an error occurs.

value

If the optional second parameter value is specified, the variable will be set to that
value, after the old value has been extracted.

pool

The optional parameter pool might be specified to select a particular variable pool
to search for symbol. The contents and format of pool is implementation depen-
dent.

The default is to search in the variables at the current procedural level in Rexx.
Which pools that are available is implementation dependent, but typically one can
set variables in application programs or in the operating system.

Specify “SYSTEM” to retrieve the value of a Hercules symbol or “ENVIRONMENT”
to retrieve the value of a Hercules (or another) environment variable.