Funktionsgruppe ARCH
ARCHIVE_CLOSE_FILE
Mit diesem Funktionsbaustein schließen Sie alle unter einem Handle zusammengefaßten Archivdateien, unabhängig davon, ob sie zum Lesen, Schreiben oder Rückladen geöffnet waren.
ARCHIVE_DELETE_OBJECT_DATA
Mit diesem Funktionsbaustein rufen Sie zum aktuellen Datenobjekt die Löschunterprogramme der beteiligten Archivierungsklassen auf.
ARCHIVE_GET_CUSTOMIZING_DATA
Dieser Funktionsbaustein liefert den Commit-Zähler sowie das Kennzeichen für Indexaufbau zurück. Der Commit-Zähler legt fest, nach wievielen Datenobjekten ein COMMIT WORK abgesetzt werden soll. Das Kennzeichen für Indexaufbau sagt aus, ob das Löschprogramm die archivierten und gelöschten Datenobjekte im ADK-Index aufnehmen soll.
ARCHIVE_GET_FIRST_RECORD
(nur für Standardklasse)Mit diesem Funktionsbaustein setzen Sie den Satzzeiger auf den ersten Satz im Datencontainer innerhalb des zuvor mit ARCHIVE_GET_NEXT_OBJECT eingelesenen Datenobjekts und lesen diesen.
Dieser Funktionsbaustein vereint die Funktionen der Funktionsbausteine ARCHIVE_SET_RECORD_CURSOR und ARCHIVE_GET_NEXT_RECORD.
Wenn Sie nur die Felder RECORD_FLAGS und RECORD_STRUCTURE benötigen, können Sie den Funktionsbaustein ARCHIVE_GET_RECORD_INFO verwenden.
ARCHIVE_GET_INFORMATION
Mit diesem Funktionsbaustein erhalten Sie zu einem Archiv-Handle aktuelle Informationen, wie Datum, Release, SAP-System und Archivnamen.
ARCHIVE_GET_OPEN_FILES
Mit diesem Funktionsbaustein füllen Sie eine Tabelle mit den Dateinamen aller Archivdateien, die gerade mit den Funktionsbausteinen des ADK bearbeitet werden.
ARCHIVE_GET_NEXT_OBJECT
Mit diesem Funktionsbaustein lesen Sie zu einem Archiv-Handle das nächste Datenobjekt aus einem zum Lesen geöffneten Archiv in den Datencontainer. Dieser Aufruf ist Voraussetzung für den Funktionsbaustein ARCHIVE_GET_NEXT_RECORD oder ARCHIVE_GET_FIRST_RECORD sowie den Aufruf der Archivierungsklassen. Verwenden Sie Archivierungsklassen, so sind nach diesem Aufruf die Daten der Archivierungsklassen über deren Funktionsbausteine abrufbar.
ARCHIVE_GET_NEXT_RECORD
(nur für Standardklasse)Mit diesem Funktionsbaustein lesen Sie innerhalb eines mit ARCHIVE_GET_NEXT_OBJECT eingelesenen Datenobjekts sequentiell den nächsten Satz im Datencontainer. Beim ersten Aufruf lesen Sie automatisch den ersten Satz.

