Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-27
POSITION Procedure
(Superseded by FILE_SETPOSITION_ Procedure)
POSITION Procedure
(Superseded by FILE_SETPOSITION_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Related Programming Manuals
Summary
The POSITION procedure positions by primary key within relative and entry-
sequenced files. For unstructured files, the POSITION procedure specifies a new
current position.
For relative and unstructured files, POSITION 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 POSITION procedure is not used with key-sequenced files; KEYPOSITION is
used instead.
The caller is not suspended because of a call to POSITION.
A call to the POSITION procedure is rejected with an error indication if there are
incomplete nowait operations pending on the specified file.
Syntax for C Programmers
•
CEXTDECS (through the included file TNSINTH) defines 32-bit values as the
typedef __int32_t which for TNS and TNS/R compiles is defined as long and for
TNS/E compiles is defined as
int.
•
The function value returned by POSITION, which indicates the condition code, can
be interpreted by
_status_lt(), _status_eq(), or _status_gt() (defined
in the file
tal.h).
Note. This procedure is supported for compatibility with previous software and should not be
used for new development.
#include <cextdecs(POSITION)>
_cc_status POSITION ( short filenum
,__int32_t record-specifier );