NET/MASTER Network Control Language (NCL) Reference Manual

FILE GET
Verbs
106126 Tandem Computers Incorporated 3–81
KEL operand establishes the starting point within the file for subsequent
retrievals. This starting point is a record whose full key value is the highest
that matches the specified partial key. Subsequent FILE GET verbs that
specify KEL return further records with successively lower full key values.
The keys of these records must still match the specified partial key.
This type of retrieval process ends when you again use the operand
KEY= keydata , when there are no more records to satisfy the specified partial
key, or when you use the END operand.
KEQ
specifies that you want to read a record whose key is equal to the previously
specified partial (generic) key in KEY= keydata . Any record that has a partial
key equal to that specified is returned. The first FILE GET that uses the KEQ
operand establishes the starting point within the file at which you want to
start retrieving records. This starting point is a record whose key value is the
lowest that matches the specified partial key. Successive FILE GET verbs that
specify KEQ continue to return records with a partial key that matches the one
specified; the full key values are successively higher.
This type of retrieval process ends when you use the operand KEY= keydata ,
or when there are no more records to satisfy the partial key, or when you use
the END operand.
KEX
specifies that you want to read a record identified by the KEY= keydata
operand. KEY= keydata must contain the full key of the required record;
otherwise, it is padded with blanks or null characters to the actual key size.
For delimited files the pad character is a space; otherwise, it is a null character.
KGE
specifies that you want to read a record whose key is greater than or equal to
the previously specified partial (generic) key in KEY= keydata . Any record
with a key (or partial key) that is equal to or greater than that specified is
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 KGE establishes the starting point within the file at which you can start
retrieving records.
This type of retrieval process ends when you again use the operand
KEY= keydata , or when the FILE GET verb reaches end-of-file, or when you
use the END operand.
KGT
specifies that a record with a key greater than the previously specified partial
key is to be returned. KGT processing ensures that a record with a key greater
than the current KEY= keydata operand is returned. The normal procedure is