NET/MASTER Network Control Language (NCL) Reference Manual

FILE GET
Verbs
3–80 106126 Tandem Computers Incorporated
operand cannot be used to start sequential accessing for entry-sequenced files.
For this file type, the starting point is always the last record in the file.
This operand cannot be used for edit files.
You must use a KEY= keydata operand if you want to position the file at a
specific point in a key-sequenced file. You can also issue a preliminary FILE
GET call using one of the generic retrieval operands. You can then use the
FILE GET OPT=BWD operand to retrieve successive records in a backward
direction.
END
specifies the end of a generic or sequential retrieval operation and resets the
current file position. Use this operand when you want to halt one retrieval
operation and start another, using a different key or partial key. This operand
can also be used to unlock, or release exclusive control of, a record obtained by
use of the UPD or UPDATE operand, without your having to actually update
the record.
The OPT=END operand forces all I/O buffers that are waiting to be
transferred to a file to be physically written. This implies that NCL carries out
any deferred update activity on the file at the time you use this operand.
You can use this operand if you want the file to appear to NCL as if it were
just opened.
FWD
specifies that sequential retrieval is to be performed in a forward direction. If
no preceding file verb has established a position within the file, retrieval
begins with the lowest keyed or first record in the file. Subsequent FILE GET
verbs return records in ascending key order until the highest keyed record has
been returned or, for entry-sequenced files, until an end-of-file is encountered.
You can retrieve records from a specific point by issuing a FILE GET verb
using either a full or a partial key, followed by a series of FILE GET
OPT=FWD statements to access the required range of records. No
KEY= keydata operand is allowed to begin sequential accessing for
entry-sequenced files. The starting point for accessing entry-sequenced files is
always the first record in the file.
You must use a KEY= keydata operand if you want to position the file at a
new specific point in a key-sequenced file. You can also issue a preliminary
FILE GET call using one of the generic retrieval operands. You can then use
the FILE GET OPT=FWD operand to retrieve successive records in a forward
direction.
KEL
specifies that you want to read a record whose key is equal to the previously
specified partial (generic) key in KEY= keydata . Any record with a partial
key that is equal to that specified is returned. The first FILE GET that uses the