Definition von Local Data

Allgemeine Syntax von DEFINE DATA LOCAL:

`DEFINE DATA`
`LOCAL`	`USING`	`local-data-area`
		`parameter-data-area`
	`local-data-definition`
`END-DEFINE`

Dieses Dokument behandelt folgende Themen:

Funktion
Einschränkung
Syntax-Beschreibung

Eine Erläuterung der in dem Syntax-Diagramm verwendeten Symbole entnehmen Sie dem Abschnitt Syntax-Symbole.

Funktion

Das DEFINE DATA LOCAL-Statement dient zur Definition der Datenelemente, die ausschließlich von einem einzelnen Natural-Modul in einer Anwendung benutzt werden. Diese Elemente oder Felder können auf folgende Weise definiert werden:

entweder innerhalb des DEFINE DATA LOCAL-Statements selbst unter Verwendung der local-data-definition-Syntax (siehe Lokale Daten-Definition)

oder außerhalb des Programms in einer separaten LDA (Local Data Area) oder einer PDA (Parameter Data Area), wobei das DEFINE DATA LOCAL USING-Statement diese Data Area referenziert.

Einschränkung

Die LDA und die sie referenzierenden Objekte müssen in derselben Library (oder in einer Steplib) enthalten sein.

Syntax-Beschreibung

Syntax-Element-Beschreibung:

Syntax-Element	Beschreibung
`local-data-area`	LDA-Name: Geben Sie den Namen der zu referenzierenden Local Data Area (LDA) an. Eine Local Data Area wird mit dem Datenbereich-Editor (Data Area Editor) erstellt. Sie enthält vordefinierte Datenelemente, die in das `DEFINE DATA LOCAL`-Statement übernommen werden können. Sie können mehr als eine Data Area referenzieren; in diesem Fall müssen Sie die reservierten Wörter `LOCAL` und `USING` wiederholen, zum Beispiel: DEFINE DATA LOCAL USING DATX_L LOCAL USING DATX_P ... END-DEFINE ; Weitere Informationen siehe auch Felder in einer separaten Data Area und Local Data Area und Local Data Area, Beispiel 2 im Leitfaden zur Programmierung.
`parameter-data-area`	PDA-Name: Geben Sie den Namen der zu referenzierenden Parameter Data Area (PDA) an. Anmerkung: Eine mit `DEFINE DATA LOCAL` referenzierte Data Area kann auch eine Parameter Data Area (PDA) sein. Durch Benutzung einer PDA als LDA können Sie sich die zusätzliche Mühe sparen, eine LDA zu erstellen, die dieselbe Struktur wie die PDA hat. Eine Parameter Data Area wird mit dem Datenbereich-Editor (Data Area Editor) erstellt. Sie enthält vordefinierte Datenelemente, die in das `DEFINE DATA LOCAL`-Statement übernommen werden können.
`direct-data-definition`	Lokale Daten-Definition: Im Abschnitt Lokale Daten-Definition finden Sie Informationen, wie Sie Elemente oder Felder innerhalb des Statements selbst definieren können, das heisst, ohne dazu eine LDA oder eine PDA zu benutzen.
`END-DEFINE`	Ende des DEFINE DATA-Statements: Das für Natural reservierte Wort `END-DEFINE` muss zum Beenden des `DEFINE DATA`-Statements benutzt werden.

Lokale Daten-Definition

Lokale Daten können direkt in einem Programm oder Subprogramm definiert werden. In diesem Fall gilt folgende Syntax:

level

group-name [(array-definition)]
variable-definition
view-definition
redefinition

Weitere Informationen siehe

Beispiel 1 - DEFINE DATA LOCAL (Lokale Daten-Definition)
Definition von Feldern in einem DEFINE DATA-Statement im Leitfaden zur Programmierung
Local Data Area, Beispiel 1 im Leitfaden zur Programmierung

Syntax-Elementbeschreibung für die direkte Daten-Definition:

Syntax-Element	Beschreibung
`level`	Level-Nummer: Dies ist eine ein- oder zweistellige Zahl im Bereich von 01 bis 99 (die vorangestellte 0 ist nicht erforderlich), die in Verbindung mit der Gruppierung von Feldern verwendet wird. Felder mit einer Level-Nummer von 02 an aufwärts werden als Teil einer unmittelbar vorangehenden Gruppe mit einer jeweils nächstniedrigeren Level-Nummer betrachtet. Durch die Definition einer Gruppe (die auch nur aus einem Feld bestehen kann) ist es möglich, durch Angabe lediglich des Gruppennamens eine ganze Reihe von aufeinanderfolgenden Feldern gleichzeitig zu referenzieren. Bei manchen Statements (`CALL`, `CALLNAT`, `RESET`, `WRITE` usw.) können Sie den Gruppennamen als Aufrufnamen angeben, um die in der Gruppe enthaltenen Felder zu referenzieren. Eine Gruppe kann aus anderen Gruppen bestehen. Bei der Vergabe von Level-Nummern für eine Gruppe darf kein Level ausgelassen werden. Eine `view-definition` muss immer auf Level 1 definiert werden.
`group-name`	Gruppenname: Der Name einer Gruppe. Der Name muss den Regeln zur Definition eines Natural-Variablennamens entsprechen. Siehe auch die folgenden Abschnitte: Namen von Benutzervariablen in der Dokumentation Natural benutzen. Datenstrukturen qualifizieren im Leitfaden zur Programmierung.
`array-definition`	Definition von Array-Dimensionen: Mit `array-definition` definieren Sie die untere und obere Grenze einer Dimension in einer Array-Definition. Siehe Definition von Array-Dimensionen.
`variable-definition`	Definition einer Variablen: Die `variable-definition` dient zur Definition einer einzelnen Variablen (oder Feldes), die aus einem Wert (Skalar) oder mehreren Werten (Array) bestehen kann. Siehe Definition von Variablen.
`view-definition`	View-Definition: Die `view-definition` wird benutzt, um eine Datensicht (View) mit Bestandteilen aus einem Datendefinitionsmodul (DDM) zu definieren. Siehe View-Definition.
`redefinition`	Redefinition: Eine `redefinition` kann zur Redefinition einer Gruppe, eines Views, eines DDM-Felds oder eines einzelnen Feldes oder einer einzelnen Variablen benutzt werden (d.h. Skalar oder Array). Siehe Redefinition.