Pathmaker Programming Guide

Reference Summary
067868 Tandem Computers Incorporated A–13
Table A-8. Pathmaker Common Service Utility Library (Page 3 of 5)
Function Name Description Parameters Description Return Value
lfseekkey Positions a structured
logical file by key field
value and length.
LOGICAL_FILE *file
short keytag
short mode
void *compbuff
size_t complen
void *startbuff
size_t startlen
size_t compkeylen
Pointer to the logical file to position.
Identifier of the comparison key field
in the file.
Positioning mode that selects and
orders the records retrieved from
the file using one of the LFSK
constants from the header file.
Pointer to the comparison value.
Size of the comparison value, or 0 if
all records are to be retrieved.
Pointer to the starting key value, or
NULL if the file should be positioned
to the first record that matches
‘compbuff’.
Size of the starting key value, or 0 if
the file should be positioned to the
first record that matches ‘compbuff’.
Size of the comparison key field if
not unique, 0 if unique.
Short
LFE_OK is
returned if the
operation is
successful; an
error code is
returned if it fails.
lfseek Positions a logical file to a
specified record number
or byte address. (File
must be entry-sequenced,
relative structured, or
unstructured disk file.)
LOGICAL_FILE *file
unsigned long addr
Pointer to the logical file to position.
Record number or byte address.
Short
LFE_OK is
returned if the
operation is
successful; an
error code is
returned if it fails.
lftell Returns the current
record number or byte
address of a logical file.
(File must be entry-
sequenced, relative
structured, or
unstructured disk file.)
LOGICAL_FILE *file Pointer to the logical file. Unsigned long
If operation fails,
error code is stored
in logical file
descriptor,
message in reply
header.
lfread Reads the next record in
the current access path.
LOGICAL_FILE *file
void *buffer
size_t bufflen
Pointer to the logical file to read.
Pointer to the buffer that receives
the record.
Maximum size of the receiving
buffer.
Short
LFE_OK is
returned if the
operation is
successful;
LFE_EOF is
returned if end-of-
file; an error code
is returned if it fails.