Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-56
RENAME Procedure
(Superseded by FILE_RENAME_ Procedure )
new-name input
INT:ref:12
is an array containing the internal-format file name to be assigned to the disk file,
as follows:
[0:3] $volname (blank-fill)
or
\sysnum volname (blank-fill)
[4:7] subvolname (blank-fill)
[8:11] file-id (blank-fill)
Condition Code Settings
< (CCL) indicates that an error occurred (call FILEINFO or FILE_GETINFO_).
= (CCE) indicates that the rename operation is successful.
> (CCG) indicates that the file is not a disk file.
Considerations
•
Purge access for RENAME
The caller must have purge access to the file for the RENAME to be successful.
Otherwise, the RENAME is rejected with file-system error 48, “security violation.”
•
Volume specification for new-name
The volume specified in
new-name must be the same as the volume specified
when opening the file. Neither the volume name nor the system name can be
changed by RENAME.
•
sysnum specification for new-name
If
sysnum is specified as part of new-name, it must be the same as the system
number used when the file was initially opened.
•
Partitioned files
When the primary partition of a partitioned file is renamed, the file system
automatically renames all other partitions located anywhere in the network.
•
Renaming a file audited by the Transaction Management Facility (TMF)
The file to be renamed cannot be a file audited by TMF. An attempt to rename
such a file fails with file-system error 80 (invalid operation attempted on audited file
or nonaudited disk volume).
•
Structured files with alternate keys