Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (H-K)
Guardian Procedure Calls Reference Manual—522629-013
7-56
KEYPOSITION[X] Procedures
(Superseded by FILE_SETKEY_ Procedure)
Syntax for TAL Programmers
Parameters
filenum input
INT:value
is the number of an open file where the positioning is to take place.
key-value input
STRING:ref:* (Use with KEYPOSITION)
STRING .EXT:ref:* (Use with KEYPOSITIONX)
is the address of the buffer in the stack containing the key value (KEYPOSITION)
or the address of the buffer containing the key value (KEYPOSITIONX).
The
key-value may be in the user’s stack or, if KEYPOSITIONX is used, in an
extended data segment. The
key-value may not be in the user’s code space.
For KEYPOSITIONX, the
key-value address must be relative; it cannot be an
absolute address. If the
key-value is in an extended segment, the extended
segment must be in use at the time of the call.
key-specifier input
INT:value
designates the key field to be used as the access path for the file:
key-specifier 0, or if omitted, means use the file’s primary key as the
access path.
predefined key specifier for an alternate-key field, means
use that field as the access path.
CALL KEYPOSITION[X] ( filenum ! i
,key-value ! i
,[ key-specifier ] ! i
,[ length-word ] ! i
,[ positioning-mode ] ); ! i