Guardian Procedure Calls Reference Manual

POSITIONEDIT Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Example
Related Programming Manual
Summary
The POSITIONEDIT procedure sets the next record number to a specified value for a specified file.
POSITIONEDIT is an IOEdit procedure and can only be used with files that have been opened by
OPENEDIT or OPENEDIT_.
Syntax for C Programmers
#include <cextdecs(POSITIONEDIT)>
short POSITIONEDIT ( short filenum
,__int32_t record-number );
• 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.
Syntax for TAL Programmers
error := POSITIONEDIT ( filenum ! i
,record-number ); ! i
Parameters
filenum
input
INT:value
specifies the file number of the open file for which the next record number is to be set.
record-number
input
INT(32):value
specifies the value to which the file's next record number is to be set. This value is 1000 times
the EDIT line number of the intended record. You can specify -1 to indicate positioning to the
beginning of the file; you can specify -2 to indicate positioning to the end of file.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
978 Guardian Procedure Calls (P)