Initialisieren der Archivierungsklasse zum Lesen 
Verwendung
Der Name dieses Unterprogramms beginnt mit dem Namen der Archivierungsklasse und endet immer mit "_INIT_READ".
Aufgaben
Dieses Unterprogramm dient der Initialisierung der Archivierungsklasse für das Lesen von Archiven.
Die Klassen werden hierdurch darüber informiert, daß für diesen ARCHIVE_HANDLE Methoden für das Lesen von archivierten Daten bereitgestellt werden müssen.
Zu einer Archivierungsklasse können durchaus mehrere unterschiedliche Archive geöffnet worden sein. Je ARCHIVE_OPEN_FOR_* erhält die Archivierungsklasse einen eindeutigen ARCHIVE_HANDLE.
Aufrufzeitpunkte
Das ADK ruft dieses Unterprogramm immer dann auf, wenn eine neue Archivdatei zum Lesen geöffnet wurde. Da zu einem ARCHIVE_HANDLE mehrere Archivdateien gelesen werden können, wird dieses Unterprogramm je Archivdatei einmal aufgerufen, aber immer nur für die Archivdatei, die gerade gelesen werden soll.
Schnittstelle
FORM |
class_INIT_READ |
TABLES |
INIT_TAB |
|
USING |
HANDLE | ||
|
RELEASE_NUMBER | |||
|
CODE_PAGE | |||
|
NUMBER_FORMAT | |||
|
DATE |
Parameter
Der Parameter INIT_TAB bezeichnet die Tabelle, in der die Archivierungsklasse zum Zeitpunkt class_INIT_WRITE Daten abgelegt hat, die sie für die Initialisierung beim Lesen des Archivs benötigt und die für alle Datenobjekte einer Archivdatei gelten sollen. Man kann dort beispielsweise Steuerungsdaten ablegen, um bei einer späteren Auswertung des Archivs mit den passenden Steuerungsdaten zu arbeiten und nicht mit den aktuellen.
Der Parameter HANDLE enthält den ARCHIVE_HANDLE zu dem die Initialisierung ablaufen soll. Die Funktionsbausteine der Archivierungsklasse sollten sich zu diesem Handle merken, daß nur lesende Operationen mit diesem Handle erlaubt sind und alle anderen Aufrufe abweisen, indem sie die Ausnahme WRONG_ACCESS_TO_ARCHIVE auslösen.
Der Parameter RELEASE_NUMBER enthält die Release-Nummer des R/3-Systems zum Zeitpunkt, als das Archiv geschrieben wurde.
Der Parameter CODE_PAGE enthält die Bezeichnung der Codepage, die zum Zeitpunkt des Schreibens des Archivs aktiv war. Sie können diesen Parameter verwenden, um mit dem ABAP/4-Sprachelement TRANSLATE die Daten an die aktuelle Codepage anzupassen.
Über den Parameter NUMBER_FORMAT erhalten Sie das zum Zeitpunkt der Archivierung gültige Zahlenformat. Sie können diesen Parameter ebenfalls für das ABAP/4-Sprachelement TRANSLATE verwenden, um die Daten an das aktuelle Zahlenformat anzupassen.
Der Parameter DATE enthält das Datum, an dem das Archiv geschrieben wurde.