Ansicht
Dokumentation

ARCHIVE_SAVE_OBJECT - Datenobjekt in die Archivdatei schreiben

Vendor Master (General Section)   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Funktionsbaustein schreibt ein Datenobjekt in die Archivdatei. Neben den mit dem Funktionsbaustein ARCHIVE_PUT_RECORD übergebenen Daten werden dabei auch die Daten berücksichtigt, die über die Archivierungsklassen übergeben wurden.

Falls das Datenobjekt nicht mehr in die aktuelle Archivdatei passen sollte, wird die Archivdatei geschlossen und eine neue Archivdatei geöffnet. Es erfolgt dann der automatische Aufruf des Löschprogramms, wenn diese Option in der Transaktion AOBJ "Customizing-Einstellungen " nicht abgeschaltet wurde.

Der Funktionsbaustein prüft, ob für das laufende Schreibprogramm eine Unterbrechungsanforderung einging. Falls ja, wird das aktuelle Datenobjekt nicht mehr in die Archivdatei geschrieben und die zu behandelnde Ausnahme TERMINATION_REQUESTED ausgelöst.

Beispiel

• Beispiel 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.

• Beispiel 2
  Ein ausführliches Beispiel finden Sie in dem Programm SBOOKA.

Weitere Hinweise

Bitte lesen Sie auch die Dokumentation zu dem Funktionsbaustein ARCHIVE_OPEN_FOR_WRITE.

Parameter

ARCHIVE_HANDLE
ARCHIVE_NAME
END_OF_RETENTION
OBJECT_OFFSET

Ausnahmen

DATA_OBJECT_NOT_SAVED
FILE_IO_ERROR
INTERNAL_ERROR
OPEN_ERROR
TERMINATION_REQUESTED
WRONG_ACCESS_TO_ARCHIVE

Funktionsgruppe

ARCH

CPI1466 during Backup   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 3453 Date: 20240523 Time: 130732     sap01-206 ( 40 ms )