Version 4.2.6
 —  Leitfaden zur Programmierung  —

Programme, Subprogramme und Subroutinen

Dieses Dokument liefert Informationen über die Objekttypen, die als Routinen, d.h. als untergeordnete Programme aufgerufen werden können.

Anmerkung:
Obwohl sie auch von anderen Objekten aufgerufen werden, sind Helproutinen und Maps genau genommen keine Routinen als solche, und werden deshalb in getrennten Dokumenten beschrieben; siehe Abschnitt Helproutinen.

Die folgenden Themen werden behandelt:


Modulare Anwendungsstruktur

Eine typische Natural-Anwendung besteht nicht aus einem einzigen großen Programm, sondern ist in mehrere Module aufgeteilt. Jedes dieser Module stellt eine funktionale Einheit von überschaubarer Größe dar, und jedes Modul ist mit den anderen Modulen der Anwendung auf eine klar definierte Weise verbunden. Dadurch ergibt sich eine übersichtlich strukturierte Anwendung, was die Entwicklung und anschließende Wartung erheblich erleichtert und beschleunigt.

Ein Hauptprogramm, das ausgeführt wird, kann andere Programme, Subprogramme, Subroutinen, Helproutinen und Maps aufrufen. Diese Objekte können ihrerseits wiederum andere Objekte aufrufen (eine Subroutine kann beispielsweise eine andere Subroutine aufrufen). Dadurch kann die modulare Struktur einer Anwendung äußerst komplex und vielschichtig werden.

Seitenanfang

Mehrere Stufen (Levels) aufgerufener Objekte

Ein aufgerufenes Objekt ist jeweils eine Stufe (Level) unter dem Objekt, von dem es aufgerufen wurde; d.h. mit jedem Aufruf eines untergeordneten Objekts erhöht sich die Stufennummer um 1.

Ein Programm, das selbständig ausgeführt wird, wird auf Stufe 1 eingeordnet; Subprogramme, Subroutinen, Maps oder Helproutinen, die direkt von diesem Hauptprogramm aufgerufen werden, sind auf Stufe 2; ruft eine dieser Subroutinen ihrerseits eine andere Subroutine auf, so ist letztere auf Stufe 3.

Wird von einem Objekt über ein FETCH-Statement ein anderes Programm aufgerufen, so wird dies als Hauptprogramm eingestuft und auf Stufe 1 eingeordnet. Ein Programm, das mit FETCH RETURN aufgerufen wird, wird dagegen als Unterprogramm eingestuft und ist eine Stufe unter dem Objekt, von dem es aufgerufen wurde.

Die folgende Abbildung enthält ein Beispiel für mehrere Stufen (Levels) aufgerufener Objekte und zeigt, wie diese Stufen gezählt werden:

Um die Level-Nummer des Objekts, das gerade ausgeführt wird, zu erfahren, können Sie die Systemvariable *LEVEL verwenden (die in der Systemvariablen-Dokumentation beschrieben ist).

Der vorliegende Abschnitt behandelt folgende Natural-Objekttypen, die als Unterprogramme (d.h. als untergeordnete Programme) aufgerufen werden können:

Helproutinen und Maps werden zwar auch von anderen Objekten aufgerufen, sind aber keine Unterprogramme im eigentlichen Sinne und werden daher in separaten Abschnitten behandelt, siehe Helproutinen und Maps.

Grundsätzlich unterscheiden sich Programme, Subprogramme und Subroutinen dadurch voneinander, wie Daten zwischen ihnen übergeben werden können und welche Data Areas sie gemeinsam benutzen können. Die Entscheidung, welchen Objekttyp Sie verwenden, ergibt sich daher im wesentlichen aus der Datenstruktur Ihrer Anwendung.

Seitenanfang

Programm

Ein Programm kann selbständig ausgeführt — und getestet — werden.

Ein Programm kann von einem anderen Objekt mit einem FETCH- oder FETCH RETURN-Statement aufgerufen werden. Das aufrufende Objekt kann ein Programm, ein Subprogramm, eine Subroutine oder eine Helproutine sein.

Mit FETCH RETURN aufgerufenes Programm

Ein mit FETCH RETURN aufgerufenes Programm kann auf die vom aufrufenden Objekt benutzte Global Data Area zugreifen.

Darüber hinaus kann jedes Programm seine eigene Local Data Area haben, in der die nur in diesem Programm verwendeten Felder definiert sind.

Ein mit FETCH RETURN aufgerufenes Programm kann jedoch keine eigene Global Data Area haben.

Mit FETCH aufgerufenes Programm

Ein mit FETCH als Hauptprogramm aufgerufenes Programm verwendet in der Regel seine eigene Global Data Area (wie in der obigen Abbildung gezeigt). Es könnte allerdings auch dieselbe Global Data Area verwenden wie das aufrufende Objekt.

Anmerkung:
Ein Source-Programm kann auch mit einem RUN-Statement aufgerufen werden; siehe RUN-Statement im der Statements-Dokumentation.

Seitenanfang

Subroutine

