Guardian Procedure Calls Reference Manual

RENAME Procedure (Superseded by FILE_RENAME_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Safeguard Considerations
OSS Considerations
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The RENAME procedure is used to change the name of a disk file that is open. If the file is
temporary, assigning a name causes the file to be made permanent.
A call to the RENAME procedure is rejected with an error indication if there are incomplete nowait
operations pending on the specified file.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
CALL RENAME ( filenum ! i
,new-name ); ! i
Parameters
filenum
input
INT:value
is the number of an open file that identifies the file to be renamed.
new-name
input
INT:ref:12
is an array containing the internal-format file name to be assigned to the disk file, as follows:
$volname (blank-fill) or \sysnum volname (blank-fill)[0:3]
subvolname (blank-fill)[4:7]
file-id (blank-fill)[8:11]
Condition Code Settings
indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).< (CCL)
indicates that the rename operation is successful.= (CCE)
indicates that the file is not a disk file> (CCG)
1240 Guardian Procedure Calls (R)