Ansicht
Dokumentation

ARCHIVE_SAVE_OBJECT - Write Data Object to the Archive File

General Data in Customer Master   ABAP Short Reference  
This documentation is copyright by SAP AG.

Functionality

This function module writes a data object to the archive file. In addition to the data which was passed with the function module ARCHIVE_PUT_RECORD, the data which was passed via the archiving classes is also included.

If the data object no longer fits into the current archive file, the archive file is closed and a new archive file opened. The deletion program is then called automatically if this option was not deactivated in the transaction AOBJ "Customizing Settings ".

The function module checks whether an interruption request was received for the running write program. If yes, the current data object is no longer written to the archive file, and the exception TERMINATION_REQUESTED is raised.

Example

• Example 1
  
  

CALL FUNCTION 'ARCHIVE_SAVE_OBJECT'

     EXPORTING

          ARCHIVE_HANDLE          = HANDLE

     EXCEPTIONS

          TERMINATION_REQUESTED   = 1.

IF sy-subrc = 1.

   session_interrupted = 'X'.

   EXIT.             " no further data object

ENDIF.

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

Additional Notes

Please refer to the documentation on the function module ARCHIVE_OPEN_FOR_WRITE.

Parameters

ARCHIVE_HANDLE
ARCHIVE_NAME
END_OF_RETENTION
OBJECT_OFFSET

Exceptions

DATA_OBJECT_NOT_SAVED
FILE_IO_ERROR
INTERNAL_ERROR
OPEN_ERROR
TERMINATION_REQUESTED
WRONG_ACCESS_TO_ARCHIVE

Function Group

ARCH

General Data in Customer Master   Fill RESBD Structure from EBP Component Structure  
This documentation is copyright by SAP AG.

Length: 3269 Date: 20240523 Time: 103327     sap01-206 ( 43 ms )