Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-107
EXTENDEDIT Procedure
EXTENDEDIT Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
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
•
CEXTDECS (via 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
Parameters
error returned value
INT
returns a file-system error number indicating the outcome of the operation. The
most common cause of failure is error 48 (security violation), which occurs when
the caller is not authorized to rename or purge the existing file.
#include <cextdecs(EXTENDEDIT)>
__int32_t EXTENDEDIT ( short *filenum
,[ __int32_t start ]
,[ __int32_t increment ] );
error := EXTENDEDIT ( filenum ! i,o
,[ start ] ! i
,[ increment ] ); ! i