GET PARAMETER ID pid FIELD dobj.
This statement sets the content of the data object
dobj to the content of the
SPA/GPA parameter specified in
pid in the
user memory. The ID
pid must be a
flat character-like field that
contains no more than 20 characters and does not consist solely of blanks. The field is case-sensitive.
The binary content of the SPA/GPA parameter is passed to
dobj without being converted. The following can be specified for
- An existing flat character-like variable.
An inline declaration
DATA(var), where a variable of type XUVALUE is declared.
GET PARAMETER does not access the user memory directly. Instead, it accesses a local mapping of the SPA/GPA parameter in the
program memory, which is loaded when rolled in and saved in the user memory when rolled out (see
SPA/GPA Parameters and ABAP Programs). If the SPA/GPA parameter specified in
pid does not yet exist in the
user memory for the current
user, the data object
dobj is initialized and
sy-subrc is set to 4.
A program can only read those SPA/GPA parameters for which there is a name in the table TPARA. If it
is known statically that an ID
pid is not in the database table TPARA, the extended program check reports an error.
|0||The SPA/GPA parameter specified in
|4||The SPA/GPA parameter specified in
An SPA/GPA parameter that is readable using
GET PARAMETERcan either have been created previously in the user memory using the statement
SET PARAMETERor created automatically in the PAI event of a dynpro or selection screen.
An SPA/GPA parameter specified in
pidmust be entered in uppercase to match a name in the database table TPARA.
GET PARAMETERdo not work directly with the SPA/GPA parameters of the user memory, which means that they are only suitable for passing data within a single ABAP session and not for passing data between two main sessions in parallel. This is because programs that run in parallel can change the state of the parameters unpredictably.
In this example, the current value of the SPA/GPA parameter RID is read from the user memory to the data object
prog. In the dynpros in
ABAP Workbench, this
parameter is associated with the input fields for a program name. When an ABAP Workbench tool in which
an ABAP program is processed, is first called, the parameter is created in the event PAI and assigned
the name of the program specified there. If, in the same user session, no dynpro is processed that sets
the parameter RID and no corresponding
SET PARAMETER statement was executed beforehand, RID is not found in the user memory.
DATA: para TYPE tpara-paramid VALUE 'RID', prog TYPE sy-repid. GET PARAMETER ID para FIELD prog. IF sy-subrc <> 0. MESSAGE 'Parameter not found' TYPE 'I'. ENDIF.