Version 6.3.8 für Windows
 —  Statements  —

Definition von Local Data

Allgemeine Syntax von DEFINE DATA LOCAL:

../graphics/sbo3.gif

LOCAL

../graphics/cbo3.gif

USING

../graphics/cbo2.gif

local-data-area

../graphics/cbc2.gif

../graphics/cbc3.gif

../graphics/sbc3.gif

../graphics/dot3.gif

parameter-data-area
direct-data-definition ../graphics/dot3.gif

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 direct-data-definition-Syntax (siehe Direkte Daten-Definition)

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

Seitenanfang

Einschränkung

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

Seitenanfang

Syntax-Beschreibung

local-data-area

Geben Sie den Namen der zu referenzierenden Local Data Area (LDA) an.

Eine Local Data Area wird mit dem 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

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 Data Area Editor erstellt. Sie enthält vordefinierte Datenelemente, die in das DEFINE DATA LOCAL-Statement übernommen werden können.

direct-data-definition Siehe Direkte Daten-Definition weiter unten.
END-DEFINE Das für Natural reservierte Wort END-DEFINE muss zum Beenden des DEFINE DATA-Statements benutzt werden.

Direkte Daten-Definition

Local Data können direkt in einem Programm oder Subprogramm definiert werden. Für eine direkte Daten-Definition gilt die folgende Syntax:

level

group-name [(array-definition)]

variable-definition
view-definition
redefinition
handle-definition

Weitere Informationen siehe

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

level

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

Der Name einer Gruppe. Der Name muss den Regeln zur Definition eines Natural-Variablennamens entsprechen. Siehe auch die folgenden Abschnitte:

array-definition Mit array-definition definieren Sie die untere und obere Grenze einer Dimension in einer Array-Definition. Siehe Definition von Array-Dimensionen.
variable-definition 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 Die view-definition wird benutzt, um eine Datensicht (View) mit Bestandteilen aus einem Datendefinitionsmodul (DDM) zu definieren. Siehe View Definition.
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.
handle-definition Eine Handle identifiziert ein Dialog-Element im Code und wird in Handle-Variablen gespeichert. Siehe Handle-Definition.

Seitenanfang