ABAP-Generierung, Loads, Includes und mehr
Auf dieser Seite
- Kontext
- 1. Grundbegriffe und Lebenszyklus
- 2. Generierung, Invalidierung und SGEN
- 3. Die PXA im Detail: Preload, Swaps und Fragmentierung
- 4. Versionierung, Session Pinning und „LOAD_*“-Dumps
- 5. Includes: Konzept, Verwendungsnachweis und Lesen des Inhalts
- 6. Öffentliche und interne ABAP-APIs für die dynamische Arbeit mit Programmen
- 7. Betrieb des Programmpuffers (PXA): Checkliste zur Optimierung
- 8. Fehleranalyse bei „LOAD_*“-Fehlern: Kurzübersicht
- 9. Praxis: der gesamte Ablauf (von der Aktivierung bis zur Ausführung)
- Anhang: nützliche Tabellen, Werkzeuge und Befehle
- Referenzen und weiterführende Literatur
Kontext
Dieser Beitrag geht praxisnah in die Tiefe: wie aus ABAP-Quelltext ausführbarer Code wird, wie dieser Code gepuffert und invalidiert wird, wie Includes behandelt werden und welche öffentlichen und internen APIs es gibt, um Programme dynamisch zu erstellen und zu analysieren.
1. Grundbegriffe und Lebenszyklus
1.1 Quelltext → Load → Ausführung
- Quelltext: Der ABAP-Quelltext wird in der Datenbank gespeichert (Tabelle
REPOSRC). - Load: Wird ein Programm aktiviert oder zum ersten Mal ausgeführt, erzeugt der Compiler einen ABAP-Load und speichert ihn in der Tabelle
REPOLOAD. Der Load ist die ausführbare Form des Programms. - Ausführung: Aus Performance-Gründen wird der Load aus
REPOLOADin den Programmpuffer (auch PXA - Program eXecution Area) im Shared Memory jedes Applikationsservers kopiert und von dort ausgeführt.
Loads werden neu generiert, wenn sich Quelltexte (oder abhängige Artefakte wie Includes oder DDIC-Typen) ändern, nach bestimmten Kernel-Updates (Änderungen des Load-Formats) oder bei der ersten Verwendung nach einem Transport, wenn kein aktueller Load vorhanden ist.
➡️ Siehe auch: Programm-Load (ABAP-Load) verstehen
1.2 Abhängigkeit vom Maschinentyp (Plattform-ID)
ABAP-Loads sind plattformabhängig. In heterogenen Landschaften finden Sie in REPOLOAD einen Load je Plattform (z. B. Windows x86_64, Linux x86_64, AIX). Aktivieren Sie ein Programm auf Server A, wird nur der Load dieser Plattform generiert; wird dasselbe Programm auf Server B mit einer anderen Plattform ausgeführt, löst das dort eine (erstmalige) Kompilierung aus. Wird eine Plattform stillgelegt, sollten die veralteten Loads bereinigt werden.
1.3 Programmpuffer (PXA)
Die PXA ist ein Cache im Shared Memory für generierte Programm-Loads, der je Applikationsserver geführt wird. Sie verwendet eine Hash-Struktur und LRU-Verdrängung; Swaps in ST02 zeigen Einträge an, die aus dem Puffer verdrängt wurden. Die richtige Dimensionierung ist entscheidend für Performance und Stabilität.
Wichtige Profilparameter und Fakten:
abap/buffersize: Gesamtgröße der PXA (kB). Erhöhen Sie sie schrittweise (z. B. um 10–20%), wenn Sie viele Swaps oder den DumpPXA_NO_FREE_SPACEsehen.abap/pxa: Betriebsart (z. B.shared,protect, Generierungsmodi). Verwenden Sie einen geschützten Modus, um Speicherüberschreibungen zu vermeiden.abap/buffer_fragments: Anzahl der Fragmente (1–16). Zu viele Fragmente können selbst bei freiem Platz Swaps verursachen; der Wert 1 kann helfen, wenn Sie ungleichmäßige Füllstände beobachten.
➡️ Siehe auch: PXA (Program eXecution Area) – ABAP-Programmpuffer und Programmpuffer (PXA) verstehen.
2. Generierung, Invalidierung und SGEN
2.1 Wann wird ein Load (neu) generiert?
- Bei der Aktivierung eines Objekts.
- Bei der ersten Ausführung, wenn in
REPOLOADoder in der PXA kein gültiger Load vorhanden ist. - Nach einer Änderung an Abhängigkeiten (Include, DDIC-Typ usw.) → die Loads der abhängigen Programme werden invalidiert und bei der nächsten Verwendung neu generiert.
- Nach einem Kernel-Wechsel, wenn sich das Load-Format ändert.
2.2 SGEN – Massengenerierung
Mit der Transaktion SGEN generieren Sie Loads nach Upgrades, Support Packages, Kernel-Wechseln oder für neue Plattformen vorab. In heterogenen Systemen führen Sie die SGEN einmal je Plattform aus. Es ist normal, dass auch nach der SGEN noch kompiliert wird (z. B. bei neu transportierten oder selten verwendeten Objekten).
3. Die PXA im Detail: Preload, Swaps und Fragmentierung
3.1 Automatischer Preload beim Serverstart
Beim Start ist die PXA leer; damit ein Kaltstart weniger langsam ist, lädt der Kernel Programme vorab, die in früheren Läufen aufgezeichnet wurden:
- Dateien im Arbeitsverzeichnis:
pxanew,pxastat, optionalpxauserload(Ihre feste Whitelist). - Ladereihenfolge:
pxauserload→pxanew→pxastat, bis zu dem Prozentsatz inabap/pxa_preload(heute standardmäßig 20%).
3.2 Swaps trotz freien Platzes?
Das deutet meist auf Fragmentierung hin. Seit 6.20 kann die PXA in mehrere Fragmente aufgeteilt sein, um den parallelen Zugriff zu verbessern. Durch das Hashing können manche Fragmente ihre Kapazitätsgrenze erreichen (Swapping), während andere kaum ausgelastet sind. Abhilfe:
- Spielen Sie Kernel-Patches ein, die das Hashing verbessert haben.
- Reduzieren Sie die Fragmente auf 1 mit
abap/buffer_fragments = 1, sodass Swaps erst auftreten, wenn der gesamte Puffer voll ist.
Ein praktischer Schwellenwert: Einige tausend Swaps pro Tag sind meist tolerierbar; >10.000 pro Tag sind ein Zeichen, abap/buffersize zu erhöhen oder die Fragmente anzupassen.
Faustregeln für die Fragmentgröße (wie vom Kernel durchgesetzt): bis zu 16 Fragmente; maximale Fragmentgröße ~4GB (vor 721) / ~2GB (seit 721); minimale Größe ~300MB (vor 721) / ~500MB (seit 721); der Kernel passt die Anzahl der Fragmente automatisch an, damit die minimale und maximale Größe eingehalten werden.
3.3 PXA prüfen und zurücksetzen
- ST02 (Bereich Programmpuffer) → Swaps und Trefferquote überwachen.
- Der Entwickler-Trace zeigt beim Start die Initialisierung der PXA und Informationen zu den Fragmenten.
- ABAP-Debugger → System areas →
PXAFRAG, um Statistiken der Fragmente anzuzeigen. - Zurücksetzen des Programmpuffers mit dem System-OK-Code
$PXA(leert anders als$SYNCkeine anderen Puffer).
4. Versionierung, Session Pinning und „LOAD_*“-Dumps
Innerhalb einer Benutzersitzung kann die Laufzeitumgebung eine bestimmte Version eines Programms, einer Klasse oder eines Interface festhalten, die bei der ersten Verwendung aktuell war. Benötigt später ein Aufrufer eine neuere Version, während die festgehaltene noch vorhanden ist (oder die angeforderte Version verdrängt wurde), können Dumps wie diese auftreten:
LOAD_PROGRAM_LOST,LOAD_PROGRAM_CLASS_MISMATCH,LOAD_CLASS_VERSION_MISMATCH,LOAD_INTF_VERSION_MISMATCHusw.- Typische Ursachen: Aktivierung einer Abhängigkeit in einer anderen Sitzung oder auf einem anderen Knoten, Verdrängung aus der PXA oder auseinanderlaufende Versionen zwischen den Servern eines Clusters. Abhilfe: Stellen Sie sicher, dass Transporte und Aktivierungen auf allen Knoten abgeschlossen sind; erwägen Sie ein Warm-up; arbeiten Sie während Deployments nicht mit veralteten Sitzungen weiter.
5. Includes: Konzept, Verwendungsnachweis und Lesen des Inhalts
5.1 Was ein Include ist
Includes sind Quelltexteinheiten (Programmtyp „I“), die beim Kompilieren textuell in Rahmenprogramme (Report/Class-Pool/Modulpool) eingefügt werden. Sie helfen, große Codebasen aufzuteilen, und sind für sich allein nicht ausführbar. (Allgemeiner Hintergrund.)
5.2 Verwendungsnachweis
Die Systemtabelle D010INC führt die Beziehungen Rahmenprogramm ↔ Include (MASTER, INCLUDE). Das ist nützlich, wenn Sie Invalidierungskaskaden und den Umfang einer Neugenerierung analysieren.
5.3 Quelltext von Includes lesen
Programmatisch werden Includes wie Reports aus REPOSRC gelesen:
DATA lt_src TYPE STANDARD TABLE OF string.
READ REPORT 'ZMY_INCLUDE' INTO lt_src.
Verwenden Sie READ REPORT für jeden ABAP-Programmtyp (auch für Includes).
6. Öffentliche und interne ABAP-APIs für die dynamische Arbeit mit Programmen
6.1 Öffentliche und freigegebene Anweisungen
READ REPORT– liest Quelltext aus dem Repository in eine interne Tabelle.SYNTAX-CHECK FOR itab ...– führt die ABAP-Syntaxprüfung für Quelltext in einer internen Tabelle aus.INSERT REPORT prog FROM itab– schreibt oder überschreibt Programmquelltext im Repository (mit Vorsicht verwenden).GENERATE SUBROUTINE POOL itab NAME prog– kompiliert einen temporären Subroutinen-Pool aus Quelltext im Speicher; nützlich für sichere Muster der dynamischen Ausführung (mit robuster Eingabeprüfung).
6.2 Interne / nicht freigegebene Anweisungen (nur zur Information)
GENERATE REPORT– kompiliert ein Repository-Programm zu einem Load. Nur intern; nicht in Anwendungscode verwenden.LOAD REPORT– lädt Teile eines Programms aus dem Repository; nur intern.DELETE REPORT– löscht Programmartefakte; nur intern (wenn es sein muss, verwenden Sie stattdessen den FunktionsbausteinRS_DELETE_PROGRAM).SCAN ABAP-SOURCE– Scanner-Schnittstelle, die ABAP-Quelltext in Tokens zerlegt; öffentlich dokumentiert und nützlich für Analysewerkzeuge.
Diese internen Anweisungen sind in der ABAP-Schlüsselwortdokumentation von SAP als „nur für den internen Gebrauch; nicht in Anwendungsprogrammen verwenden“ gekennzeichnet. Sie werden hier nur aufgeführt, um zu verdeutlichen, was auf unterer Ebene geschieht.
7. Betrieb des Programmpuffers (PXA): Checkliste zur Optimierung
Symptome → Maßnahmen
- Viele Swaps in ST02 (≫ einige tausend pro Tag)
→ Erhöhen Sieabap/buffersizeschrittweise; bestehen die Swaps trotz freien Platzes weiter, reduzieren Sie die Fragmente (abap/buffer_fragments = 1). - Dumps
PXA_NO_FREE_SPACE
→ Erhöhen Sieabap/buffersizeund prüfen Sie Anzahl und Größe der Fragmente; leeren Sie den Puffer bei Bedarf mit$PXA. - Unerklärliche Laufzeitfehler (z. B.
PXA_DESTROYED, seltsame CALL_FUNCTION_NOT_FOUND)
→ Stellen Sie den Schutz der PXA sicher (Protect-Modi vonabap/pxa) und starten Sie neu. - Kaltstarts nach Neustarts sind langsam
→ Nutzen Sie den Preload: Pflegen Siepxauserload; prüfen Sieabap/pxa_preload(derzeit standardmäßig 20%). - Ständiges Kompilieren nach der SGEN
→ Teilweise normal (neue/invalidierte Objekte, andere Plattformen). Führen Sie die SGEN je Plattform aus; prüfen Sie Transporte und Aktivierungen.
8. Fehleranalyse bei „LOAD_*“-Fehlern: Kurzübersicht
LOAD_PROGRAM_LOST– Die Programmversion in der Datenbank weicht von der ab, die die Sitzung erwartet; oft nach einer Verdrängung aus der PXA oder bei serverübergreifender Ausführung. Führen Sie ein Warm-up durch oder gleichen Sie die Versionen auf allen Knoten an.LOAD_*_MISMATCH(Klasse/Interface/Typgruppe) – Der Aufrufer erwartet eine ältere oder neuere Version als die vorhandene. Stellen Sie sicher, dass Aktivierungen und Transportimporte abgeschlossen sind; starten Sie langlebige Prozesse bei Bedarf neu.
9. Praxis: der gesamte Ablauf (von der Aktivierung bis zur Ausführung)
-
Der Entwickler aktiviert das Programm → der Load wird in
REPOLOADgeneriert (für die aktuelle Plattform). -
Erste Ausführung auf einem Applikationsserver → der Load wird in die PXA kopiert (oder kompiliert, wenn er veraltet ist oder fehlt).
-
Folgende Aufrufe verwenden die Kopie in der PXA, bis:
- sie per LRU / Swaps verdrängt wird → sie wird erneut aus
REPOLOADgeholt. - sich Quelltext oder Abhängigkeiten ändern → der PXA-Eintrag wird als alt markiert; der nächste Aufruf generiert einen neuen Load.
- sie per LRU / Swaps verdrängt wird → sie wird erneut aus
-
Serverneustart → optionaler Preload aus
pxauserload/pxanew/pxastat.
Anhang: nützliche Tabellen, Werkzeuge und Befehle
- Tabellen:
REPOSRC(Quelltext),REPOLOAD(Loads),D010INC(Include-Beziehungen). - Transaktionen:
ST02(PXA),ST22(Dumps),SGEN(Massengenerierung). - OK-Codes:
$PXA(Programmpuffer zurücksetzen),$SYNC(alle Puffer leeren – sparsam verwenden). - Traces/Debugging: Entwickler-Traces zeigen die Initialisierung der PXA und die Fragmente; der Systembereich
PXAFRAGdes ABAP-Debuggers zeigt aktuelle Statistiken der Fragmente.
Referenzen und weiterführende Literatur
- Überblick über ABAP-Load / SGEN (SAP Help Portal).
- ABAP-Schlüsselwortdokumentation:
GENERATE SUBROUTINE POOL,INSERT REPORT,READ REPORT,SYNTAX-CHECK. - Interne Anweisungen (nur zur Information):
GENERATE REPORT,LOAD REPORT,DELETE REPORT. - PXA-Preload und Dateien (
pxanew,pxastat,pxauserload); der Preload beträgt jetzt standardmäßig 20%. - Swaps trotz freien Platzes / Fragmentierung (SAP-Hinweis 1267828).
- Zu viele Swaps – Faustregeln für die Dimensionierung und Schwellenwerte (KBA 2468124).
- Bedeutung von
pxanew/pxastat(SAP-Hinweis 23642). - Parametrisierung des Programmpuffers:
abap/pxa,abap/buffersize.

