RENAME

RENAME

Renames a file

Language element: function

Category: general-purpose OpenVMS

OpenVMS specifics: All aspects are host-specific

Syntax
Details
See Also

Syntax

RENAME(old-name,new-name)

old-name: is the current name of the file. It can be a character variable, a character literal enclosed in double quotation marks, or another character expression.
new-name: is the new name of the file. It can be a character variable, character literal enclosed in double quotation marks, or another character expression.

Details

You must have proper access to the file. If the RENAME function executes successfully, the return value is 0. Otherwise, the return value is the OpenVMS error code that indicates why it failed.

The following are two common error codes:

98962 File not found.

98970 Insufficient privilege or file protection violation.

The text of the error codes is retrieved using the GETMSG function.

See Also

Function: GETMSG

Chapter Contents
Previous
Next
Top of Page

Language element:	function
Category:	general-purpose OpenVMS
OpenVMS specifics:	All aspects are host-specific

`98962`	File not found.
`98970`	Insufficient privilege or file protection violation.