Guardian Procedure Calls Reference Manual

EXTENDEDIT Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Example
Related Programming Manual
Summary
The EXTENDEDIT procedure copies an EDIT file to a new file that it creates and that has a larger
extent size than the original file. It purges the old file and renames the new file to have the name
of the old file. The lines in the new file are renumbered if so requested. Upon completion, the
current record number is set to -1 (beginning of file) and the file number of the new file is returned
to the caller. This procedure is intended to be used after a call to WRITEEDIT or WRITEEDITP returns
an error 45 (file full).
EXTENDEDIT is an IOEdit procedure and can only be used with files that have been opened by
OPENEDIT or OPENEDIT_. The maximum edit file size is 128 megabytes.
Syntax for C Programmers
#include <cextdecs(EXTENDEDIT)>
__int32_t EXTENDEDIT ( short *filenum
,[ __int32_t start ]
,[ __int32_t increment ] );
• 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 := EXTENDEDIT ( filenum ! i,o
,[ start ] ! i
,[ increment ] ); ! i
Parameters
filenum
input, output
INT .EXT:ref:1
specifies the file number of the open file to be copied into a new file. It returns the file number
of the new file.
start
input
INT(32):value
specifies 1000 times the line number of the first line of the new file. You supply this parameter
when you want the lines in the new file to be renumbered. If you omit start, renumbering
EXTENDEDIT Procedure 341