FREE-VARIABLE Inhalt einer Variablen löschen

Das Kommando FREE-VARIABLE löscht den Inhalt einer oder mehrerer S-Variablen.

Das Kommando FREE-VARIABLE kann auf einfache und zusammengesetzte Variable angewendet werden. Bei einer Listenvariablen können gezielt ein oder mehrere Elemente gelöscht werden. Bei einer Variablen mit dynamischer Struktur werden nicht nur die Inhalte der Elemente gelöscht, sondern auch die Elemente selbst.

FREE-VARIABLE

VARIABLE-NAME = <structured-name 1..20 with-wild(40)> / *LIST(...) /
				list-poss(2000): <composed-name 1..255>
	*LIST(...)
			LIST-NAME = <composed-name 1..255>
			,FROM-INDEX = *FIRST / *LAST / <integer 1..214783647>
			,NUMBER-OF-ELEMENTS = 1 / *REST / <integer 1..214783647>
,DESTROY-CONTAINER-JV = *NO / *YES

Kommando-Returncode

(SC2)	SC1	Maincode	Bedeutung
	0	CMD0001	Ohne Fehler
1	0	CMD0001	Warnung; keine Elemente gelöscht; Variable ist bereits gelöscht
	1	CMD0202	Syntaxfehler
	3	CMD2203	Falsche Syntaxdatei
	32	CMD0221	Systemfehler (interner Fehler)
	64	SDP0091	Semantikfehler garantierte Meldung: SDP1008
	130	SDP0099	Kein Adressraum mehr verfügbar