NET/MASTER Network Control Language (NCL) Reference Manual

FILE GET
Verbs
3–82 106126 Tandem Computers Incorporated
to position the file at a specific record by using a KEQ call, and then continue
accessing by using KGT calls.
Alternatively, the procedure could set a partial key lower than that required
and allow the KGT call to return the next highest record. After successful
retrieval, you can obtain the full key of the record returned from the
&SYS.FILE.KEY system variable. Generic retrieval is terminated when you
use the KEY= keydata operand, the END operand, or when the FILE GET
verb reaches end-of-file.
KLE
specifies that a record key less than or equal to the previously specified partial
key is to be returned. KLE allows generic retrieval to be performed. Any
records with a key (or partial key) that is equal to or less than that specified
are returned. After successful retrieval, you can obtain the full key of the
record returned from the &SYS.FILE.KEY system variable. The first FILE GET
that uses the KLE operand establishes the starting point within the file at
which records are to be retrieved. The first record returned is the one with the
highest key that is equal to or less than the partial key supplied. Successive
FILE GET verbs also specifying the KLE operand continue to return records
with a lower key.
This type of retrieval process ends when you use the operand KEY= keydata ,
or when the start-of-file is reached, or when you use the END operand.
KLT
specifies that a record key less than the previously specified partial key is to be
returned. If a generic retrieval is in progress, the next lowest key is returned.
The procedure would normally position the file at a specific record by using a
KLE call and then would continue accessing by using KLT calls.
Alternatively, the procedure could set a partial key higher than required and
allow the KLT call to return the next lowest record. After successful retrieval,
you can obtain the full key of the record returned from the &SYS.FILE.KEY
system variable. Generic retrieval is terminated when you use the
KEY= keydata operand, or when the start-of-file is reached, or when you use
the END operand.
SAVE
specifies no action.
SEQ
specifies that sequential retrieval is to be performed. If no preceding FILE
GET has established a position within the file, FILE GET OPT=SEQ is
equivalent to FILE GET OPT=FWD. If the position has been established,
sequential retrieval begins from the current position and in the current file
direction.