Include-Programme sind global verfügbare R/3 Repository-Objekte. Sie dienen ausschließlich der Modularisierung von Quelltext und haben keine Parameterschnittstelle.

Include-Programme erfüllen eine:

• Bibliotheksfunktion zur Wiederverwendung von Quelltext in verschiedenen Programmen. Dies ist beispielsweise bei sehr langen Datendeklarationen, die in verschiedenen Programmen verwendet werden, sinnvoll.
• Ordnungsfunktion für komplexe ABAP-Programme. In Funktionsgruppen und in Modulpools werden logisch zusammengehörige Programmteile prinzipiell in Include-Programmen abgelegt. Die ABAP Development Workbench unterstützt die Erstellung komplexer Programme dadurch, indem sie die Include-Programme durch Vorwärtsnavigation automatisch anlegt und mit eindeutigen Namen versieht. Eine besondere Rolle spielt dabei das sogenannte Top-Include, das bei richtiger Namenskonvention immer in die Navigation eingebunden ist und bei der Syntaxüberprüfung paralleler Include-Bausteine mitberücksichtigt wird.

Wenn Sie selber ein Include-Programm anlegen, müssen Sie das Programmattribut I für den Typ verwenden. Sie können ein Include-Programm auch dadurch anlegen oder ändern, indem Sie auf den Namen des Programms hinter der Include-Anweisung in Ihrem ABAP-Programm doppelklicken. Die Vorwärtsnavigation der ABAP Workbench legt ein nicht vorhandenes Programm an oder öffnet ein vorhandenes.

Ein Include-Programm kann nicht unabhängig laufen, sondern muß in andere Programme eingebunden werden. Sie können Include-Programme auch in andere Include-Programme einbinden.

Die einzigen Einschränkungen beim Schreiben des Quelltextes eines Include-Programms sind:

• Include-Programme können sich nicht selbst einbinden.

• Include-Programme müssen vollständige Anweisungen enthalten.

Sie müssen sicherstellen, daß die Anweisungen eines Include-Programms logisch in den Quelltext des Programms passen, in den es eingebunden wird. Die Anwahl von Prüfen bei der Bearbeitung eines Include-Programms im ABAP-Editor reicht dafür normalerweise nicht aus.

Um sinnvolle Ergebnisse bei der Syntaxprüfung zu erhalten, müssen Sie die Prüfung für ein Programm bzw. alle Programme durchführen, in die das Include-Programm eingebunden ist. Eine Ausnahme stellt das sogenannte Top-Include dar, das auch in die Syntaxprüfung paralleler Include-Programme einbezogen wird.

Zum Einbinden eines Include-Programms in ein anderes Programm dient die Anweisung:

Die INCLUDE-Anweisung wirkt wie das Kopieren des Quelltext des Include-Programms <incl> an die Stelle der Anweisung. Während der Syntaxprüfung wird der Inhalt des Include-Programms mitausgewertet. Include-Programme werden nicht dynamisch zur Laufzeit geladen, sondern bei der Programmgenerierung aufgelöst. Nach der Generierung enthält das Laufzeitobjekt statisch alle eingebundenen Include-Programme. Bei der nachträglichen Änderung von Include-Programmen, werden die Verwender automatisch nachgeneriert.

Die INCLUDE-Anweisung muß die einzige Anweisung in der Zeile sein und kann nicht über mehrere Zeilen geschrieben werden.