Ansicht
Dokumentation

ARCHIVE_OPEN_FOR_WRITE - Archivdatei zum Schreiben öffnen

ARCHIVE_OPEN_FOR_WRITE - Archivdatei zum Schreiben öffnen

CPI1466 during Backup   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Der Funktionsbaustein ARCHIVE_OPEN_FOR_WRITE ist der erste Funktionsbaustein, den Sie in einem Schreibprogramm aufrufen müssen, wenn Sie eine neue Archivdatei erzeugen wollen. Sie erhalten durch den Parameter ARCHIVE_HANDLE den Handle, den Sie bei den Schreiboperationen mitgeben müssen.

Beispiele

  • Beispiel 1
    Auszug aus dem Schreibprogramm für FI-Belege.

PARAMETERS: TESTRUN DEFAULT 'X' AS CHECKBOX.
DATA: HANDLE LIKE SY-TABIX.
...
CALL FUNCTION 'ARCHIVE_OPEN_FOR_WRITE'
     EXPORTING
          CALL_DELETE_JOB_IN_TEST_MODE = TESTRUN
          OBJECT                       = 'FI_DOCUMNT'
     IMPORTING
          ARCHIVE_HANDLE               = HANDLE
     EXCEPTIONS
          ...

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

Weitere Hinweise

Automatischer Aufruf des Löschprogramms

Über die Transaktion AOBJ "Customizing-Einstellungen " können Sie festlegen, ob das Löschprogramm für die archivierten Daten automatisch aufgerufen werden soll.

Vergabe der Dateinamen für Archivdateien

Die Funktionsbausteine der Archivierung benutzen die Plattformunabhängigen Dateinamen , um neue Archivdateien anzulegen. Über die Transaktion AOBJ "Customizing-Einstellungen" können Sie festlegen, welcher plattformunabhängige Dateiname für Ihr Archivierungsobjekt benutzt werden soll.

Sollten Sie keinen Dateinamen festgelegt haben, dann wird automatisch der plattformunabhängige Dateiname ARCHIVE_DATA_FILE genommen, um den rechnerabhängigen Dateinamen zu erzeugen.

Die Umsetzung des plattformunabhängigen Dateinamens in den rechnerabhängigen Dateinamen erfolgt über den Funktionsbaustein FILE_GET_NAME. Dieser hat unter anderem die beiden Parameter "" und "". An den "" wird das Applikationskürzel (z.B. FI für die Finanzbuchhaltung) übergeben, und an den "" wird ein Wert zwischen 'a' und 'z' und zwischen '0' und '9' übergeben. Das Applikationskürzel wird in der Transaktion AOBJ "Detail" eingegeben.

Schreiben von Datensätzen in die Archivdatei

In eine Archivdatei werden immer komplette Datenobjekte geschrieben. Dies geschieht durch den Funktionsbaustein ARCHIVE_SAVE_OBJECT.

Über die Transaktion AOBJ "Customizing-Einstellungen " können Sie festlegen, wie groß eine Archivdatei werden darf.

Es gibt zwei Möglichkeiten, Daten an das Datenobjekt zu übergeben:

  • einzelne Datensätze über den Funktionsbaustein ARCHIVE_PUT_RECORD
  • komplexe Daten über die Archivierungsklassen




Parameter

ARCHIVE_HANDLE
CALL_DELETE_JOB_IN_TEST_MODE
COMMENTS
CREATE_ARCHIVE_FILE
DESTROY
DO_NOT_DELETE_DATA
OBJECT
OUTPUT_SEL_SCREEN_WHEN_BATCH
OUTPUT_SEL_SCREEN_WHEN_DIALOG

Ausnahmen

ARCHIVING_STANDARD_VIOLATION
INTERNAL_ERROR
NOT_AUTHORIZED
OBJECT_NOT_FOUND
OPEN_ERROR

Funktionsgruppe

ARCH

ABAP Short Reference   CPI1466 during Backup  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5686 Date: 20240523 Time: 145314     sap01-206 ( 67 ms )