Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)

Guardian Procedure Calls Reference Manual—522629-013

5-135

FILE_RENAME_ Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

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

Syntax for TAL Programmers

Parameters

error returned value

INT

is a file-system error number indicating the outcome of the operation.

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.

#include <cextdecs(FILE_RENAME_)>

short FILE_RENAME_ ( short filenum

,const char *newname

,short length );

error := FILE_RENAME_ ( filenum ! i

,newname:length ); ! i:i