Anwendungsgebiet: PROCEDURE
Kommandobeschreibung
DELETE-VARIABLE löscht die Deklaration einer S-Variablen innerhalb des aktuellen Geltungsbereichs, d.h. auch Deklarationen von importierten Task-Variablen.
Der Name der S-Variablen kann danach nicht länger benutzt werden und der Wert ist gelöscht.
Es können einfache und zusammengesetzte Variablen gelöscht werden, aber nicht einzelne Elemente von zusammengesetzten Variablen.
Folgende Variablendeklarationen können mit DELETE-VARIABLE nicht gelöscht werden:
Prozedurparameter
Elemente von zusammengesetzten Variablen
Systemvariablen (z.B. SYSSWITCH)
Behälter-JVs
nicht-permanente Behältervariablen
Strukturlayouts
Format
DELETE-VARIABLE |
VARIABLE-NAME = <structured-name 1..20 with-wild(40)> / list-poss(2000): <structured-name 1..20> |
Operandenbeschreibung
VARIABLE-NAME =
Name der S-Variablen, die gelöscht werden soll.
VARIABLE-NAME = <structured-name 1..20 with-wild(40)>
Alle S-Variablen, die dieses Suchmuster erfüllen, werden gelöscht.
VARIABLE-NAME = list-poss(2000):<structured-name 1..20>
Liste von S-Variablen, die gelöscht werden sollen.
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
| 0 | CMD0001 | Ohne Fehler | |
| 1 | 0 | CMD0001 | Warnung; keine Aktion durchgeführt |
| 1 | CMD0202 | Syntaxfehler | |
| 3 | CMD2203 | Falsche Syntaxdatei | |
| 32 | CMD0221 | Systemfehler (interner Fehler) | |
| 64 | CMD0216 | Erforderliches Privileg fehlt | |
| 64 | SDP0091 | Semantikfehler | |
| 130 | SDP0099 | Kein Adressraum mehr verfügbar |
Hinweis
Der Fehler SDP1098 erscheint nicht bei Angaben von Variablennamen mit Wildcards.
Beispiel 1
Eingabe
/DECLARE-VARIABLE PROBE /SET-VARIABLE PROBE=15 /SHOW-VARIABLE PROBE
Ausgabe
PROBE = 15
Eingabe
/DELETE-VARIABLE PROBE /SHOW-VARIABLE PROBE
Ausgabe
SDP1008 VARIABLE/LAYOUT 'PROBE' EXISTIERT NICHT SDP0234 OPERAND 'NAME' UNVOLLSTAENDIG
Beispiel 2
Eingabe
/DELETE-VARIABLE SYS* "Es wird keine Fehlermeldung zurückgegeben"/DELETE-VARIABLE SYSSWITCH
Ausgabe
SDP1098 AUF DIE VARIABLE 'SYSSWITCH' DARF KEIN DELETE-VARIABLE ANGEWENDET WERDEN