Ansicht
Dokumentation

ARCHIVE_GET_NEXT_RECORD - Sequential Read of the Records from a Data Object

ARCHIVE_GET_NEXT_RECORD - Sequential Read of the Records from a Data Object

Addresses (Business Address Services)   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

This function module is used to read the data records of a data object sequentially.

In the first call after the function module ARCHIVE_GET_NEXT_OBJECT has been called, the first data record is returned automatically and from then onwards the following data records until there are no more records in the data object.

Examples

  • Example 1: Only Unicode-enable for pure character structures

DATA: HANDLE LIKE SY-TABIX.

      NON_UC_BUFFER LIKE ARC_BUFFER-SEGMENT,

      NON_UC_STRUCTURE LIKE ARC_BUFFER-RNAME.

CALL FUNCTION 'ARCHIVE_GET_NEXT_RECORD'

     EXPORTING

          ARCHIVE_HANDLE          = HANDLE

     IMPORTING

          RECORD                  = NON_UC_BUFFER

          RECORD_STRUCTURE        = NON_UC_STRUCTURE

     EXCEPTIONS

          END_OF_OBJECT           = 01

          INTERNAL_ERROR          = 02

          WRONG_ACCESS_TO_ARCHIVE = 03.

  • Example 2
    For detailed Unicode-enabled examples that use the parameter RECORD_REF, see sample programs SBOOKR and SBOOKR_2.

Additional Information

To read an archive file sequentially, it is sufficient if the next data object is read in an outer DO loop with the function module ARCHIVE_GET_NEXT_OBJECT and then the data records of the data object in an inner DO loop with the function module ARCHIVE_GET_NEXT_RECORD.





Parameters

ARCHIVE_HANDLE
AUTOMATIC_CONVERSION
GET_REAL_STRUCTURE_NAME
RECORD
RECORD_CURSOR
RECORD_FLAGS
RECORD_LENGTH
RECORD_REF
RECORD_STRUCTURE

Exceptions

END_OF_OBJECT
INTERNAL_ERROR
WRONG_ACCESS_TO_ARCHIVE

Function Group

ARCH

BAL Application Log Documentation   ROGBILLS - Synchronize billing plans  
This documentation is copyright by SAP AG.

Length: 4396 Date: 20240523 Time: 091253     sap01-206 ( 32 ms )