LOCATION

Extracts bytes of main memory.


>>-EXTract--LOCATIon--number-of-bytes--start-address-----------><

number-of-bytes: Number of bytes of main memory to be extracted.
start-address: An expression giving the starting address.
If the expression contains an access register then the storage that is extracted will come from the dataspace identified by the ALET in the referenced access register.

REXX variables set

MEMAREA: Contents of the specified memory area

The EXTRACT LOCATION command allows you to retrieve storage within your program's defined limits. For more details on your program's defined limits and how to change them, see (CMS) Your program's defined limits and (TSO) Your program's defined limits.

If the TRACEALL option or the RISK option is set, you may be able to retrieve storage beyond the program's defined limits.

Example

EXTRACT LOCATION 8 0(R1)

This example sets REXX variable MEMAREA to the contents of eight bytes pointed to by the target program's R1.

EXTRACT LOCATION 8 0(AR2)

This example sets REXX variable MEMAREA to the contents of eight bytes pointed to by the target program's R2 in the dataspace identified by the ALET in AR2.