LIST and LISTEND

ANSI

The LIST and LISTEND data definitions allow referencing variables defined between the instructions by a single label in instructions supporting variable lists. The instruction uses the following formats:

(1)	[label]	LIST
(Various Data Definition Instructions)
		LISTEND
(2)	[label]	LIST	^
(3)	[label]	LIST	^,{variable}

Where:

label

Optional. A Data Definition Label.

Optional. Denotes the item as being a POINTER.

variable

Required. The name of a previously defined variable of the same type.

Flags Affected: NONE

Note the following:

LIST/LISTEND work with any background or I/O instruction (including screen and file I/O) that supports variable lists.
The LIST Data Definition Label associated is all that needs referencing within the instruction. Each variable within the list is processed individually as if it were listed within the instruction.
The only variable types that are allowed in a LIST/LISTEND structure are DIM, INIT, FORM, and INTEGER. EQUATE, and VARLIST may be in the list and are ignored. Another LIST/LISTEND or a RECORD/RECORDEND structure may be in the structure.
LIST/LISTEND structures may be nested up to ten levels deep.
The ^ denotes a Pointer Variable.
A pointer of this type can be with any instruction that supports variable lists.