ABAP-Generierung, Loads, Includes und mehr

Auf dieser Seite
  1. Kontext
  2. 1. Grundbegriffe und Lebenszyklus
  3. 2. Generierung, Invalidierung und SGEN
  4. 3. Die PXA im Detail: Preload, Swaps und Fragmentierung
  5. 4. Versionierung, Session Pinning und „LOAD_*“-Dumps
  6. 5. Includes: Konzept, Verwendungsnachweis und Lesen des Inhalts
  7. 6. Öffentliche und interne ABAP-APIs für die dynamische Arbeit mit Programmen
  8. 7. Betrieb des Programmpuffers (PXA): Checkliste zur Optimierung
  9. 8. Fehleranalyse bei „LOAD_*“-Fehlern: Kurzübersicht
  10. 9. Praxis: der gesamte Ablauf (von der Aktivierung bis zur Ausführung)
  11. Anhang: nützliche Tabellen, Werkzeuge und Befehle
  12. 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 REPOLOAD in 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 Dump PXA_NO_FREE_SPACE sehen.
  • 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 REPOLOAD oder 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, optional pxauserload (Ihre feste Whitelist).
  • Ladereihenfolge: pxauserload → pxanew → pxastat, bis zu dem Prozentsatz in abap/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 $SYNC keine 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_MISMATCH usw.
  • 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 Funktionsbaustein RS_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 Sie abap/buffersize schrittweise; bestehen die Swaps trotz freien Platzes weiter, reduzieren Sie die Fragmente (abap/buffer_fragments = 1).
  • Dumps PXA_NO_FREE_SPACE
    → Erhöhen Sie abap/buffersize und 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 von abap/pxa) und starten Sie neu.
  • Kaltstarts nach Neustarts sind langsam
    → Nutzen Sie den Preload: Pflegen Sie pxauserload; prüfen Sie abap/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)

  1. Der Entwickler aktiviert das Programm → der Load wird in REPOLOAD generiert (für die aktuelle Plattform).

  2. Erste Ausführung auf einem Applikationsserver → der Load wird in die PXA kopiert (oder kompiliert, wenn er veraltet ist oder fehlt).

  3. Folgende Aufrufe verwenden die Kopie in der PXA, bis:

    • sie per LRU / Swaps verdrängt wird → sie wird erneut aus REPOLOAD geholt.
    • sich Quelltext oder Abhängigkeiten ändern → der PXA-Eintrag wird als alt markiert; der nächste Aufruf generiert einen neuen Load.
  4. 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 PXAFRAG des 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.