SAP Function ARCHIVE_PUT_RECORD - Write Data Record to Data Object

Parameter Reference Type Length Default Optional Text
ARCHIVE_HANDLE SYST-TABIX I 4 Handle to the Open Archive Files
RECORD 0 Data Record
RECORD_FLAGS ARC_BUFFER-FLAGS C 8 SPACE X Flag Bar per Data Record
RECORD_STRUCTURE ARC_BUFFER-RNAME C 30 Name of the Structure to Be Written

Exception Text
INTERNAL_ERROR Internal Error
INVALID_RECORD_STRUCTURE Structure of the Record is Unknown
WRONG_ACCESS_TO_ARCHIVE Incorrect Access to the Archive

Functionality
This function module is used to pass a data record to the data objectrequested beforehand with the function module ARCHIVE_NEW_OBJECT
. All data records you pass to the data object are written to thearchive file together when you call the function moduleARCHIVE_SAVE_OBJECT.

  • Example 1

    • Extract from a program for archiving FI documents
    TABLES: BKPF, BSEG, BSET, BVOR, BSEC, BSED.
    DATA: HANDLE LIKE SY-TABIX.
    ...
    CALL FUNCTION 'ARCHIVE_PUT_RECORD'
    EXPORTING
    ARCHIVE_HANDLE = HANDLE
    RECORD = BKPF
    RECORD_FLAGS = 'DELETE '
    RECORD_STRUCTURE = 'BKPF'
    EXCEPTIONS
    INTERNAL_ERROR = 01
    WRONG_ACCESS_TO_ARCHIVE = 02.
    • Example 2

      • A detailed example can be found in the program SBOOKA.

      Notes
      In the case of complex data objects, it may be necessary to read andevaluate all data records before you can decide whether this dataobject should be archived.
      It is not necessary to make a note of the data records or read the datarecords from the database again. You can simply pass the data recordsto the data object with this function module.
      If you decide that the data records you have passed should not bearchived, simply call the function module ARCHIVE_NEW_OBJECT. Itensures that the data you have passed is discarded. The data you haveforwarded to the archiving classes to be archived is also discarded.
      INCLUDE 'ARCHIVE_PARAM_RECORD' OBJECT DOKU ID TX
      In this case you use this parameter to pass a data record of structureRECORD_STRUCTURE to the data object.
      INCLUDE 'ARCHIVE_PARAM_STRUCTURE' OBJECT DOKU ID TX
      In this case, you use this parameter to assign the name of thestructure of the data record to the data record. The record passedusing RECORD must be of the specified RECORD_STRUCTURE or theRECORD_STRUCTURE assigned to the alias.