Definition von Local Data

Allgemeine Syntax von DEFINE DATA LOCAL:

DEFINE DATA
  LOCAL

../graphics/sbo3.gif

USING

../graphics/cbo2.gif

local-data-area

../graphics/cbc2.gif

../graphics/sbc3.gif

parameter-data-area
local-data-definition ../graphics/dot3.gif
END-DEFINE

Dieses Dokument behandelt folgende Themen:

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

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:

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.