Die Statements, aus denen eine Subroutine besteht, müssen innerhalb eines DEFINE SUBROUTINE ... END−SUBROUTINE-Statement-Blocks definiert werden.

Eine Subroutine wird mit einem PERFORM-Statement aufgerufen.

Eine Subroutine kann eine interne Subroutine oder eine externe Subroutine sein:

Falls Sie einen Code-Block haben, der innerhalb eines Objekts mehrmals ausgeführt werden soll, ist es sinnvoll, eine interne Subroutine zu verwenden. Sie müssen diesen Block dann nur einmal innerhalb eines DEFINE SUBROUTINE-Statement-Blocks kodieren, und rufen ihn dann mit mehreren PERFORM-Statements auf.

Die folgenden Themen werden nachfolgend erörtert:

Interne Subroutine

Eine interne Subroutine kann in einem Programmierobjekt vom Typ Programm, Subprogramm, Subroutine oder Helproutine enthalten sein.

Wenn eine interne Subroutine so groß ist, dass sie die Lesbarkeit des Objekts, in dem sie enthalten ist, beeinträchtigt, kann es ratsam sein, sie in einer externen Subroutine unterzubringen, um die Lesbarkeit der Anwendung zu verbessern.

Welche Daten einer internen Subroutine zur Verfügung stehen

Eine interne Subroutine kann auf die Local Data Area und die Global Data Area des Objektes, in dem sie enthalten ist, zugreifen.

Externe Subroutine

Eine externe Subroutine — also ein Objekt vom Typ Subroutine — kann nicht selbständig ausgeführt werden. Sie muss von einem anderen Objekt aufgerufen werden. Das aufrufende Objekt kann ein Programm, ein Subprogramm, eine Subroutine oder eine Helproutine sein.

Welche Daten einer externen Subroutine zur Verfügung stehen

Eine externe Subroutine kann auf die Global Data Area des aufrufenden Objekts zugreifen.

Darüber hinaus können mit dem PERFORM-Statement Parameter von dem aufrufenden Objekt an die externe Subroutine übergeben werden. Diese Parameter müssen entweder im DEFINE DATA PARAMETER-Statement der Subroutine oder in einer von der Subroutine genutzen Parameter Data Area definiert werden.

Außerdem kann eine externe Subroutine eine eigene Local Data Area haben, in der die Felder definiert sind, die nur innerhalb der Subroutine verwendet werden.

Eine externe Subroutine kann jedoch keine eigene Global Data Area haben.

Seitenanfang

Subprogramm

Ein Subprogramm enthält in der Regel eine allgemein verfügbare Standardfunktion, die von verschiedenen Objekten in einer Anwendung benutzt wird.

Ein Subprogramm kann nicht selbständig ausgeführt werden. Es muss von einem anderen Objekt aufgerufen werden. Das aufrufende Objekt kann ein Programm, ein Subprogramm, eine Subroutine oder eine Helproutine sein.

Ein Subprogramm wird mit einem CALLNAT-Statement aufgerufen.

Wenn das CALLNAT-Statement ausgeführt wird, wird die Ausführung des aufrufenden Objekts unterbrochen und das Subprogramm ausgeführt. Nach der Ausführung des Subprogramms wird die Ausführung des aufrufenden Objekts mit dem nächsten Statement nach dem CALLNAT-Statement fortgesetzt.

Welche Daten einem Subprogramm zur Verfügung stehen

Mit dem CALLNAT-Statement können Parameter von dem aufrufenden Objekt an das Subprogramm übergeben werden. Diese Parameter sind die einzigen Daten, die dem Subprogramm vom aufrufenden Objekt zur Verfügung stehen. Sie müssen entweder im DEFINE DATA PARAMETER-Statement des Subprogramms oder in einer vom Subprogramm genutzen Parameter Data Area definiert werden.

Außerdem kann ein Subprogramm eine eigene Local Data Area haben, in der die Felder definiert sind, die innerhalb des Subprogramms verwendet werden.

Wenn ein Subprogramm seinerseits eine Subroutine oder Helproutine aufruft, kann es eine eigene Global Data Area haben und diese gemeinsam mit der Subroutine/Helproutine nutzen.

Seitenanfang

Verarbeitungsablauf beim Aufruf eines Unterprogramms

Wenn ein CALLNAT-, PERFORM- oder FETCH RETURN-Statement, das ein Unterprogramm — ein Subprogram, eine externe Subroutine bzw. ein Programm — aufruft, ausgeführt wird, wird die Ausführung des aufrufenden Objekts unterbrochen, und die Ausführung des Unterprogramms beginnt.

Die Ausführung des Unterprogramms wird fortgesetzt, bis entweder sein END-Statement erreicht ist oder die Verarbeitung des Unterprogramms durch die Ausführung eines ESCAPE ROUTINE-Statements gestoppt wird.

In beiden Fällen wird die Verarbeitung des aufrufenden Objekts mit dem nächsten Statement nach dem CALLNAT-, PERFORM- bzw. FETCH RETURN-Statement, mit dem das Unterprogramm aufgerufen wurde, fortgesetzt.

Beispiel:

Seitenanfang