TACL Reference Manual

UTILS:TACL Commands and Functions

HP NonStop TACL Reference Manual—429513-018

8-153

RENAME Command

Use the RENAME command to change the name of an existing disk file.

old-file-name

is the name of the disk file to be renamed.

new-file-name

is the new name for the file.

Considerations

•

You can rename a file only if it is not open with exclusive access, and you either

have purge access to the file or are logged on as a super-group user.

•

You can use the RENAME command to change the subvolume name of a file, but

not its volume name. Disk files that are renamed stay on the same disk volume.To

change the volume where a file resides, copy the file to a new volume with the

FUP DUP command, then delete the original file. For details, see the File Utility

Program (FUP) Reference Manual.

•

If you try to rename a file being audited by TMF, the attempt fails and file-system

error 80 (operation invalid) is returned.For information about TMF and the AUDIT

option, see the TMF Reference Manual.

•

Format 1 files, Format 2 files, and files opened with READ ONLY ACCESS can be

renamed.

Examples

1. To rename the file RECORDS.DATA to STORAGE.OLDDATA, enter:

14> RENAME RECORDS.DATA, STORAGE.OLDDAT

15>

2. To rename the file MYSTUFF in the current default subvolume to be TRASH in the

subvolume EXTRA, enter:

15> RENAME MYSTUFF, EXTRA.TRASH

16>

RENAME old-file-name [,] new-file-name