Guardian Procedure Calls Reference Manual

FILE_SETPOSITION_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Summary
The FILE_SETPOSITION_ procedure supersedes the POSITION Procedure (Superseded by
FILE_SETPOSITION_ Procedure) (page 975). This procedure has the same function as the POSITION
procedure but the FILE_SETPOSITION_ procedure accepts an eight-byte record specifier. Thus, this
procedure can be used with Enscribe format 2 files and OSS files greater than approximately 2
gigabytes as well as with other files.
The FILE_SETPOSITION_ procedure positions by primary key within relative and entry-sequenced
files. For unstructured files, the FILE_SETPOSITION_ procedure specifies a new current position.
For relative and unstructured files, the FILE_SETPOSITION_ procedure sets the current position,
access path, and positioning mode for the specified file. The current position, access path, and
positioning mode define a subset of the file for subsequent access.
The FILE_SETPOSITION_ procedure is not used with key-sequenced files; the FILE_SETKEY_ procedure
is used instead.
The caller is not suspended because of a call to the FILE_SETPOSITION_ procedure. A call to the
FILE_SETPOSITION_ procedure is rejected with an error indication if there are incomplete nowait
operations pending on the specified file.
Syntax for C Programmers
#include <cextdecs(FILE_SETPOSITION_)>
short FILE_SETPOSITION_ ( short filenum
,long long recordspecifier );
Syntax for TAL Programmers
error := FILE_SETPOSITION_ ( filenum ! i
,recordspecifier ); ! i
Parameters
filenum
input
INT:value
is the number that identifies the opened file.
recordspecifier
input
INT(64):value
is the eight-byte value that specifies the new setting for the current-record and next-record
pointers.
514 Guardian Procedure Calls (F)