Built-in number for RSLVDP is 385.
RSLVDP (
pointer_for_addressability_to_data_object : address of data pointer
data_object_identification : address OR
null operand
program : address of system pointer OR
null operand
)
Description:
A data pointer with addressability to and the
attributes of an external scalar data element is returned
in the storage area identified by operand 1.
The following describes the instruction's function when operand 2
is null:
If operand 1 does not contain a data pointer,
an exception is signaled.
If the data pointer specified by operand 1 is
not resolved and has an initial value declaration, the
instruction resolves the data pointer to the external scalar that
the initial value describes.
The initial value defines the external scalar to be located
and, optionally, defines the program in which it is to be located.
If the program name is specified in the initial value, only that
program's activation entry is searched for the external scalar.
If no program is specified, programs associated with the
activation entries in the current activation group
in which the program is executing, are searched
in reverse order of the activation entries,
and operand 3 is ignored.
The current activation group for non-bound programs is the default
activation group whose state is the same as the state of the process
at the time the instruction is run.
If the data pointer is currently resolved and defines an
existing scalar, the instruction causes
no operation, and no exception is signaled.
The following describes the instruction's function when operand 2
is not null:
A data pointer that is resolved to the external scalar identified
by operand 2 is returned in operand 1.
Operand 2 is a 32-byte value that provides the name of the external
scalar to be located.
Operand 3 specifies a system pointer that identifies the program whose
activation is to be searched for the external scalar definition.
If operand 3 is null, the instruction searches all activations
in the activation group from which the instruction is executed,
starting with the most recent activation and continuing to the oldest.
The activation under which the instruction is issued also
participates in the search.
If operand 3 is not null, the instruction
searches the activation of the program addressed by the system pointer.