RSDS_QUEUE_READ SAP Function module - read queue

RSDS_QUEUE_READ is a standard SAP function module available within R/3 SAP systems depending on your version and release level. Below is the pattern details for this FM showing its interface including any import and export parameters, exceptions etc as well as any documentation contributions (Comments) specific to the object.

See here to view full function module documentation and code listing, simply by entering the name RSDS_QUEUE_READ into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: RSDS_QUEUE_SERVICES
Released Date: Not Released
Processing type: Normal fucntion module

Pattern for FM RSDS_QUEUE_READ - RSDS QUEUE READ

CALL FUNCTION 'RSDS_QUEUE_READ' "read queue
  EXPORTING
    i_datasource =              " rsds_queue_head-datasource  DataSource
    i_logsys =                  " rsds_queue_head-logsys  Source System
    i_requid =                  " rsds_queue_head-requid  Request ID (Data Package)
*   i_read_only = RS_C_TRUE     " rs_bool       Simulation: Delete no data
*   i_updmode = 'D '            " rsupdmode     Mode of data update (Full, Delta, etc.)
*   i_initflag = RS_C_FALSE     " rs_bool       Extraction from queue: Init
*   i_maxsize = '000100'        " rsmaxsize     Maximum number of table entries in extraction API interface
  IMPORTING
    e_t_data =                  " rsds_queue_t_data  Queue Data (Binary)
  EXCEPTIONS
    NO_MORE_DATA = 1            "               No data (found)
    ERROR_READING_QUEUE = 2     "               Queue could not be read
    FAILED = 3                  "               Error Reading Data
    .  "  RSDS_QUEUE_READ

ABAP code example for Function Module RSDS_QUEUE_READ

The ABAP code below is a full code listing to execute function module RSDS_QUEUE_READ including all data declarations. The code uses the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the original method of declaring data variables up front. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8).

DATA:
ld_e_t_data  
 
 TYPE RSDS_QUEUE_T_DATA
.

 

SELECT single DATASOURCE 
  FROM RSDS_QUEUE_HEAD 
  INTO @DATA(ld_i_datasource).

 

SELECT single LOGSYS 
  FROM RSDS_QUEUE_HEAD 
  INTO @DATA(ld_i_logsys).

 

SELECT single REQUID 
  FROM RSDS_QUEUE_HEAD 
  INTO @DATA(ld_i_requid).


DATA(ld_i_read_only) = 'Check type of data required'.

DATA(ld_i_updmode) = 'Check type of data required'.

DATA(ld_i_initflag) = 'Check type of data required'.

DATA(ld_i_maxsize) = 'Check type of data required'.
.

CALL FUNCTION 'RSDS_QUEUE_READ'
  EXPORTING
    i_datasource =               ld_i_datasource
    i_logsys =                   ld_i_logsys
    i_requid =                   ld_i_requid
*   i_read_only =                ld_i_read_only
*   i_updmode =                  ld_i_updmode
*   i_initflag =                 ld_i_initflag
*   i_maxsize =                  ld_i_maxsize
  IMPORTING
    e_t_data =                   ld_e_t_data
  EXCEPTIONS
    NO_MORE_DATA =               1
    ERROR_READING_QUEUE =        2
    FAILED =                     3
    .  "  RSDS_QUEUE_READ

IF SY-SUBRC EQ 0.
  "All OK
ELSEIF SY-SUBRC EQ 1. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 2. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 3. "Exception
  "Add code for exception here
ENDIF.

ABAP code to compare 7.40 inline data declaration with original syntax

The below ABAP code uses the older none in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. It may also be useful if you are using an older version of SAP as some of the newer syntax above, such as the @DATA is not available until 4.70 EHP 8.

DATA:

ld_e_t_data
 
 TYPE RSDS_QUEUE_T_DATA ,
ld_i_datasource
 
 TYPE RSDS_QUEUE_HEAD-DATASOURCE ,
ld_i_logsys
 
 TYPE RSDS_QUEUE_HEAD-LOGSYS ,
ld_i_requid
 
 TYPE RSDS_QUEUE_HEAD-REQUID ,
ld_i_read_only
 
 TYPE RS_BOOL ,
ld_i_updmode
 
 TYPE RSUPDMODE ,
ld_i_initflag
 
 TYPE RS_BOOL ,
ld_i_maxsize
 
 TYPE RSMAXSIZE .



SELECT single DATASOURCE 
  FROM RSDS_QUEUE_HEAD 
  INTO ld_i_datasource.


SELECT single LOGSYS 
  FROM RSDS_QUEUE_HEAD 
  INTO ld_i_logsys.


SELECT single REQUID 
  FROM RSDS_QUEUE_HEAD 
  INTO ld_i_requid.

ld_i_read_only = 'Check type of data required'.
ld_i_updmode = 'Check type of data required'.
ld_i_initflag = 'Check type of data required'.
ld_i_maxsize = 'Check type of data required'.