Kontakt

Ansicht
Dokumentation

ARCHIVE_OPEN_FOR_CONVERSION - Datenobjekte in eine neue Archivdatei schreiben (für Umsetzungen)

ARCHIVE_OPEN_FOR_CONVERSION - Datenobjekte in eine neue Archivdatei schreiben (für Umsetzungen)

CL_GUI_FRONTEND_SERVICES - Frontend Services   CPI1466 during Backup  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Dieser Funktionsbaustein dient der Unterstützung bei der anwendungsspezifischen Umsetzung archivierter Daten. Ein bestehender Archivierungslauf wird dabei zum Lesen geöffnet und ein neuer Archivierungslauf erzeugt, in den die vom Anwendungsprogramm umgesetzten Datenobjekte übertragen werden.

Nach dem Aufruf dieses Funktionsbausteins werden zwei Archiv-Handle zurückgegeben:

  • Über das im Parameter ARCHIVE_READ_HANDLE zurückgegebene Archiv-Handle wird der Inhalt des bestehenden Archivierungslaufs eingelesen.
  • Das im Parameter ARCHIVE_WRITE_HANDLE zurückgegebene Archiv-Handle zeigt auf den neu erzeugten Archivierungslauf, der die umgesetzten Datenobjekte aufnimmt.

Hinweise

Über Archivierungsklassen archivierte Daten werden nicht automatisch vom bestehenden Archivierungslauf in den neu erzeugten Archivierungslauf übertragen.

Nach der erfolgreichen Umsetzung des bestehenden Archivierungslaufs wird dieser nicht mehr für weitere Aktionen in der Datenarchivierung angeboten.

Beispiele

  • Beispiel 1

DATA: READ_HANDLE LIKE SY-TABIX,

      SAVE_HANDLE LIKE SY-TABIX.

...

CALL FUNCTION 'ARCHIVE_OPEN_FOR_CONVERSION'

     EXPORTING

          OBJECT               = 'EXAMPLE'

     IMPORTING

          ARCHIVE_READ_HANDLE  = READ_HANDLE

          ARCHIVE_WRITE_HANDLE = SAVE_HANDLE

     EXCEPTIONS

          FILE_ALREADY_OPEN    = 01

          FILE_IO_ERROR        = 02

          INTERNAL_ERROR       = 03

          NO_FILES_AVAILABLE   = 04

          OBJECT_NOT_FOUND     = 05

          OPEN_ERROR           = 06.

  • Beispiel 2
    Ein ausfühliches Beispiel finden Sie in dem Programm RSARCH12.




Parameter

ARCHIVE_READ_HANDLE
ARCHIVE_RUNS
ARCHIVE_WRITE_HANDLE
OBJECT
TEST_MODE

Ausnahmen

FILE_ALREADY_OPEN
FILE_IO_ERROR
INTERNAL_ERROR
NOT_AUTHORIZED
NO_FILES_AVAILABLE
OBJECT_NOT_FOUND
OPEN_ERROR

Funktionsgruppe

ARCH

General Material Data   Fill RESBD Structure from EBP Component Structure  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4979 Date: 20240523 Time: 130759     sap01-206 ( 60 ms )