READ-VARIABLE Assign values to variables

The READ-VARIABLE command is used to read data from an input medium and to store the data in a variable. The data is read record by record. The operation is terminated when the string *END-OF-CMD or the end of a file (EOF) is encountered.

READ-VARIABLE Alias: RDV

VARIABLE-NAME = *BY-INPUT(...) / *LIST(...) / list-poss(2000): <composed-name 1..255>
	*BY-INPUT(...)
			PREFIX = *NONE / <composed-name 1..255>
	*LIST(...)
			LIST-NAME = <composed-name 1..255>
			,WRITE-MODE = *REPLACE / *EXTEND
,STRING-QUOTES = *OPTIONAL / *YES / *NO
,INPUT = *TERMINAL(...) / <filename 1..54 without-gen-vers>(...) / *VARIABLE(...) /
				*LIBRARY-ELEMENT(...) / *SYSDTA(...)
	*TERMINAL(...)
			PROMPT-STRING = '>>' / <text 0..1800 with-low>
			,SECRET-INPUT = *NO / *YES
	<filename 1..54 without-gen-vers>(...)
			REMOVE-KEY = *YES / *NO
			,BEGIN-RECORD = *FIRST / <integer 1..2147483647>
			,END-RECORD = *LAST / <integer 1..2147483647>
			,BEGIN-COLUMN = *FIRST / <integer 1..2147483647>
			,END-COLUMN = *LAST / <integer 1..2147483647>
			,PATTERN = *NONE / <c-string 0..1800 with-low>
			,PATTERN-TYPE = *STRING / *REGULAR-EXPRESSION
	*VARIABLE(...)
			VARIABLE-NAME = <composed-name 1..255>
	*LIBRARY-ELEMENT(...)
			LIBRARY = <filename 1..54 without-vers>
			,ELEMENT = <composed-name 1..64>(...)
				<composed-name 1..64>(...)
						VERSION = *HIGHEST-EXISTING / <composed-name 1..24>
			,TYPE = S / <alphanum-name 1..8>
	*SYSDTA(...)
			REMOVE-KEY = *YES / *NO

Return codes

It is possible that part of the command has already been processed and executed before the error occurs. In this case, the result of the command is not guaranteed.

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	No error
2	0	SDP2000	Warning: not all elements of the input list could be processed successfully. Guaranteed message: SDP2000
	1	CMD0202	Syntax error
	1	SDP0118	Command in false context
	3	CMD2203	Incorrect syntax file
	32	CMD0221	System error (internal error)
	64	SDP0089	INPUT error
	64	SDP0091	Semantic error Guaranteed messages: SDP1008
	64	SDP2001	None of the elements could be read in
	130	SDP0099	No further address space available