Ansicht
Dokumentation

ARCHIVE_OPEN_FOR_DELETE - Archivdatei öffnen zum Löschen der Sätze in der Datenbank

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

Funktionalität

Dieser Funktionsbaustein öffnet Archive, um deren Daten in der Datenbank zu löschen. Der Funktionsbaustein ARCHIVE_CLOSE_FILE wird diese Archivdateien auf Wunsch an Archive-Link für die optische Archivierung übergeben. In der Archivadministration wird der Status der Archivdateien entsprechend angepasst.

Sie können dabei mehrere Archivdateien gleichzeitig öffnen, die zu einem Archivhandle zusammengefaßt werden. Dieser Handle wird über den Parameter ARCHIVE_HANDLE übergeben. Bei allen weiteren Operationen auf den Archivdateien wird nur noch der Handle benötigt, damit die Archivierung weiß, aus welchen Dateien gelesen werden muß.

Jeder zusätzliche Aufruf dieses Funktionsbausteins erzeugt einen neuen Handle. Damit ist es möglich, mehrere Archive von unterschiedlichen Archivierungsobjekten gleichzeitig zu bearbeiten. Dabei ist es egal, ob man Archive zum Lesen oder zum Schreiben geöffnet hat.

Beispiele

Beispiel 1

PARAMETERS: ARCHIVE LIKE HEADA-ARKEY,            " name of archiv file
            TESTRUN DEFAULT 'X' AS CHECKBOX,     " test flag
DATA: HANDLE LIKE SY-TABIX.
...
CALL FUNCTION 'ARCHIVE_OPEN_FOR_DELETE'
     EXPORTING
          ARCHIVE_NAME       = ARCHIVE
          OBJECT             = 'BELEG'
          TEST_MODE          = TESTRUN
     IMPORTING
          ARCHIVE_HANDLE     = 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 RSARCH06.

Weitere Hinweise

Alle Funktionsbausteine, die lesend per Handle auf ein Archiv zugreifen, behandeln alle geöffneten Dateien zu diesem Handle, als ob es sich um eine einzige Datei handeln würde.

Parameter

AINDFLAG
ARCHIVE_HANDLE
ARCHIVE_NAME
NO_STATISTICS
OBJECT
OUTPUT_SEL_SCREEN_WHEN_BATCH
OUTPUT_SEL_SCREEN_WHEN_DIALOG
SELECTED_FILES
TEST_MODE

Ausnahmen

ARCHIVING_STANDARD_VIOLATION
FILE_ALREADY_OPEN
FILE_IO_ERROR
INTERNAL_ERROR
NOT_AUTHORIZED
NO_FILES_AVAILABLE
OBJECT_NOT_FOUND
OPEN_ERROR

Funktionsgruppe

ARCH

General Data in Customer Master CL_GUI_FRONTEND_SERVICES - Frontend Services
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5164 Date: 20240523 Time: 130728 sap01-206 ( 55 ms )

Ansicht Dokumentation