Fonction SAP ARCHIVE_GET_NEXT_RECORD - Sequential Read of the Records from a Data Object

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
ARCHIVE_HANDLE SYST-TABIX I 4 Handle to the Open Archive Files
AUTOMATIC_CONVERSION 0 'X' X Automatic Conversion of the Data Record
GET_REAL_STRUCTURE_NAME 0 'X' X Conversion of the Structure Name

Paramètre Reférence Type Long. Description
RECORD 0 Data Record
RECORD_CURSOR SYST-TABIX I 4 Pointer to Data Record
RECORD_FLAGS ARC_BUFFER-FLAGS C 8 Flag Bar per Data Record
RECORD_LENGTH ARCH_INT-INT4 I 4 Length of the Data Record in Parameter RECORD
RECORD_REF REF TO DATA 0 Reference to Data Record
RECORD_STRUCTURE ARC_BUFFER-RNAME C 30 Name of Returned Structure

Exception Description
END_OF_OBJECT No Further Data Record Exists
INTERNAL_ERROR Internal Error
WRONG_ACCESS_TO_ARCHIVE Incorrect Access to the Archive

Functionality
This function module is used to read the data records of a data objectsequentially.
In the first call after the function module ARCHIVE_GET_NEXT_OBJECT
has been called, the first data record is returned automatically andfrom then onwards the following data records until there are no morerecords in the data object.

  • 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 dataobject is read in an outer DO loop with the function module
      ARCHIVE_GET_NEXT_OBJECT and then the data records of the data objectin an inner DO loop with the function module
      ARCHIVE_GET_NEXT_RECORD.

      Description
      The parameter RECORD_LENGTH provides the length of the datarecord passed on via the parameter RECORD.

      Description
      INCLUDE 'ARCHIVE_PARAM_RECORD_REF_GET' OBJECT DOKU ID TX
      A comprehensive example is contained in programs SBOOKR and SBOOKR_2 (
      Transaktion SE38).
      INCLUDE 'ARCHIVE_PARAM_HANDLE_READ' OBJECT DOKU ID TX
      Note that in the reload program, only the read handle can be used inthis context.
      INCLUDE 'ARCHIVE_PARAM_AUTOMATIC_CONV' OBJECT DOKU ID TX

1624441S3VBRKDLS: Termination ASSIGN_CASTING_ILLEGAL_CAST
767917Error VI 200 during deletion run of SD_VBAK