RESET

#### Search Results

Search

# RESET

`RESET` [`INITIAL`] operand1

Dieses Dokument behandelt folgende Themen:

- Funktion

- Syntax-Beschreibung

- Beispiel

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

Verwandte Statements: `ADD` | `COMPRESS` | `COMPUTE` | `DIVIDE` | `EXAMINE` | `MOVE` | `MOVE ALL` | `MULTIPLY` | `SEPARATE` | `SUBTRACT`

Gehört zur Funktionsgruppe: Arithmetische Funktionen und Datenzuweisungen

## Funktion

Das `RESET`-Statement wird benutzt, um den Wert eines Feldes zurückzusetzen.

- Mit dem Statement `RESET` (ohne `INITIAL`) können Sie in Abhängigkeit von seinem Format den Inhalt jedes angegebenen Feldes auf seinen Standard-Ausgangswert zurücksetzen.

- Mit `RESET INITIAL` können Sie jedes Feld auf einen im `DEFINE DATA`-Statement definierten Ausgangswert zurücksetzen.

  Bei einem ohne `INIT`-Klausel im `DEFINE DATA`-Statement deklarierten Feld hat `RESET INITIAL` die gleiche Auswirkung wie `RESET` (ohne `INITIAL`).

Anmerkungen:

1. Ein mit einer `CONSTANT`-Klausel im `DEFINE DATA`-Statement deklariertes Feld kann in einem `RESET`-Statement nicht referenziert werden, da sein Inhalt nicht geändert werden kann.
2. Im Reporting Mode kann das `RESET`-Statement auch verwendet werden, um eine Variable zu definieren, vorausgesetzt dass das Programm kein `DEFINE DATA LOCAL`-Statement enthält.

## Syntax-Beschreibung

Operanden-Definitionstabelle:

Operand | Mögliche Struktur | Mögliche Formate | Referenzierung erlaubt | Dynam. Definition
--- | --- | --- | --- | ---
operand1 |  | S | A | G | M | A | U | N | P | I | F | B | D | T | L | C | G | O | ja | ja

Syntax-Element-Beschreibung:

Syntax-Element | Beschreibung
--- | ---
`RESET operand1` | Zurücksetzen auf Nullwert: `RESET` (ohne `INITIAL`) setzt jedes angegebene Feld (operand1) auf seinen Standard-Ausgangswert. Wenn operand1 eine dynamische Variable ist, wird sie auf einen Nullwert zurückgesetzt, und zwar mit der Länge, die die Variable zum Zeitpunkt der Ausführung des `RESET`-Statements hat. Die aktuelle Länge einer dynamischen Variable kann mittels der Systemvariable `*LENGTH` ermittelt werden. Allgemeine Informationen über dynamische Variablen finden Sie in dem Abschnitt Dynamische und große Variablen benutzen.
`RESET INITIAL` `operand1` | Zurücksetzen auf Ausgangswert: Mit `RESET INITIAL` werden die angegebenen Felder (operand1) auf die für sie im `DEFINE DATA`-Statement definierten Ausgangswerte zurückgesetzt. Wenn für ein Feld kein Ausgangswert definiert ist, wird es abhängig von seinem Format auf einen Standard-Ausgangswert (siehe unten) zurückgesetzt. Wenn eine dynamische Variable benutzt wird, wird die Systemvariable `*LENGTH` auf Null gesetzt, wenn kein Ausgangswert definiert ist. Wenn Sie `RESET INITIAL` auf ein Array anwenden, müssen Sie es auf das gesamte Array (wie im `DEFINE DATA`-Statement definiert) anwenden; `RESET INITIAL` für einzelne Array-Ausprägungen ist nicht möglich. Ein `RESET INITIAL` von aus einer Redefinition hervorgehenden Feldern ist ebenfalls nicht möglich. `RESET INITIAL` wird für eine dynamische Variable benutzt. Auf Datenbankfelder ist `RESET INITIAL` nicht anwendbar.

## Beispiel

    ** Example 'RSTEX1': RESET (with/without INITIAL)
    ************************************************************************
    DEFINE DATA LOCAL
    1 EMPLOY-VIEW VIEW OF EMPLOYEES
      2 NAME
    1 #BINARY  (B4) INIT <1>
    1 #INTEGER (I4) INIT <5>
    1 #NUMERIC (N2) INIT <25>
    END-DEFINE
    *
    LIMIT 1
    READ EMPLOY-VIEW
      /*
      WRITE NOTITLE 'VALUES BEFORE RESET STATEMENT:'
      WRITE / '=' NAME '=' #BINARY '=' #INTEGER '=' #NUMERIC
      /*
      RESET NAME #BINARY #INTEGER #NUMERIC
      /*
      WRITE /// 'VALUES AFTER  RESET STATEMENT:'
      WRITE / '=' NAME '=' #BINARY '=' #INTEGER '=' #NUMERIC
      /*
      RESET INITIAL #BINARY #INTEGER #NUMERIC
      /*
      WRITE /// 'VALUES AFTER  RESET INITIAL STATEMENT:'
      WRITE / '=' NAME '=' #BINARY '=' #INTEGER '=' #NUMERIC
      /*
    END-READ
    END

Ausgabe des Programms `RSTEX1`:

    VALUES BEFORE RESET STATEMENT:

    NAME: ADAM                 #BINARY: 00000001 #INTEGER:           5 #NUMERIC:
     25

    VALUES AFTER  RESET STATEMENT:

    NAME:                      #BINARY: 00000000 #INTEGER:           0 #NUMERIC:
      0

    VALUES AFTER  RESET INITIAL STATEMENT:

    NAME:                      #BINARY: 00000001 #INTEGER:           5 #NUMERIC:
     25

### On this page

- Funktion
- Syntax-Beschreibung
- Beispiel