Die folgenden zwei Funktionsbausteine (ARCHIVE_GET_NEXT_STRUCT_SPECIF und ARCHIVE_GET_RECORD_INFO) wurden für die leichte Implementierung von Leseoperationen in Archiven in logischen Datenbanken entwickelt. Sie können natürlich auch in anderen Programmen sinnvoll eingesetzt werden.
ARCHIVE_GET_NEXT_STRUCT_SPECIF
(nur für Standardklasse)Mit diesem Funktionsbaustein lesen Sie Archive mit vorgegebenen Strukturen in logischen Datenbanken. Die Gruppenwechsellogik ist integriert.
Sie können jedoch auch den Funktionsbaustein ARCHIVE_GET_NEXT_RECORD verwenden, müssen jedoch in diesem Fall die Gruppenwechsellogik für die einzelnen Hierarchiestufen selbst programmieren.
ARCHIVE_GET_RECORD_INFO
(nur für Standardklasse)Mit diesem Funktionsbaustein erhalten Sie Informationen zu archivierten Datensätzen in logischen Datenbanken.
ARCHIVE_GET_TABLE
Mit diesem Funktionsbaustein lesen Sie innerhalb eines mit ARCHIVE_GET_NEXT_OBJECT eingelesenen Datenobjekts mehrere Datensätze in eine interne Tabelle.
ARCHIVE_GET_WITH_CURSOR
(nur für Standardklasse)Mit diesem Funktionsbaustein können Sie Datensätze im Datencontainer innerhalb eines Datenobjekts direkt lesen. Den dafür benötigten Satzzeiger erhalten Sie durch den sequentiellen Zugriff auf die Datensätze eines Datenobjekts über den Parameter RECORD_CURSOR. Dieser Funktionsbaustein eignet sich dazu, Sätze über den Satzzeiger zu „merken", um sie zu einem späteren Zeitpunkt weiterzuverarbeiten.
ARCHIVE_NEW_OBJECT
Mit diesem Funktionsbaustein fordern Sie zu einem Archiv-Handle einen neuen Datencontainer zum Schreiben an.
ARCHIVE_OPEN_FOR_MOVE
Mit diesem Funktionsbaustein öffnen Sie eine oder mehrere Archivdateien zum Rückladen von archivierten Daten. Sie erhalten einen Archiv-Handle für die zu lesende Archivdatei sowie einen weiteren Archiv-Handle zum Schreiben derjenigen Datenobjekte, die nicht zurückgeladen werden sollen. Dies erlaubt das selektive Zurückladen von einzelnen Datenobjekten aus Archiven in das R/3-System.
ARCHIVE_OPEN_FOR_READ
Mit diesem Funktionsbaustein öffnen Sie eine vorhandene Archivdatei zum Lesen. Dabei wird ein Archiv-Handle zurückgeliefert, unter dem auf diese Datei gezielt zum Lesen zugegriffen werden kann. Sie können auch mehrere Archivdateien gleichzeitig öffnen. Sie werden dann alle unter dem einen Handle zusammengefaßt. Funktionsbausteine, die mit diesem Archiv-Handle lesend zugreifen, behandeln alle unter diesem Archiv-Handle zusammengefaßten Dateien wie eine einzige Datei.
ARCHIVE_OPEN_FOR_WRITE
Mit diesem Funktionsbaustein erzeugen Sie eine neue Archivdatei und einen Archiv-Handle, mit dem Sie schreibend auf diese Datei zugreifen können.
Sollten Sie im
archivierungsobjektspezifischen Customizing keinen Dateinamen festgelegt haben, wird automatisch der plattformunabhängige logische Dateiname ARCHIVE_DATA_FILE verwendet, um einen gültigen plattformabhängigen Dateinamen zu ermitteln. Über Steuerungsparameter können Sie ferner festlegen, ob das Löschprogramm für die archivierten Daten im Anschluß an das Schreiben automatisch aufgerufen werden soll.ARCHIVE_PUT_RECORD
(nur für Standardklasse)Mit diesem Funktionsbaustein übergeben Sie einen Datensatz an den zuvor mit dem Funktionsbaustein ARCHIVE_NEW_OBJECT angeforderten Datencontainer.
Alle von Ihnen an den Datencontainer übergebenen Datensätze werden mit dem Funktionsbaustein ARCHIVE_SAVE_OBJECT gemeinsam in die Archivdatei geschrieben.
ARCHIVE_PUT_TABLE
(nur für Standardklasse)Mit diesem Funktionsbaustein übergeben Sie eine interne Tabelle an den zuvor mit ARCHIVE_NEW_OBJECT angeforderten Datencontainer. Die Zeilen der internen Tabelle werden dabei als einzelne Datensätze in den Datencontainer gestellt.
ARCHIVE_REGISTER_CLASS
Mit diesem Funktionsbaustein binden Sie Archivierungsklassen dynamisch an ein Archivierungsobjekt.
ARCHIVE_RELOAD_OBJECT_DATA
(nur für Archivierungsklassen)Mit diesem Funktionsbaustein rufen Sie die Rückladeunterprogramme der beteiligten Archivierungsklassen auf.
ARCHIVE_ROLLBACK_WORK
Falls in einem Lösch- oder Rückladeprogramm ein ROLLBACK WORK durchgeführt werden muß, so sollte dies nicht durch den ABAP/4-Befehl ROLLBACK WORK geschehen, sondern durch den Aufruf dieses Funktionsbausteins. Dieser Funktionsbaustein gewährleistet das korrekte Zurücksetzen der Daten aller verwendeten Archivierungsklassen.
ARCHIVE_SAVE_OBJECT
Mit diesem Funktionsbaustein schreiben Sie ein Datenobjekt in die Archivdatei. Neben den mit ARCHIVE_PUT_RECORD übergebenen Daten werden auch die Daten berücksichtigt, die über die Archivierungsklassen übergeben wurden.
ARCHIVE_SET_RECORD_CURSOR
(nur für Standardklasse)Mit diesem Funktionsbaustein setzen Sie den Satzzeiger innerhalb der Standardklasse des zuletzt eingelesenen Datenobjekts. Sie können dann mit ARCHIVE_GET_NEXT_RECORD auf den nächsten Satz lesend zugreifen.
ARCHIVE_WRITE_STATISTICS
(nur für Standardklasse)Mit diesem Funktionsbaustein erzeugen Sie den Ausdruck einer Statistik über die Datenobjekte, die Sie mit ARCHIVE_SAVE_OBJECT in die Archivdateien geschrieben haben.