Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (H-K)
Guardian Procedure Calls Reference Manual—522629-013
7-63
KEYPOSITION[X] Procedures
(Superseded by FILE_SETKEY_ Procedure)
•
the address of the key-value parameter is extended, but it is an absolute
address and the caller is not privileged.
•
Queue Files
To read a queue file in last-in, first-out order, set
positioning-mode <0:2> := 3.
There are no alternate keys for queue files; the
key-specifier parameter must
be 0 or omitted.
When using approximate or generic positioning, the
compare-length and key-
length parameters should exclude the trailing 8 bytes of the record, because this
field contains a system-generated timestamp. Consequently,
length-word is
typically used with queue files.
Example
KEY ':=' "BROWN";
COMPARE^LEN := 5;
CALL KEYPOSITION ( INFILE , KEY , , COMPARE^LEN );
Related Programming Manual
For programming information about the KEYPOSITION file-system procedure, refer to
the
Enscribe Programmer’s Guide and the Guardian Programmer’s Guide.