Guardian Procedure Calls Reference Manual

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
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
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
#include <cextdecs(POSITION)>
_cc_status POSITION ( short filenum
,__int32_t record-specifier );
• 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).
Syntax for TAL Programmers
CALL POSITION ( filenum ! i
,record-specifier ); ! i
Parameters
filenum
input
INT:value
is the number of an open file that identifies the file where the positioning is to take place.
POSITION Procedure (Superseded by FILE_SETPOSITION_ Procedure) 975