Session-Parameter - Einführung

#### Search Results

Search

# Session-Parameter - Einführung

Folgende Themen werden behandelt:

- Benutzung von Session-Parametern

- Setzen von Session-Parametern

- Verarbeitung von Session-Parametern

## Benutzung von Session-Parametern

IIn Natural werden Session-Parameter verwendet:

- um bestimmte Zeichen festzulegen,

- um Verarbeitungszeitgrenzen festzulegen,

- um Reaktionen auf bestimmte Bedingungen festzulegen,

- um bestimmte Maximal- bzw. Minimalgrößen festzulegen,

- um bestimmte Aspekte der Reportformatierung festzulegen.

Bei der Installation von Natural legt der Natural-Administrator für einige dieser Parameter bestimmte Standardwerte fest, die dann für alle Natural-Benutzer gelten.

Die für Ihre Natural-Session gültigen Parameterwerte können Sie sich ansehen, wenn Sie das Systemkommando `GLOBALS` eingeben. Nähere Einzelheiten hierzu finden Sie in der Systemkommandos-Dokumentation).

## Setzen von Session-Parametern

Es gibt verschiedene Möglichkeiten, die Werte der Session-Parameter zu setzen:

- über das Standard-Natural-Parametermodul, das bei der Installation von Natural angelegt wird;

- über dynamische Parameter beim Aufrufen einer Natural-Session (wie in der Operations-Dokumentation beschrieben);

- mit dem Systemkommando `GLOBALS`;

- mit dem Statement `SET GLOBALS` (nur im Reporting Mode);

- mit dem Statement `FORMAT`;

- mit Statements wie `INPUT`, `DISPLAY`, `WRITE`, in denen bestimmte Parameter verarbeitet werden;

- über Terminalkommandos.

Statt der Parameterwerte `ON` und `OFF` können Sie wahlweise auch die Werte `T` (True = wahr) bzw. `F` (False = falsch) verwenden.

### Ändern von Parameterwerten auf Session-Ebene — Das GLOBALS-Kommando

Einige der vom Natural-Administrator festgelegten Standardwerte können Sie für die Dauer einer Natural-Session ändern.

Sie können die Parameterwerte innerhalb einer Session ändern, indem Sie das folgende Systemkommando verwenden:

    GLOBALS

Wenn Sie das `GLOBALS`-Kommando ausführen, erhalten Sie einen Schirm, auf dem die für Ihre laufende Session derzeit gültigen Parameterwerte angezeigt werden. Auf diesem Schirm können Sie auch die Werte ändern, die nicht Ihren Anforderungen entsprechen.

Die mit einem `GLOBALS`-Kommando festgelegten Parameterwerte gelten bis zum Ende der jeweiligen Natural-Session (und gelten für jedes im Laufe der Session gespeicherte Objekt), es sei denn, Sie ändern sie wieder durch ein anderes `GLOBALS`-Kommando.

### Ändern von Parameterwerten auf Programm-Ebene — Das FORMAT-Statement

Einige Parameter-Standardwerte können Sie für die Dauer eines Programms (Reports) ändern. Dies geschieht mit einem `FORMAT`-Statement im jeweiligen Programm, welches die betreffenden session-weit gültigen Parameter überschreibt.

#### Beispiel für ein FORMAT-Statement:

    FORMAT AL=10 HC=R

Die mit einem `FORMAT`-Statement angegebenen Parameterwerte gelten bis zum Ende des ausgeführten Programms, wenn sie nicht vorher im Programm durch ein anderes `FORMAT`-Statement geändert werden. Sie können allerdings nur einen Teil der Session-Parameter programmspezifisch umsetzen.

Andererseits gibt es eine Reihe von Parametern, die Sie nur auf Programm-Ebene setzen können, nicht aber auf Session-Ebene. Dies sind überwiegend Parameter, die sich auf die Formatierung eines Reports auswirken.

### Ändern von Parameterwerten auf Statement-Ebene

Die meisten Parameter, die Sie mit einem `FORMAT`-Statement festlegen können, können Sie auch auf Statement-Ebene setzen, zum Beispiel bei einem `DISPLAY`-, `WRITE`-, `INPUT`- oder `REINPUT`-Statement, und zwar durch Einfügen des Parameters (in Klammern) hinter dem Statement-Namen.

#### Beispiel:

    DISPLAY (SF=4) NAME JOB-TITLE CURR-CODE SALARY

Ein auf Statement-Ebene angegebener Parameterwert gilt nur für das jeweilige Statement, und zwar vor allen auf anderen Ebenen für diesen Parameter angegebenen Werten.

### Ändern von Parameterwerten auf Feld-Ebene

Innerhalb eines `DISPLAY`-, `WRITE`-, `INPUT`- oder `REINPUT`-Statements können Sie bestimmte Parameterwerte noch feldspezifisch festlegen, indem Sie den Parameterwert für ein einzelnes Feld oder Ausgabe-Element unmittelbar hinter dem betreffenden Feld (in Klammern) angeben.

#### Beispiel:

    DISPLAY NAME (AL=10) JOB-TITLE CURR-CODE SALARY

Dieser Wert gilt dann nur für dieses Feld, und zwar vor allen auf anderen Ebenen für diesen Parameter angegebenen Werten. Die feldspezifische Angabe von Parameterwerten ist allerdings nur für einen Teil der auf Statement-Ebene beeinflussbaren Parameter möglich.

## Verarbeitung von Session-Parametern

Session-Parameter, die in den Statements `DISPLAY`, `FORMAT`, `PRINT`, `INPUT`, `REINPUT`, `WRITE`, `WRITE TITLE` oder `WRITE TRAILER` gesetzt werden, werden während der Programmkompilierung verarbeitet und sind daher in dem betreffenden Objektmodul enthalten.

Bei der Auswertung der Parameterwerte gilt folgende Hierarchie:

1. für einzelne Felder/Elemente gesetzte Parameter (höchste Priorität)

2. auf Statement-Ebene gesetzte Parameter

3. mit einem `FORMAT`-Statement gesetzte Parameter

4. die Standardwerte der Parameter (niedrigste Priorität)

Mit einem `SET GLOBALS`-Statement gesetzte Parameter bewirken eine Veränderung der Laufzeit-Umgebung. Sie gelten solange, bis sie mit einem weiteren `SET GLOBALS`-Statement (oder `GLOBALS`-Systemkommando) geändert werden.

### On this page

- Benutzung von Session-Parametern
- Setzen von Session-Parametern
- Verarbeitung von Session-Parametern