NET/MASTER Network Control Language (NCL) Reference Manual

FILE GET
Verbs
106126 Tandem Computers Incorporated 3–85
SEGMENT= n
specifies the amount of data (in bytes) to be put into the variables specified.
For mapped or delimited files, the default value is 32000. For unmapped files,
the default value is 256. You can specify a value from 1 through 32000.
VARS
input-vars-list
specifies that the record is to be split into the supplied variables. The variables
must be separated by commas. Each field of the record is placed into the
supplied variables, from left to right. If insufficient variables are provided,
some data is not available. Excess variables are given no value—they are set
to the null string. Multiple variables must be enclosed in parentheses and
separated by commas.
variable*
specifies a set of variables. See “Frequently Occurring Operands,” at the
beginning of this section, for more information.
RANGE=( start , end )
determines the range of variables specified by the VARS operand. See
“Frequently Occurring Operands,” at the beginning of this section, for more
information.
SEGMENT
see SEGMENT under the preceding ARGS operand.
Considerations
The &SYS.FILE.RC system variable reflects the result of all file operations within
NCL. NCL sets this variable on completion of the FILE GET verb, as follows:
Return Code Meaning
0 Record retrieved successfully.
4 Record not found (or end of data). No record is retrieved.
8 A file system error occurred during processing. Further information is contained
in the &SYS.FILE.ERROR system variable.
12 Not used.
16 An error occurred. Further information is contained in &SYSMSG.
It is the user’s responsibility to test the &SYS.FILE.RC system variable for errors.
There is an implicit resumption of the NCL procedure after any errors, unless the
user has coded an error handler for the FILE_ERROR condition. See the core
statements ON and RESUME in Section 2, “Core Statements.”