LINC Programming Reference Manual - Public Support Login - Unisys

LOOK.UP; (LU;) Commands
LOOK.UP; (LU;) Commands
The LOOK.UP; command variants are used to read data into memory from the LINC
database, without the use of a Profile.
The particular variant controls the number and manner in which records are read into
memory. Once a record is in memory, it may be manipulated by your associated logic. All
Data items of the record are available to the logic (unless, on MCP based LINC Systems,
the KEYONLY; command option is specified).
Variants of the LOOK.UP; Command
The variants of the LOOK.UP; command are summarized in the following table. More
detailed explanations are given under separate command descriptions for each variant,
following this general command description.
Variant Summary of Operation
LOOK.UP; Reads the single Component record for the specified Ordinate value.
LOOK.UP; EVERY Creates a loop that reads each record from a Component, Memo
Component, or the Event dataset.
LOOK.UP; FROM Creates a loop that reads each record from a Component, starting
from the specified Ordinate value.
LOOK.UP; GROUP Creates a loop that reads each record from a Component, between
specified Ordinate values. The order is specified as part of the
command.
Where a loop is created by a variant of the LOOK.UP; command, any logic contained in this
loop is executed for each record read. An END; or END.EXIT; command must terminate
the loop.
Setting of GLB.STATUS
In Host LINC
If a command fails to retrieve any record (that is, no record satisfies the specified criteria),
all variants of the LOOK.UP; command with one exception, set GLB.STATUS to *****. The
exception is a single LOOK.UP; command in Ispec logic, which does not set GLB.STATUS.
If you use the GLB.STATUS; command with a single LOOK.UP; command in Ispec logic,
then the named data item is set.
If any record is retrieved, GLB.STATUS is not set by a LOOK.UP; command. GLB.STATUS
is not set when end-of-file is detected.
v 1-153