FREE-VARIABLE Delete contents of variable

The FREE-VARIABLE command deletes the contents of one or more S variables.

The FREE-VARIABLE command can be used on simple and composed variables. One or more elements can be deleted from list variables with this command. For variables with a dynamic structure, not only the contents are deleted, but also the element itself.

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

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	No error
1	0	CMD0001	Warning: no elements deleted; variable has already been deleted
	1	CMD0202	Syntax error
	3	CMD2203	Incorrect syntax file
	32	CMD0221	System error (internal error)
	64	SDP0091	Semantic error Guaranteed messages: SDP1008
	130	SDP0099	No further address space available