VALUE

Returns the value of an expression.


>>-EXTract--VALue--address-------------------------------------><

address: An IDF address expression.

REXX variables set

EXPR: The value of the specified expression

If the address is outside of the programs defined to IDF, the code section (CSECT) name is omitted and the symbolic name is a second hexadecimal value.

If the address is outside the currently qualified module or the FULLQUAL option is ON, then the code section name as defined above is module.csect, where module is the name of module containing the address.

Numbers in expressions can be specified in explicit (X'123', F'123') or implicit (123) notation. Numbers that do not explicitly specify the base are evaluated according to the current setting of the HEXINPUT option. When writing macros it is recommended that you use explicit base notation.

Example

EXTRACT VALUE ALLOPEN+4(R2)

If symbol ALLOPEN is at X'20000' and the target program's R2 contained 8, the value returned is X'2000C'. This value is returned in REXX variable EXPR as several tokens, and can be parsed with the following instruction:

Parse Var EXPR hexvalue . '(' csect ')' symbolic

After this Parse instruction, the following variables are set:

EXPR: 0002000C (ALLOPEN) ALLOPEN+12
HEXVALUE: 0002000C
CSECT: ALLOPEN
SYMBOLIC: ALLOPEN+12