Guardian Procedure Calls Reference Manual

FILE_RENAME_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Safeguard Considerations
OSS Considerations
Example
Related Programming Manuals
Summary
The FILE_RENAME_ procedure changes the name of an open disk file. If the file is temporary,
assigning a name causes the file to be made permanent.
FILE_RENAME_ returns an error if there are incomplete nowait operations pending on the specified
file.
Syntax for C Programmers
#include <cextdecs(FILE_RENAME_)>
short FILE_RENAME_ ( short filenum
,const char *newname
,short length );
Syntax for TAL Programmers
error := FILE_RENAME_ ( filenum ! i
,newname:length ); ! i:i
Parameters
filenum
input
INT:value
is the number that identifies the open disk file to be renamed. The file number is obtained from
FILE_OPEN_ or OPEN when the file is opened.
newname:length
input:input
STRING .EXT:ref:*, INT:value
contains the file name to be assigned to the specified disk file. The value of newname must be
exactly length bytes long. It must be a valid disk file name or the name of a DEFINE that
designates a valid disk file name. If the file name is partially qualified, it is resolved using the
contents of the =_DEFAULTS DEFINE.
496 Guardian Procedure Calls (F)