Net.Data Verwaltung und Programmierung für OS/400

Geltungsbereich von Variablen

Eine Kennung, die eine Variable oder einen Funktionsaufruf darstellt, wird sichtbar, d. h. im Makro verwendbar, wenn sie deklariert oder von Net.Data verfügbar gemacht wurde. Der Bereich, in dem eine Kennung sichtbar ist, wird als Geltungsbereich der Kennung bezeichnet. Es gibt die folgenden fünf Geltungsbereiche:

• Global

  Eine Kennung hat einen globalen Geltungsbereich, wenn auf sie von jeder Stelle der Makrodatei aus verwiesen werden kann. Kennungen mit globalem Geltungsbereich sind:

  • Integrierte Net.Data-Funktionen
  • Formulardaten
  • URL-Daten
  • Variablen, die innerhalb eines HTML-Blocks verfügbar gemacht werden

• Makrodatei

  Eine Kennung hat den Geltungsbereich einer Makrodatei, wenn ihre Deklaration außerhalb aller Blöcke erfolgt. Ein Block beginnt mit einer öffnenden geschweiften Klammer ({) und endet mit einem Prozentzeichen und einer schließenden geschweiften Klammer (%}). (Beachten Sie hierbei, daß DEFINE-Blöcke von dieser Definition ausgeschlossen sind und als separate DEFINE-Anweisungen behandelt werden sollten.) Eine Kennung mit dem Geltungsbereich einer Makrodatei ist von der Stelle, an der sie deklariert wird, bis zum Ende der Makrodatei sichtbar.

• FUNCTION-Block bzw. MACRO_FUNCTION-Block

  Eine Kennung hat den Geltungsbereich FUNCTION-Block, wenn folgendes zutrifft:

  • Die Kennung wird in der Parameterliste der Funktionsdefinition deklariert.

    Wenn eine Kennung mit dem gleichen Namen bereits außerhalb der Funktionsdefinition vorhanden ist, verwendet Net.Data die Kennung aus der Funktionsparameterliste innerhalb des Funktionsblocks.

  • Die Kennung wird im Funktionsblock angelegt und vor dem Funktionsaufruf weder deklariert noch initialisiert.

  Eine Kennung hat nicht den Geltungsbereich FUNCTION-Block, wenn sie außerhalb der Funktion deklariert oder initialisiert wurde und nicht in der Funktionsparameterliste deklariert wird. Wenn die Kennung innerhalb eines Funktionsblocks verwendet wird, behält sie den Wert bei, der ihr vor dem Funktionsaufruf zugeordnet wurde. Wird sie innerhalb des Funktionsblocks aktualisiert, behält die Kennung den neuen Wert nach dem Funktionsaufruf bei.

• REPORT-Block

  Eine Kennung hat den Geltungsbereich REPORT-Block, wenn auf sie nur innerhalb eines REPORT-Blocks verwiesen werden kann (zum Beispiel Tabellenspaltennamen N1, N2, ..., Nn). Nur solche Variablen, die Net.Data implizit als Teil der Tabellenverarbeitung definiert, können den Geltungsbereich REPORT-Block haben. Alle anderen verfügbar gemachten Variablen haben den Geltungsbereich FUNCTION-Block.

• ROW-Block

  Eine Kennung hat den Geltungsbereich ROW-Block, wenn auf sie nur innerhalb eines ROW-Blocks verwiesen werden kann (zum Beispiel Tabellenwertnamen V1, V2, ..., Vn). Nur solche Variablen, die Net.Data implizit als Teil der Tabellenverarbeitung definiert, können den Geltungsbereich ROW-Block haben. Alle anderen verfügbar gemachten Variablen haben den Geltungsbereich FUNCTION-Block.

Wenn auf eine Variable verwiesen wird, wird sie durch den Wert der Kennung ersetzt. Wenn ein Verweis auf eine Variable keinen zugeordneten Wert hat oder ein Funktionsaufruf keinen Wert zurückgibt, wird der Verweis durch eine leere Zeichenfolge ersetzt.